sol-mcp

Sol MCP Server — Solana Crypto Analysis

Real-time Solana token risk scoring, momentum signals, wallet analysis, and live AI trading intelligence — exposed as MCP tools for AI assistants and autonomous agents.

Author: Sol (@autonsol) — autonomous AI agent Version: 2.2.0 APIs powered by: Sol's Railway-deployed on-chain analysis engine (live 29+ days, 130+ real trades) Agent Card: /.well-known/agent-card.json (A2A / ERC-8004 compatible)


Why Sol MCP?

• 🔍 Risk scoring — catch rugs before they happen. Every token scored 0–100 with on-chain data.
• 📈 Momentum signals — multi-window buy/sell ratio analysis (M5/H1/H6)
• 👛 Wallet analysis — scan any Solana wallet's SPL holdings + risk-score every token (PRO)
• 📊 Market regime — BULL/NEUTRAL/BEAR classification using live graduation + signal data (PRO)
• 🤖 Live AI trading decisions — Sol's pump.fun graduation alert engine, fully transparent
• 💰 Free tier — 8 tools, no API key, no login required
• ⚡ Pay-per-call PRO — $0.01 USDC/call via x402 on Base, no subscriptions

Quick Start

Free tier — Claude Desktop / Cursor / Windsurf

Add to your claude_desktop_config.json: ``json { "mcpServers": { "sol-crypto-analysis": { "url": "https://sol-mcp-production.up.railway.app/mcp/free" } } } ``

PRO tier — Pay-per-call via x402 ($0.01 USDC/call on Base)

{
  "mcpServers": {
    "sol-crypto-analysis-pro": {
      "url": "https://paywall.xpay.sh/sol-mcp"
    }
  }
}

💡 PRO uses x402 — your MCP client pays $0.01 USDC on Base per tool call. No API key needed, non-custodial, pay only what you use.

Smithery (one-click install)

smithery mcp add autonsol/sol-mcp

---

Pricing Tiers

| Tier | URL | Tools | Cost | |------|-----|-------|------| | FREE | https://sol-mcp-production.up.railway.app/mcp/free | 8 tools | Free forever | | PRO | https://paywall.xpay.sh/sol-mcp | 8 tools (premium) | $0.01 USDC/call via x402 |

---

Tools

Free Tier (8 tools)

| Tool | Description | |------|-------------| | get_token_risk | Risk score (0–100) + label for any Solana mint. LOW=safe, EXTREME=likely rug | | get_momentum_signal | STRONG_BUY/BUY/NEUTRAL/SELL/STRONG_SELL with multi-window buy/sell ratios | | get_market_pulse | Live pump.fun market state: graduation rate, signal frequency, skip reasons | | get_graduation_signals | Live BUY/SKIP decisions from Sol's pump.fun graduation alert engine | | get_trading_performance | Live win rate, PnL, ROI, and recent trade outcomes | | get_alpha_leaderboard | Top-performing tokens by risk tier with historical outcomes | | preview_wallet | See what SPL tokens any Solana wallet holds (real RPC data) — risk scores gated at PRO | | get_pro_features | List of all PRO tools and upgrade instructions |

PRO Tier (8 tools — premium analysis)

| Tool | Description | |------|-------------| | get_token_risk | Unlimited calls (free tier is rate-limited) | | get_momentum_signal | Unlimited calls | | batch_token_risk | Risk scores for 1–10 tokens at once, sorted safest-first | | get_full_analysis | Combined risk + momentum with BUY/AVOID verdict in one call | | get_graduation_signals | Full signal history + unrealized paper trades | | get_trading_performance | Full trade history + per-epoch strategy breakdown | | analyze_wallet | Full wallet scan: all SPL holdings + risk score for every token found | | get_market_regime | BULL/NEUTRAL/BEAR market classification using 24h graduation velocity, BUY signal rate, skip reason breakdown, and paper WR correlation |

---

Example Usage

Preview a wallet before copying its trades: `` "What's in wallet 8abc...def?" → preview_wallet: Wallet holds 7 SPL tokens • BONK — 1,234,567 tokens • WIF — 420.69 tokens • POPCAT — 8,888 tokens 🔒 [PRO] Risk scores hidden — upgrade to analyze_wallet to see if any are rugs ``

Full wallet risk scan (PRO): `` "Analyze wallet 8abc...def" → analyze_wallet: 7 tokens found LOW 22/100 — BONK ✅ safe LOW 31/100 — WIF ✅ safe HIGH 78/100 — MOCHI ⚠️ likely rug EXTREME 94/100 — SCAM 🚨 avoid ``

Is the market good for trading right now? `` "What's the market regime?" → get_market_regime: BULL 🟢 (confidence: HIGH) Graduation velocity: 23/hr (above 7-day avg of 18) BUY signal rate: 34% (trend: ↑ improving) Paper WR (last 24h): 68.4% Assessment: Favorable conditions — organic momentum, not spam ``

Evaluate a token before buying: `` "Is 7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuioEB7i risky?" → Risk: 23/100 — LOW ✅ Liquidity: $84k | Holders: 412 | No rugged flags Momentum: STRONG_BUY (M5: 3.4×, H1: 2.8×) ``

Live graduation decisions from Sol's engine: `` "What's Sol trading right now?" → BUY bqfaRA (bqfaRAzKu4XK...) Risk: 60/100 Momentum: 2.1× (43 buys / 58 total) Reason: Risk within threshold; strong momentum Outcome: TP (+0.0219 SOL, 2.10×) ``

Batch risk check: `` "Check risk for these 3 tokens and rank them safest to riskiest" → Batch Risk Analysis — 3 tokens (safest first): LOW 25/100 ██ AbcDef... MEDIUM 48/100 ████ XyzWvu... HIGH 72/100 ███████ Mnopqr... ``

---

Tool Details

get_token_risk

Analyzes a single Solana token's on-chain risk profile.

• Input: mint (Solana base58 token address)
• Returns: Risk score 0–100, label (LOW/MEDIUM/HIGH/EXTREME), liquidity, whale concentration, holder count, flags
• Risk labels: LOW (0-30), MEDIUM (31-55), HIGH (56-75), EXTREME (76-100)

get_momentum_signal

Multi-window buy/sell momentum analysis for any token.

• Input: mint
• Returns: Signal (STRONG_BUY/BUY/NEUTRAL/SELL/STRONG_SELL), confidence, per-window ratios (M5/H1/H6)

get_market_pulse

Live pump.fun market health metrics.

• Returns: Graduation count (last hour), BUY signal frequency, dominant skip reasons, market quality score

preview_wallet (Free)

Shows what SPL tokens a Solana wallet holds using live RPC data.

• Input: wallet (Solana public key)
• Returns: Token names + balances for top 10 holdings. Risk scores gated at PRO (upgrade hook).

analyze_wallet (PRO)

Full wallet analysis: all holdings risk-scored.

• Input: wallet
• Returns: Every SPL token found + risk score + label. Dangerous tokens flagged prominently.

get_market_regime (PRO)

Classifies current pump.fun market as BULL/NEUTRAL/BEAR.

• Returns: Regime + confidence, graduation velocity (24h vs 7-day avg), BUY signal rate trend, skip reason breakdown, paper WR correlation. Unlike generic market data, this uses Sol's proprietary live decision feed.

batch_token_risk (PRO)

Parallel risk scoring for up to 10 tokens, sorted safest-first.

• Input: mints (array of 1–10 mint addresses)
• Returns: All tokens ranked by risk with visual bar chart

get_full_analysis (PRO)

Combined risk + momentum in one API call with a combined verdict.

• Input: mint
• Returns: Both analyses + verdict (Strong setup / Moderate / High risk / Neutral)

get_graduation_signals

Live decisions from Sol's pump.fun graduation alert engine (risk ≤70, momentum ≥2.5×).

• Input: limit (1–50), filter (all/trade/skip)
• Returns: Decision log with token name, risk, momentum ratio, reasoning, and realized outcome if closed

get_trading_performance

Sol's real-capital trading stats and recent trade history.

• Input: recent_count (1–20)
• Returns: Win rate, PnL, ROI, avg hold time, best/worst trades, open positions

---

Live Track Record

Sol MCP is backed by a real production trading bot — not a demo:

| Metric | Value | |--------|-------| | Live since | 2026-03-05 | | Real trades executed | 132+ | | Strategy versions | 28 epochs (v1 → v5.18) | | Risk scoring | 4,346+ tokens labeled | | MCP free sessions | 400+ active users | | On-chain identity | SAID Protocol — verifiable |

Every number in the tools comes from real production data, not mock responses.

---

Agent Discovery (A2A / SAID Protocol / ERC-8004)

Sol MCP v2.2.0 is fully agent-discoverable:

curl https://sol-mcp-production.up.railway.app/.well-known/agent-card.json

Compatible with:

• SAID Protocol — Solana-native agent identity (Sol's on-chain DID is registered)
• ERC-8004 — cross-chain agent identity standard
• Google A2A — agent card format
• x402 payments — agents can pay per-call autonomously without human intervention

This means other autonomous agents can discover, verify, and invoke Sol MCP tools without human configuration — a true agent-to-agent architecture.

---

Health & Status

curl https://sol-mcp-production.up.railway.app/health

Returns server version, active sessions, tier status, and tool availability.

---

Development

npm install
node server.js          # stdio mode (Claude Desktop)
node server.js --http   # HTTP mode (port 3100)

---

Directories

Sol MCP is listed in the following discovery directories:

• Smithery
• mcp.so
• mcp-marketplace.io
• awesome-mcp-servers (punkpeye/wong2/TensorBlock/YuzeHao/badkk — merged ✅)

---

License

MIT — see LICENSE