> ## Documentation Index
> Fetch the complete documentation index at: https://ti-mm-mycompc.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# 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.
The gateway publishes its capabilities at `/.well-known/mcp.json`. This file lists the server name, version, available tools, and the SSE endpoint URL.
```bash theme={null}
curl https://solana-pulse-ai-agent-gateway.ai.studio/.well-known/mcp.json
```
Response:
```json theme={null}
{
"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." }
]
}
```
Open a Server-Sent Events connection to the SSE endpoint. The gateway assigns a session ID and keeps the stream alive for tool calls.
```bash theme={null}
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.
POST JSON-RPC messages to `/mcp/messages?sessionId=YOUR_SESSION_ID`. Each message invokes one of the tools listed in the manifest.
```bash theme={null}
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.
Add the gateway to your Claude Desktop configuration file. The MCP client will handle discovery, SSE connection, and message routing automatically.
```json claude_desktop_config.json theme={null}
{
"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=`.
Cursor supports MCP servers through its settings. Add the gateway URL to your Cursor MCP configuration:
```json cursor_mcp_config.json theme={null}
{
"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.
Fetch native SOL balance for any wallet. Parameters: `wallet`, optional `network`.
List all SPL token holdings. Parameters: `wallet`, optional `network`.
Security audit a token mint. Parameters: `mint`, optional `network`.
Turn a signature into a categorized summary. Parameters: `signature`, optional `network`.
Derive the Associated Token Account for a wallet and mint. Parameters: `wallet`, `mint`, optional `network`.
Get tiered priority fee recommendations. Parameter: optional `network`.
Dry-run a base64 transaction before broadcasting. Parameters: `transaction`, optional `network`.
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](/guides/claim-api-key) to enable paid MCP tool calls
* [Decode a Transaction](/guides/decode-transaction) to learn how the `decode_tx` tool works under the hood