Connect Claude Desktop and Cursor via MCP to Solana Gateway

Integrate the Solana Pulse AI Agent Gateway with Claude Desktop or Cursor using the Model Context Protocol. Fetch the manifest, connect via SSE, and send tool calls.

Solana Pulse AI Agent Gateway exposes its intelligence endpoints through the Model Context Protocol (MCP). You can connect Claude Desktop, Cursor, or any MCP-compatible client to query balances, decode transactions, check token security, and simulate trades without writing custom RPC code.

1. Fetch the MCP manifest

   The gateway publishes its capabilities at /.well-known/mcp.json. This file lists the server name, version, available tools, and the SSE endpoint URL.

   curl https://solana-pulse-ai-agent-gateway.ai.studio/.well-known/mcp.json
   

   Response:

   {
     "name": "Solana Pulse AI Agent Gateway",
     "version": "1.0.0",
     "description": "The definitive MCP server for Solana AI Agents. Abstracts raw RPC plumbing into high-level intelligence endpoints for asset resolution, security auditing, and transaction interpretation.",
     "capabilities": {
       "tools": {
         "description": "Provides a suite of tools for balance checks, token profile security audits, ATA derivation, and transaction decoding."
       }
     },
     "mcp_sse_endpoint": "/mcp/sse",
     "tools": [
       { "name": "get_solana_balance", "description": "Fetch native SOL balance with network selection." },
       { "name": "get_solana_blockhash", "description": "Get the latest finalized blockhash for transaction construction." },
       { "name": "get_token_accounts", "description": "Scan all SPL token holdings for a wallet." },
       { "name": "get_recent_transactions", "description": "Retrieve recent transaction signatures." },
       { "name": "simulate_solana_transaction", "description": "Simulate a base64 transaction to check for failure before broadcasting." },
       { "name": "find_ata", "description": "Derive the Associated Token Account address for a wallet and mint." },
       { "name": "token_profile", "description": "Get token metadata, decimals, and security/honeypot flags." },
       { "name": "optimal_fee", "description": "Get tiered priority fee recommendations based on network congestion." },
       { "name": "decode_tx", "description": "Translate raw transaction logs into human-readable summaries." }
     ]
   }
   
2. Connect via SSE

   Open a Server-Sent Events connection to the SSE endpoint. The gateway assigns a session ID and keeps the stream alive for tool calls.

   curl -N https://solana-pulse-ai-agent-gateway.ai.studio/mcp/sse
   

   The SSE stream emits events with a sessionId. You use this ID to send messages back to the gateway.

3. Send tool calls

   POST JSON-RPC messages to /mcp/messages?sessionId=YOUR_SESSION_ID. Each message invokes one of the tools listed in the manifest.

   curl -X POST \
     "https://solana-pulse-ai-agent-gateway.ai.studio/mcp/messages?sessionId=abc-123" \
     -H "Content-Type: application/json" \
     -d '{
       "jsonrpc": "2.0",
       "id": 1,
       "method": "tools/call",
       "params": {
         "name": "decode_tx",
         "arguments": {
           "signature": "5v1ZQZ9QpZ7XyZ...",
           "network": "mainnet-beta"
         }
       }
     }'
   

   The gateway processes the request and streams the response back over the same SSE connection.

4. Configure Claude Desktop

   Add the gateway to your Claude Desktop configuration file. The MCP client will handle discovery, SSE connection, and message routing automatically.

   claude_desktop_config.json

   {
     "mcpServers": {
       "solana-pulse-gateway": {
         "url": "https://solana-pulse-ai-agent-gateway.ai.studio/mcp/sse",
         "name": "Solana Pulse AI Agent Gateway"
       }
     }
   }
   

   On macOS, place this in ~/Library/Application Support/Claude/claude_desktop_config.json. Restart Claude Desktop to load the server.

   If your client requires an HTTP-to-SSE adapter, use the same URL in an MCP bridge or proxy that forwards POSTs to /mcp/messages?sessionId=.

5. Configure Cursor

   Cursor supports MCP servers through its settings. Add the gateway URL to your Cursor MCP configuration:

   cursor_mcp_config.json

   {
     "mcpServers": {
       "solana-pulse-gateway": {
         "url": "https://solana-pulse-ai-agent-gateway.ai.studio/mcp/sse",
         "name": "Solana Pulse AI Agent Gateway"
       }
     }
   }
   

   In Cursor, open Settings, navigate to the MCP section, and add a new server pointing to the SSE endpoint above.

Available MCP tools

The MCP tools mirror the paid REST endpoints. Each tool accepts the same parameters and returns structured JSON.

get_solana_balance

Fetch native SOL balance for any wallet. Parameters: wallet, optional network.

get_token_accounts

List all SPL token holdings. Parameters: wallet, optional network.

token_profile

Security audit a token mint. Parameters: mint, optional network.

decode_tx

Turn a signature into a categorized summary. Parameters: signature, optional network.

find_ata

Derive the Associated Token Account for a wallet and mint. Parameters: wallet, mint, optional network.

optimal_fee

Get tiered priority fee recommendations. Parameter: optional network.

simulate_solana_transaction

Dry-run a base64 transaction before broadcasting. Parameters: transaction, optional network.

get_recent_transactions

Retrieve recent signatures for a wallet. Parameters: wallet, optional limit, optional network.

Error handling

Status	Meaning	What to do
400	Missing sessionId	Include ?sessionId= in the POST URL
404	Session not found	Reconnect to /mcp/sse to get a new session ID

Result

Your Claude Desktop or Cursor instance now has direct access to Solana intelligence. You can ask natural-language questions like “What tokens does this wallet hold?” or “Is this mint a honeypot risk?” and the MCP server will return structured data from the gateway.

Next steps

• Claim an API Key to enable paid MCP tool calls
• Decode a Transaction to learn how the decode_tx tool works under the hood