Use This MCP server To

Retrieve the latest Solana blockchain slot for synchronization Fetch wallet address for identity verification Check wallet balance in real time Execute SOL token transfers securely Integrate Solana blockchain data into AI workflows Enable AI agents to perform blockchain transactions Monitor wallet activity within AI copilots Automate blockchain queries in development environments

README

Solana MCP Server 🌱

smithery badge

A MCP server to interact with the Solana blockchain with your own private key.

✨ Features

Get latest slot
Get wallet address
Get wallet balance
Transfer SOL

⚙️ Setup

Installing via Smithery

To install Solana MCP for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @Grandbusta/solana-mcp --client claude

Manual Setup

Clone the repository

git clone https://github.com/Grandbusta/solana-mcp.git

Install dependencies

npm install

Build the project

npm run build

Create a keypair file Create a file named keypair.json anywhere you want and copy your private key into it. Check the example-keypair.json file for an example.

NB: RPC endpoint is set to api.devnet.solana.com by default. If you want to use a different endpoint, you can set it in the run.sh file.

Integration with Cursor

To integrate with Cursor, follow these steps:

In the Cursor settings, go to MCP
Click "Add new MCP server"
Enter the following information:
- Name: Solana MCP
- Type: command
- Command: /path/to/your/solana-mcp/run.sh /path/to/your/keypair.json

Example command: /Users/username/projects/solana-mcp/run.sh /Users/username/Documents/keypair.json

🛠️ Available Tools

1. get-latest-slot

Returns the latest slot number:

368202671

2. get-wallet-address

Returns the wallet address:

5GTuMBag1M8tfe736kcV1vcAE734Zf1SRta8pmWf82TJ

3. get-wallet-balance

Returns the wallet balance in SOL, Lamports, and USD:

{
  "lamportsBalance": "4179966000",
  "solanaBalnce": 4.179966,
  "usdBalance": "553.0513"
}

4. transfer

Transfers SOL to a recipient address:

{
  "blockTime": "1742316463",
  "meta": {
    "computeUnitsConsumed": "150",
    "err": null,
    "fee": "5000",
    "innerInstructions": [],
    "loadedAddresses": {
      "readonly": [],
      "writable": []
    },
    "logMessages": [
      "Program 11111111111111111111111111111111 invoke [1]",
      "Program 11111111111111111111111111111111 success"
    ],
    "postBalances": [
      "4179966000",
      "819999000",
      "1"
    ],
    "postTokenBalances": [],
    "preBalances": [
      "4399970000",
      "600000000",
      "1"
    ],
    "preTokenBalances": [],
    "rewards": [],
    "status": {
      "Ok": null
    }
  },
  "slot": "368211978",
  "transaction": {
    "message": {
      "accountKeys": [
        "6qhddtBoEHqTc3VM35a3rb3aLUe6vDQfmLigo2G4r5s1",
        "5GTuMBag1M8tfe736kcV1vcAE734Zf1SRta8pmWf82TJ",
        "11111111111111111111111111111111"
      ],
      "addressTableLookups": [],
      "header": {
        "numReadonlySignedAccounts": 0,
        "numReadonlyUnsignedAccounts": 1,
        "numRequiredSignatures": 1
      },
      "instructions": [
        {
          "accounts": [
            0,
            1
          ],
          "data": "3Bxs452Q9hdvHuwd",
          "programIdIndex": 2,
          "stackHeight": null
        }
      ],
      "recentBlockhash": "BLqtPS9BHPp9CRFTrVAsrxFMWC98VTUAQ3vi12bSquLo"
    },
    "signatures": [
      "3bLyqbPn26ofkaxSAVqadQnHqXu9hyoryixmKCn69nunKg2cSryDVAWnfCcYPcGtjSmXcMHfrzc3bw25zFTabXvs"
    ]
  },
  "version": "0"
}

🧑‍💻 Contributing

Contributions are welcome! Please open an issue or submit a pull request.

🔖 License

WTFPL License

solana-mcp FAQ

How do I install the Solana MCP server?

You can install it automatically via Smithery CLI or manually by cloning the GitHub repo, installing dependencies, and building the project.

How does the Solana MCP server handle private keys?

It uses your own private key stored securely in a keypair file to sign transactions and interact with the blockchain.

Can I use the Solana MCP server with different LLM providers?

Yes, it is designed to work with various LLMs like OpenAI, Claude, and Gemini through the MCP protocol.

What blockchain operations does the Solana MCP server support?

It supports fetching the latest slot, wallet address, wallet balance, and transferring SOL tokens.

Is the Solana MCP server suitable for production use?

Yes, but ensure your private keys are securely managed and the environment is properly configured.

How do I integrate the Solana MCP server with AI applications?

Use the MCP protocol to connect the server with your AI client or host, enabling real-time blockchain interactions.

What dependencies are required to run the Solana MCP server?

Node.js and npm are required to install dependencies and build the project.

Can the Solana MCP server be extended with additional blockchain features?

Yes, it is open source and can be customized to add more Solana blockchain functionalities.