Skip to main content
Glama
solana-agent-mcp

solana-agent-mcp

by KorroAi

Solana Agent MCP

Your on-chain copilot. An MCP (Model Context Protocol) server that gives AI agents full read/write access to the Solana blockchain — check balances, send SOL, swap tokens via Jupiter, scan pump.fun tokens in real-time, and trade memecoins. All through natural conversation. No API keys shared with the agent.

Architecture

┌──────────────┐     MCP stdio (local)     ┌──────────────────────┐
│  AI Agent    │◄─────────────────────────►│  solana-agent-mcp    │
│  (Claude)    │   No network, no auth     │  (your machine)      │
└──────────────┘                           └────────┬─────────────┘
                                                    │
                                          Helius WS + RPC
                                          Jupiter API
                                          Pump.fun API
                                                    │
                                              ┌─────▼──────┐
                                              │  Solana    │
                                              │  Blockchain│
                                              └────────────┘

The MCP server runs as a local process. AI agents connect via stdin/stdout (standard MCP protocol). Your private key signs transactions locally — it never leaves your machine. The agent never sees your key.

Related MCP server: Pique Signal

Installation

git clone https://github.com/KorroAi/solana-agent-mcp.git
cd solana-agent-mcp
npm install
cp .env.example .env

Edit .env:

HELIUS_API_KEYS=your-key-1,your-key-2    # Free at helius.dev
PRIVATE_KEY=your-phantom-base58-key       # Optional — for live transactions
SOLANA_MCP_PORT=8791                      # Default
npm run dev

Then type /solana in Claude Code. The wizard guides you.

MCP Tools (14 total)

Read — Query blockchain state

Tool

Parameters

Returns

solana_get_balance

address

SOL balance + lamports

solana_get_token_balance

address, mint

SPL token balance

solana_get_token_info

mint

Decimals, supply, authorities

solana_get_price

—

SOL/USD price

solana_scan_tokens

—

Recent pump.fun tokens

solana_get_transaction

signature

Tx details + status

solana_get_wallet

—

Server wallet address + balance

solana_health

—

RPC status, scanner, wallet

Write — Execute transactions (requires PRIVATE_KEY)

Tool

Parameters

Returns

solana_send_sol

to, amount

Tx signature + Solscan link

solana_send_token

to, mint, amount

Tx signature + Solscan link

solana_swap

inputMint, outputMint, amount, slippageBps?

Tx signature + route

solana_buy_pump

mint, amountSOL, slippageBps?

Tx signature + pump.fun link

solana_sell_pump

mint, amountSOL?, slippageBps?

Tx signature + Solscan link

solana_request_airdrop

address, amount?

Tx signature (devnet only)

Resources

URI

Content

solana://price

Current SOL/USD price

solana://tokens/recent

Last 20 pump.fun tokens

Safety

  • Local signing: Private key never leaves your machine

  • Confirmation gate: Transactions >0.01 SOL require explicit confirmation

  • Solscan links: Every transaction returns an explorer link

  • Read-only by default: No wallet = no write access, everything still works

  • No API keys shared: The agent communicates via local stdio, not over the network

  • Balance guard: Won't trade below 0.01 SOL reserve

/solana — Slash Command

/solana
> check my balance          → "You have 0.112 SOL (~$8.90)"
> send 0.01 SOL to 7bN2...  → "Sending... confirmed! tx: 2PFCa..."
> scan pump.fun tokens      → "4 new tokens detected"
> swap 0.05 SOL to USDC     → "Best route: SOL→USDC via Jupiter"
> buy B1bN... for 0.02 SOL  → "Buy executed! pump.fun/coin/B1bN..."

License

GNU Affero General Public License v3.0 (AGPL-3.0)

This is strong copyleft. You can use, modify, and distribute this software freely. If you run a modified version as a network service, you MUST release your modifications to the community. Companies cannot take this code, improve it privately, and sell it as a proprietary service.

See LICENSE for the full text.

AGPL-3.0 — Free as in freedom. Share your improvements.


Available Tools

8 tools
solana_get_balanceC

Get SOL balance for any Solana wallet address

Inputs: no named parameters.

solana_get_priceA

Get current SOL price in USD

Inputs: no named parameters.

solana_get_token_balanceC

Get SPL token balance for a wallet address and token mint

Inputs: no named parameters.

solana_get_token_infoB

Get on-chain metadata for any SPL token: decimals, supply, authorities

Inputs: no named parameters.

solana_get_transactionC

Get transaction details by signature

Inputs: no named parameters.

solana_healthA

System health: RPC status, scanner status, SOL price

Inputs: no named parameters.

solana_request_airdropA

Request SOL airdrop on devnet (testnet only, not mainnet)

Inputs: no named parameters.

solana_scan_tokensB

Scan recent pump.fun tokens from real-time Helius WebSocket

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 8 tools

    Disambiguation5/5

    Each tool targets a distinct function: balance, price, token operations, transaction details, health check, airdrop, and token scanning. No overlap or ambiguity exists.

    Naming Consistency4/5

    All tools share the 'solana_' prefix and mostly use verb_noun pattern (get_balance, request_airdrop). The 'solana_health' tool deviates slightly by lacking a verb, but it's still clear.

    Tool Count5/5

    Eight tools is well-scoped for a Solana agent covering queries, health, and airdrop. Each tool serves a distinct purpose without being excessive or insufficient.

    Completeness3/5

    Covers common queries (balance, price, token info, transaction) and devnet airdrop, but lacks essential operations like token transfers or swaps, limiting practical use.

    Maintenance

    ActivityMaintained
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Solana on-chain intelligence API — token scans, wallet PnL, bundle detection, fresh wallets, dev profiling. MCP server for Claude, Cursor & AI agents. Live PumpFun/Raydium streams
      1
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Live scored Solana memecoin signals with safety profiles, conviction scoring, and paper trading for AI agents.
      6
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Solana memecoin rug check and token risk for trading agents in the trenches: pump.fun launches, calibrated rug probability with a published hit rate, sniper, insider and bundle detection, holder clusters, KOL trades, wallet history and a live sellability check for memecoins. Available as a remote MCP endpoint (OAuth or API key) and as an npm stdio package.
      26
      122 npm
      3
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables agents to read live pump.fun coin calls, market and study data, and paper-trade results graded by net return after costs, plus backtest and run custom entry/exit strategies against published history. It exposes these as MCP tools, prompts, and a hosted or local server with no wallet or key required.
      13
      53 npm
      8
      MIT