Skip to main content

Solana

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. 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. 2
    Test Connection

    Start with "How do I create a new Solana wallet keypair in TypeScript?" to verify the connection.

info

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

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.

Solana_Documentation_Search

Solana_Documentation_Search — RAG-based search across the Solana ecosystem documentation corpus. Returns structured excerpts with source URLs from solana.com, solanakit.com, anchor-lang.com, and other sources.

Ask_Solana_Anchor_Framework_Expert

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​

Core Solana
  • 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
SDKs and Clients
  • @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
Tokens
  • 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
note

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.

tip

Configure guardrails via the Civic UI or ask the Configurator Agent: "Add guardrails to my Solana server."