Skip to content

autonsol/sol-mcp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

26 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

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)

smithery badge

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:

{
  "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:


License

MIT β€” see LICENSE

About

MCP server for Solana token risk scoring and momentum signals

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors