Solana MCP Server Documentation

View source

Table of contents and navigation guide for all documentation

Table of Contents

  1. Developer Onboarding Guide - New contributors start here!
  2. Architecture Overview
  3. Deployment Guide
  4. API Reference
  5. Configuration Guide
  6. Examples and Use Cases

Quick Overview

The Solana MCP Server is a comprehensive Model Context Protocol implementation that provides seamless access to Solana blockchain data through AI assistants like Claude. It features multi-network support, extensive RPC method coverage, and flexible deployment options.

Key Features

🚀 Comprehensive RPC Coverage

  • 47 Solana RPC methods across all major categories
  • 4 network management methods for multi-SVM support
  • Real-time blockchain data with configurable commitment levels

🌐 Multi-Network Support

  • Query multiple SVM-compatible networks simultaneously
  • Dynamic network configuration and management
  • Parallel execution with result aggregation

🛠️ Flexible Deployment

  • Local development with Claude Desktop
  • HTTP endpoint deployment
  • Serverless functions (AWS Lambda, Vercel, Google Cloud)
  • Container orchestration (Docker, Kubernetes)

⚡ High Performance

  • Connection pooling and persistent RPC clients
  • Configurable caching layers
  • Parallel multi-network queries
  • Built-in rate limiting and error recovery

Architecture Overview

graph TB
    subgraph "AI Assistant"
        A[Claude Desktop] --> B[Natural Language Query]
    end
    
    subgraph "MCP Protocol Layer"
        B --> C[MCP Client]
        C --> D[JSON-RPC 2.0]
    end
    
    subgraph "Solana MCP Server"
        D --> E[Request Handler]
        E --> F[Tool Dispatcher]
        F --> G[Multi-Network Router]
        G --> H[RPC Client Pool]
    end
    
    subgraph "Configuration"
        I[config.json] --> F
        J[Environment Variables] --> F
        K[SVM Networks Registry] --> G
    end
    
    subgraph "Blockchain Networks"
        H --> L[Solana Mainnet]
        H --> M[Solana Devnet]
        H --> N[Eclipse Network]
        H --> O[Custom Networks]
    end
    
    style A fill:#e1f5fe
    style E fill:#fff3e0
    style G fill:#f3e5f5
    style L fill:#ffebee

Getting Started

1. Quick Installation

1
2
3
4
5
6
7

# Download and configure automatically
curl -s https://api.github.com/repos/opensvm/solana-mcp-server/releases/latest | \
grep browser_download_url | grep $(uname -s | tr '[:upper:]' '[:lower:]') | \
cut -d '"' -f 4 | xargs curl -L -o solana-mcp-server && \
chmod +x solana-mcp-server && \
mkdir -p ~/.config/claude && \
echo '{"mcpServers":{"solana":{"command":"'$(pwd)'/solana-mcp-server","env":{"SOLANA_RPC_URL":"https://api.mainnet-beta.solana.com"}}}}' > ~/.config/claude/config.json

2. Basic Usage

Once configured, you can interact through natural language:

  • “What’s the SOL balance of address Gh9ZwEmdLJ8DscKNTkTqPbNwLNNBjuSzaG9Vp2KGtKJr?”
  • “Show me the current slot number”
  • “Get the token supply for USDC”
  • “List all available SVM networks”

3. Multi-Network Setup

1
2
3

# Enable additional networks
"Enable Eclipse mainnet network"
"Set a custom RPC URL for development testing"

Documentation Structure

Architecture Overview

Comprehensive guide to the server’s internal architecture, components, and data flow patterns.

Topics Covered:

  • System architecture diagrams
  • Core component interactions
  • Request/response flow
  • Multi-network routing
  • Security model
  • Performance characteristics

Deployment Guide

Step-by-step instructions for deploying the server in various environments.

Deployment Options:

  • Local development setup
  • HTTP endpoint deployment
  • Serverless functions (AWS Lambda, Vercel, Google Cloud)
  • Container orchestration
  • Production configuration
  • Monitoring and observability

API Reference

Complete documentation of all available RPC methods and network management features.

Method Categories:

  • Network Management (4 methods)
  • Account Methods (6 methods)
  • Block Methods (9 methods)
  • System Methods (6 methods)
  • Epoch and Inflation Methods (5 methods)
  • Token Methods (5 methods)
  • Transaction Methods (6 methods)
  • Other Methods (6 methods)

Configuration Guide

Detailed configuration options, formats, and best practices.

Configuration Topics:

  • Configuration file formats
  • Environment variables
  • Network management
  • Security settings
  • Performance tuning
  • Development vs production configs

Examples and Use Cases

Practical examples and real-world use cases for the Solana MCP Server.

Example Categories:

  • Basic account and token operations
  • Multi-network queries and comparisons
  • DeFi portfolio analysis
  • Development workflows
  • Integration patterns
  • Error handling scenarios

Network Support

The server supports querying multiple SVM-compatible networks:

Network Status Default RPC
Solana Mainnet ✅ Supported api.mainnet-beta.solana.com
Solana Devnet ✅ Supported api.devnet.solana.com
Eclipse Mainnet ✅ Supported mainnetbeta-rpc.eclipse.xyz
Custom Networks ✅ Supported User-configurable

Request Flow

sequenceDiagram
    participant U as User
    participant C as Claude
    participant M as MCP Server
    participant S as Solana RPC
    participant E as Eclipse RPC
    
    U->>C: "Get balance on all networks"
    C->>M: tools/call: getBalance
    M->>M: Check enabled networks
    
    par Parallel Network Queries
        M->>S: getBalance RPC
        M->>E: getBalance RPC
    end
    
    S-->>M: Solana balance
    E-->>M: Eclipse balance
    M->>M: Aggregate results
    M-->>C: Multi-network response
    C-->>U: "Balance on Solana: 1.5 SOL, Eclipse: 0.8 SOL"

Performance Metrics

Metric Single Network Multi-Network
Latency 100-500ms 200-800ms
Throughput 100 req/min 50 req/min
Memory Usage ~10MB ~15MB
CPU Usage Minimal Low

Contributing

We welcome contributions! Please see our contributing guidelines for:

  • Code style and standards
  • Testing requirements
  • Documentation updates
  • Feature requests and bug reports

Support

For support and questions:

  • 📖 Documentation: This documentation set
  • 🐛 Issues: GitHub Issues
  • 💬 Discussions: GitHub Discussions
  • 📧 Contact: [Maintainer contact information]

License

This project is licensed under the MIT License. See the LICENSE file for details.