Solana MCP server for Cursor: setup

Cursor's agent can call MCP tools while it writes code. With a Solana MCP server it can check a mint's decimals, read an account's owner or look at a failed transaction instead of guessing. This is the setup for a read-only server that cannot sign anything.

1. Pick the config file

FileApplies to
~/.cursor/mcp.jsonevery project on this machine
.cursor/mcp.json in the project rootthat project only (can be committed for the team)

On Windows ~ is %USERPROFILE%, so the global file is C:\Users\<you>\.cursor\mcp.json.

2. Add the server

{
  "mcpServers": {
    "solana": {
      "command": "npx",
      "args": [
        "-y",
        "github:blixvip/solana-readonly-mcp"
      ],
      "env": {
        "SOLANA_RPC_URL": "https://api.mainnet-beta.solana.com"
      }
    }
  }
}

If the file already has an mcpServers object, add the solana entry next to the others. Node.js 20 or newer must be on your PATH. The first start downloads the package from GitHub, which takes a few seconds.

Windows

If Cursor shows the server as failed with an ENOENT error, start npx through cmd:

{
  "mcpServers": {
    "solana": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "github:blixvip/solana-readonly-mcp"
      ],
      "env": {
        "SOLANA_RPC_URL": "https://api.mainnet-beta.solana.com"
      }
    }
  }
}

3. Check that it loaded

Open Cursor Settings and find the MCP section. The solana server should be enabled and list nine tools: get_balance, get_token_accounts, get_account_info, get_transaction, get_signatures, get_token_supply_and_authorities, get_largest_token_holders, get_priority_fees and get_slot_and_health. If it shows an error, run the server by hand in a terminal to see the message:

npx -y github:blixvip/solana-readonly-mcp --help

4. Use your own RPC key (and keep it out of git)

The public endpoint is rate limited and refuses getTokenLargestAccounts. Put a provider URL with a key in SOLANA_RPC_URL, but only in the global ~/.cursor/mcp.json, never in a project file you commit:

{
  "mcpServers": {
    "solana": {
      "command": "npx",
      "args": [
        "-y",
        "github:blixvip/solana-readonly-mcp"
      ],
      "env": {
        "SOLANA_RPC_URL": "https://mainnet.helius-rpc.com/?api-key=YOUR_KEY"
      }
    }
  }
}

Two more settings exist: SOLANA_MCP_TIMEOUT_MS (default 15000) and SOLANA_MCP_RPS, the most requests per second the server sends (default 8). Lower SOLANA_MCP_RPS if you keep hitting 429s on a free plan.

Prompts that work well in Cursor

Safety

The server has no key setting and refuses every RPC method that is not a read, so an agent running in auto mode cannot send a transaction through it. It can read anything public on chain, which is the point. The RPC URL is never printed, so a key in it does not end up in the chat or in logs.

Troubleshooting

Want it done for you?

This is the small, open version. Blix is the AI-powered Solana memecoin terminal it comes from: every pump.fun launch live, AI coin ratings, narratives, wallet and X tracking, and one-click trading with 0% fees. There is a public API and an MCP server too.

Start trading at blixvip.comJoin the Discord

Help build it

solana-readonly-mcp is open source and takes pull requests. There are good first issues with step-by-step instructions, and setup is git clone and npm test. If it helped, a star on GitHub helps other developers find it.

More guides

How to give Claude access to Solana data with MCPsolana-readonly-mcpSolana MCP server in VS Code and Windsurf: config files that worksolana-readonly-mcpWhat is a good Solana priority fee right now (and how to measure it)solana-priority-feeHow to calculate a Solana token's top 10 holders percentagesol-holdersHow to stop Solana RPC 429 errors (Too Many Requests)solana-rpc-pool