Skip to main content
Back to Sample Apps

Solana MCP Server

A basic Solana MCP server that gives tools like Claude Desktop (or Cursor) the ability to query the Solana blockchain directly. This integration will enables you to perform tasks like checking wallet balances, viewing token accounts, retrieving transaction details, and analyzing account information—all from the power of your LLM client.

Github Icon
View Repo
Frontend Framework/Library:
Solana Kit
Language:
TypeScript
Build Tool/Development Server:
Model Context Protocol
Sample app preview

Overview

The Model Context Protocol (MCP) allows you to extend AI assistants like Claude with custom tools that interact with external data sources and services. In this guide, you'll build a Solana MCP server that gives tools like Claude Desktop (or Cursor) the ability to query the Solana blockchain directly. This integration will enable Claude to perform tasks like checking wallet balances, viewing token accounts, retrieving transaction details, and analyzing account information—all while you maintain control over these interactions.

The demo uses:

Supporting resources:

Getting Started​

Install Dependencies​

Open the project directory:

cd AI/solana-mcp

Then, install the dependencies:

npm install
# or
yarn
# or
pnpm install
# or
bun install

Build the Server:​

Then, build the server:

npm run build
# or
yarn build
# or
pnpm build
# or
bun build

Setup Claude Desktop​

Update your claude_desktop_config.json file with the content from example Claude desktop config. You can find instructions here.

Make sure to update SOLANA_RPC_ENDPOINT with your QuickNode RPC endpoint. You can get one free here.

Make sure your args pass in the absolute path to the built server (for us it is /YOUR_PATH/build/index.js).

Relaunch Claude Desktop after setting up your config file.

Now you can prompt Claude with commands like:

  • What is the Wallet balance of <wallet_address>?
  • What is the token balance of <wallet_address>?
  • What's the status of the Solana network?
Contributions & Feedback
We'd love to hear your feedback and welcome any contributions to this sample app!
To report issues or share feedback, open a GitHub issue in the qn-guide-examples repository.
To contribute, follow these steps:
  1. Fork the repository
  2. Create a feature branch:
    git checkout -b feature/amazing-feature
  3. Commit your changes:
    git commit -m "Add amazing feature"
  4. Push your branch:
    git push origin feature/amazing-feature
  5. Open a Pull Request.
Explore More Sample Apps
Solana Wallet Explorer
This application leverages a QuickNode Solana Endpoint to retrieve token balances, transaction history, and NFTs for a specified wallet on the Solana blockchain.
Solana Wallet Explorer
Solana Action Blinker
This application allows you to create and interact with Solana Actions by parsing Solana Action URLs into their corresponding actions. Enter a valid Action URL to view its details, connect your wallet to execute actions, or create new ones using the provided structure.
Solana Action Blinker
Solana Token Minter
This application allows you to create fungible tokens on the Solana blockchain with built-in support for IPFS image uploads using QuickNode's IPFS API.
Solana Token Minter