English Français العربية

io.github.thomenz/soldefi-mcp

السجل الرسمي المالية والمدفوعات

Solana DeFi risk intel over x402: rug/honeypot scans, pool analysis, wash-filtered pools.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package soldefi-mcp
Claude Code 
claude mcp add soldefi-mcp -e 'SOLANA_PRIVATE_KEY=<your solana_private_key>' -e 'EVM_PRIVATE_KEY=<your evm_private_key>' -e 'SOLANA_RPC_URL=<SOLANA_RPC_URL>' -e 'SOLDEFI_BASE_URL=<SOLDEFI_BASE_URL>' -e 'X402_NETWORK=<X402_NETWORK>' -- npx -y soldefi-mcp@0.5.2
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "soldefi-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "soldefi-mcp@0.5.2"
            ],
            "env": {
                "SOLANA_PRIVATE_KEY": "<your solana_private_key>",
                "EVM_PRIVATE_KEY": "<your evm_private_key>",
                "SOLANA_RPC_URL": "<SOLANA_RPC_URL>",
                "SOLDEFI_BASE_URL": "<SOLDEFI_BASE_URL>",
                "X402_NETWORK": "<X402_NETWORK>"
            }
        }
    }
}

متغيرات البيئة

  • SOLANA_PRIVATE_KEY سري base58 or JSON-array secret key of a DEDICATED Solana wallet holding USDC (pays per call). Configure this and/or EVM_PRIVATE_KEY; the x402 layer settles on whichever rail the 402 advertises. Paid tools return 402 without one; the free validate_mint tool still works.
  • EVM_PRIVATE_KEY سري 0x private key of a DEDICATED wallet holding USDC on Base (pays per call). Configure this and/or SOLANA_PRIVATE_KEY; the x402 layer settles on whichever rail the 402 advertises. Paid tools return 402 without one; the free validate_mint tool still works.
  • SOLANA_RPC_URL Optional Solana RPC override used to build the payment (e.g. a Helius URL). Only read when SOLANA_PRIVATE_KEY is set.
  • SOLDEFI_BASE_URL Base URL of a soldefi Worker. Defaults to the hosted production API (https://soldefi.thomenz.me).
  • X402_NETWORK Set to 'base-sepolia' to pay on testnet, which switches BOTH rails (Solana devnet + Base Sepolia). Any other value, including unset, pays on mainnet.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. soldefi-mcp
  2. Tools
  3. Install & configure
  4. The wallet needs
  5. Develop
  6. License

soldefi-mcp

An MCP (Model Context Protocol) server that gives AI agents paid access to Solana DeFi risk intelligence — rug/honeypot scans, deep liquidity-pool analysis, and a wash-trade-filtered "real best pools" ranking. Each paid call settles an x402 micropayment in USDC (on Solana or Base) automatically, using a wallet you configure. A call is charged only on success — malformed input is rejected for free.

It talks to the hosted Solana DeFi Intelligence API (https://soldefi.thomenz.me by default). This package is a thin payment-client bridge; the intelligence runs server-side.

Tools

ToolPriceWhat it does
scan_honeypot$0.005Rug/honeypot scan of an SPL token by mint: mint/freeze authority renounced?, Token-2022 transfer tax, top-holder concentration, and a live Jupiter buy→sell round trip as a strong signal the token is sellable at scan time (catches most honeypots). Returns a 0–100 risk score + AVOID/CAUTION/LOW RISK verdict.
analyze_pools$0.015Deep liquidity-pool analysis across Raydium/Orca/Meteora/pumpswap: real fee APR, wash-trade risk, age, TVL, a token rug verdict, and a real Jupiter slippage ladder ($100/$1k/$10k). Recommends the best risk-adjusted pool.
top_pools$0.02The real best Solana DEX pools — wash-traded/fake-volume pools filtered out, the rest ranked by risk-adjusted fee yield, with an excluded list of what was dropped and why.
check_lp_status$0.005Liquidity durability / rug-pull exposure: pools (TVL, age, DEX), largest-pool depth, burned-supply share, and whether mint/freeze authority is still live. Returns a 0-100 liquidity-risk score + verdict (DURABLE/SHAKY/FRAGILE/RUG-PRONE).
check_deployer$0.01Deployer reputation: creator wallet address, creator's remaining holding %, wallet age, and token age. Verdict flags fresh wallets, heavy insider holding, and brand-new tokens.
can_i_sell$0.003Real-time sellability check at YOUR size: simulates exiting a specific USD amount of a Solana token via a live Jupiter buy→sell round trip and reports USDC recovered, real sell price impact, and tax/friction loss.
check_exit_risk$0.015Can I get out, and at what cost? Crosses Birdeye smart-money flow (whale net buy/sell 24h, bundler/sniper manipulation tags, 1h sell-pressure, holder count) with a live Jupiter exit-slippage ladder ($1k/$10k) → LOW/ELEVATED/HIGH exit-risk. The sellability wedge: are whales dumping into a thin book that traps you?
full_scan$0.03One-call full workup: bundles honeypot + LP durability + deployer + exit-risk into a single verdict with an aggregated overall {riskScore, riskLevel, verdict, topFlags} — cheaper than buying the four separately (~$0.035).
scan_wallet_risk$0.03Portfolio rug scan: reads a wallet's SPL holdings and runs the full honeypot/rug scan on each (up to 10 positions), returning per-token risk and which mints to exit.
scan_honeypot_batch$0.02Batch rug/honeypot scan: submit up to 10 Solana token mints and get the full per-token honeypot verdict for each in one paid call (cheaper than scanning individually).
build_guarded_swap$0.001 + 0.5%Build a ready-to-sign Jupiter swap with the rug check in front: a critical verdict on the token you are BUYING returns the verdict and no transaction. Returns an UNSIGNED versioned transaction — your wallet signs, this service never custodies funds. The 0.5% platform fee applies only when SELLING into USDC/SOL (buying is fee-free) and rides inside the transaction you sign.
validate_mintfreeLocal base58 mint-address format check. No payment.

Install & configure

Add it to your MCP client (Claude Code, Claude Desktop, …). Only a paying wallet is required — everything else defaults to production.

{
  "mcpServers": {
    "soldefi": {
      "command": "npx",
      "args": ["-y", "soldefi-mcp"],
      "env": {
        "SOLANA_PRIVATE_KEY": "<base58-or-JSON-array secret key of a DEDICATED Solana wallet holding USDC>"
      }
    }
  }
}

You can pay on Base instead of (or in addition to) Solana by setting EVM_PRIVATE_KEY (0x…). If both are set, the x402 layer uses whichever rail the server's payment challenge advertises.

Environment
VarDefaultNotes
SOLANA_PRIVATE_KEY—base58 or JSON-array secret key (32 or 64 bytes) of the paying Solana wallet.
EVM_PRIVATE_KEY—0x-prefixed key of the paying Base wallet.
SOLDEFI_BASE_URLhttps://soldefi.thomenz.mePoint at your own Worker if self-hosting.
X402_NETWORKbasebase (mainnet → Solana mainnet) or base-sepolia (testnet → Solana devnet).
SOLANA_RPC_URL—Optional RPC used to build the Solana payment (e.g. a Helius URL). Public default otherwise.

🔐 Security: these keys control real funds. Use a dedicated wallet with a small balance, never a personal/treasury key. Anything that can read this process' environment can spend from it.

The wallet needs

  • A little USDC on the chosen chain to pay per call.
  • On Solana, a tiny bit of SOL is not required for the payment itself (the facilitator sponsors the transaction fee), but the receiving side must have a USDC token account — which it does on the hosted service.

Develop

pnpm install
pnpm --filter soldefi-mcp build      # tsc → dist/
SOLANA_PRIVATE_KEY=… pnpm --filter soldefi-mcp dev   # run from source

License

MIT

الأسئلة الشائعة

ما هو io.github.thomenz/soldefi-mcp؟

Solana DeFi risk intel over x402: rug/honeypot scans, pool analysis, wash-filtered pools.

كيف أثبّت io.github.thomenz/soldefi-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add soldefi-mcp -e 'SOLANA_PRIVATE_KEY=<your solana_private_key>' -e 'EVM_PRIVATE_KEY=<your evm_private_key>' -e 'SOLANA_RPC_URL=<SOLANA_RPC_URL>' -e 'SOLDEFI_BASE_URL=<SOLDEFI_BASE_URL>' -e 'X402_NETWORK=<X402_NETWORK>' -- npx -y soldefi-mcp@0.5.2. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.thomenz/soldefi-mcp إلى مفتاح API؟

نعم. يتطلب SOLANA_PRIVATE_KEY, EVM_PRIVATE_KEY، وتضبطها في إعداداته.

هل io.github.thomenz/soldefi-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.thomenz/soldefi-mcp؟

ينشره thomenz. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.