SVM

This MCP server connects Claude AI with the SOON ecosystem to query wallet balances on testnet and mainnet, fetch recent transactions, and list token holdings. It enables you to perform these checks programmatically through an MCP client, making it easier to build dialogue flows that reference live on-chain data.

How to use

You interact with the server through an MCP client to access three core capabilities: check balances on SOON testnet or mainnet, retrieve the most recent transaction for an address, and list token accounts owned by an address. Use these as building blocks in conversations with Claude to provide users with up-to-date blockchain data. You will typically call the corresponding tool by name and supply the target address.

How to install

Prerequisites you need before you start are Node.js version 16 or newer, and either NPM or Bun as a package manager. You will also want Claude Desktop for local testing.

# Step 1: Clone the MCP server repository
git clone https://github.com/rkmonarch/svm-mcp
cd svm-mcp

# Step 2: Install dependencies
npm install
# or
bun install

# Step 3: Build the project
npm run build
# or
bun run build

# Step 4: Start the MCP server (example using stdio transport)
npx bun build/index.js

Configuration and usage notes

Two types of connection methods are shown for this MCP server. First, the server can connect to SOON RPC endpoints to read on-chain data. Second, the server can be run locally via a stdio transport, which lets Claude send commands to the server process.

The following configuration demonstrates both HTTP endpoints (for accessing SOON RPCs) and a local stdio run command to start the MCP server.

{
  "mcpServers": {
    "svm_testnet_http": {
      "type": "http",
      "name": "soo_testnet_http",
      "url": "https://rpc.testnet.soo.network/rpc",
      "args": []
    },
    "svm_mainnet_http": {
      "type": "http",
      "name": "soo_mainnet_http",
      "url": "https://rpc.mainnet.soo.network/rpc",
      "args": []
    },
    "svm_mcp": {
      "type": "stdio",
      "name": "svm_mcp",
      "command": "bun",
      "args": ["/path/to/svm-mcp/build/index.js"]
    }
  },
  "envVars": []
}

Security and maintenance tips

Keep your private keys and access controls out of the MCP server configuration. When running with stdio transport, ensure the host environment enforces least-privilege execution and monitors for unexpected process activity. Regularly update Node.js and dependencies to benefit from security and performance improvements.

Troubleshooting

If the server cannot start, verify that the build output exists at the expected path and that the Bun command can execute the built index. Check environment compatibility with your node/bun versions and ensure the RPC endpoints are reachable from the host machine.

Examples of usage with Claude

Once the MCP server is running, you can ask Claude to fetch data for addresses on SOON. For example, request a balance on testnet, retrieve the latest transaction for an address, or list the token holdings on mainnet. Use these exact tool names when forming your queries to Claude.

Project details and dependencies

The server is written in TypeScript and uses the Model Context Protocol SDK. It connects to SOON RPC endpoints to read balances, recent transactions, and token accounts. For local testing, Claude Desktop is recommended.

Available tools

get-soon-testnet-balance

Fetch the native balance for a given address on SOON testnet.

get-soon-testnet-last-transaction

Retrieve the most recent transaction for an address on SOON testnet.

get-soon-testnet-account-tokens

List all token accounts owned by an address on SOON testnet.

get-soon-mainnet-balance

Fetch the native balance for a given address on SOON mainnet.

get-soon-mainnet-last-transaction

Retrieve the most recent transaction for an address on SOON mainnet.

get-soon-mainnet-account-tokens

List all token accounts owned by an address on SOON mainnet.