Skip to main content

Overview

The Solana MCP server at mcp.solana.com provides three AI-powered knowledge tools for Solana developers. All tools use RAG-based similarity search against a curated corpus of Solana documentation. These are knowledge and documentation tools only β€” they do not interact with any live Solana cluster.

How to Add Solana

1

Add to Civic

Add the Solana server to your Civic environment through the server directory. No API keys or authentication required β€” this is a public documentation server.
2

Test Connection

Start with "How do I create a new Solana wallet keypair in TypeScript?" to verify the connection.
No authentication required β€” The Solana MCP server is a public knowledge service. It provides documentation search and developer Q&A only β€” it does not interact with any live Solana cluster or wallet.Transport configuration β€” The server uses HTTP streaming at https://mcp.solana.com/mcp. Set transport type to http, not sse, to avoid 405 errors.

What You Can Do

Solana Expert Q&A

Ask about concepts, APIs, SDKs, errors, and best practices across the Solana ecosystem

Documentation Search

RAG-based search across solana.com, solanakit.com, anchor-lang.com, and more

Anchor Framework Expert

Specialized Q&A for Anchor macros, account constraints, IDL, CPIs, and testing

SDK Guidance

Help with @solana/kit, @solana/rpc, Token-2022, confidential transfers, and more

Use Cases

General Solana Development

  • Getting Started: "How do I create a new Solana wallet keypair in TypeScript?"
  • Concepts: "What is the difference between a program account and a data account on Solana?"
  • Transactions: "How do I send SOL from one wallet to another using @solana/kit?"
  • Clusters: "What is the difference between mainnet-beta, devnet, and testnet?"
  • Debugging: "What does 'insufficient funds for rent' mean and how do I fix it?"
  • Best Practices: "What are best practices for writing a Solana program in Rust?"
  • API Reference: "Search for documentation on createSolanaRpc"
  • Token Extensions: "Find docs on Token-2022 transfer_checked instruction"
  • Account Model: "Search for Solana account model documentation"
  • RPC Methods: "Find documentation on getLatestBlockhash RPC method"

Anchor Framework

  • Account Validation: "How do I define account validation in an Anchor program?"
  • Constraints: "What is the difference between init and init_if_needed account constraints?"
  • CPIs: "How do I call a CPI to the System Program in Anchor?"
  • IDL: "What is the IDL in Anchor and how do I use it on the client side?"
  • Testing: "How do I write Anchor tests using Mocha?"
  • Events: "How do I emit events in Anchor?"
  • Composability: "How do I use the declare_program! macro for composability?"

Available Tools (3)

Solana_Expert__Ask_For_Help β€” General Solana development Q&A. Best for how-to questions, conceptual explanations, SDK usage, and debugging help. For Anchor-specific questions, use the Anchor expert tool instead.
Ask_Solana_Anchor_Framework_Expert β€” Anchor Framework-specific Q&A covering macros, account constraints, IDL, CPIs, error handling, testing, and client generation. For native Rust programs (no Anchor), use the general Solana expert instead.

Key Topics Covered

  • Account model: owner, data, lamports, executable flag
  • Transactions and instructions; parallel execution via account lists
  • Programs: stateless, BPF Upgradeable Loader, CPIs
  • Clusters: localnet, devnet, testnet, mainnet-beta
  • Rent exemption β€” all accounts must be rent-exempt from creation
  • @solana/kit (formerly web3.js v2): RPC clients, signers, codecs, transactions
  • @solana/rpc and @solana/rpc-subscriptions packages
  • Helpers: fetchEncodedAccount, assertAccountExists, fetchMint, decodeMint
  • RPC WebSocket subscriptions
  • SPL Token Program and Token-2022 (Token Extensions)
  • Extensions: confidential transfers, transfer fees, metadata pointer, group pointer
  • Confidential balances: ElGamal encryption, zero-knowledge proofs
  • Token-2022 on-chain migration guide

Not a live RPC node β€” Cannot query on-chain state, check balances, submit transactions, or interact with any cluster.No code execution β€” Does not compile, deploy, or simulate Solana programs.Specify the SDK version β€” @solana/web3.js v1 vs @solana/kit v2 have very different APIs. Always mention which version you are using.Combine tools for best results β€” Run Solana_Documentation_Search first to surface relevant docs, then follow up with Solana_Expert__Ask_For_Help with a more targeted question.Provide context for errors β€” Include the full error message, relevant code snippet, and what you have already tried. Richer context returns better-matched results.

Guardrails

This server is covered by the 14 universal guardrails. Server-specific guardrails are coming soon.
Configure guardrails via the Civic UI or ask the Configurator Agent: β€œAdd guardrails to my Solana server.”