{
  "markdown": "# soldefi-mcp\n\nAn **MCP (Model Context Protocol) server** that gives AI agents paid access to\n**Solana DeFi risk intelligence** — rug/honeypot scans, deep liquidity-pool\nanalysis, and a wash-trade-filtered \"real best pools\" ranking. Each paid call\nsettles an **x402 micropayment in USDC** (on **Solana** or **Base**)\nautomatically, using a wallet you configure. A call is charged **only on\nsuccess** — malformed input is rejected for free.\n\nIt talks to the hosted **Solana DeFi Intelligence** API\n(`https://soldefi.thomenz.me` by default). This package is a thin payment-client\nbridge; the intelligence runs server-side.\n\n## Tools\n\n| Tool | Price | What it does |\n|---|---|---|\n| `scan_honeypot` | $0.005 | Rug/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. |\n| `analyze_pools` | $0.015 | Deep 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. |\n| `top_pools` | $0.02 | The **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. |\n| `check_lp_status` | $0.005 | Liquidity 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`). |\n| `check_deployer` | $0.01 | Deployer reputation: creator wallet address, creator's remaining holding %, wallet age, and token age. Verdict flags fresh wallets, heavy insider holding, and brand-new tokens. |\n| `can_i_sell` | $0.003 | Real-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. |\n| `check_exit_risk` | $0.015 | **Can 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? |\n| `full_scan` | $0.03 | **One-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). |\n| `scan_wallet_risk` | $0.03 | Portfolio 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. |\n| `scan_honeypot_batch` | $0.02 | Batch 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). |\n| `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. |\n| `validate_mint` | free | Local base58 mint-address format check. No payment. |\n\n## Install & configure\n\nAdd it to your MCP client (Claude Code, Claude Desktop, …). Only a paying\nwallet is required — everything else defaults to production.\n\n```json\n{\n  \"mcpServers\": {\n    \"soldefi\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"soldefi-mcp\"],\n      \"env\": {\n        \"SOLANA_PRIVATE_KEY\": \"<base58-or-JSON-array secret key of a DEDICATED Solana wallet holding USDC>\"\n      }\n    }\n  }\n}\n```\n\nYou can pay on **Base** instead of (or in addition to) Solana by setting\n`EVM_PRIVATE_KEY` (`0x…`). If both are set, the x402 layer uses whichever rail\nthe server's payment challenge advertises.\n\n### Environment\n\n| Var | Default | Notes |\n|---|---|---|\n| `SOLANA_PRIVATE_KEY` | — | base58 or JSON-array secret key (32 or 64 bytes) of the paying Solana wallet. |\n| `EVM_PRIVATE_KEY` | — | `0x`-prefixed key of the paying Base wallet. |\n| `SOLDEFI_BASE_URL` | `https://soldefi.thomenz.me` | Point at your own Worker if self-hosting. |\n| `X402_NETWORK` | `base` | `base` (mainnet → Solana mainnet) or `base-sepolia` (testnet → Solana devnet). |\n| `SOLANA_RPC_URL` | — | Optional RPC used to build the Solana payment (e.g. a Helius URL). Public default otherwise. |\n\n> 🔐 **Security:** these keys control real funds. Use a **dedicated wallet with a\n> small balance**, never a personal/treasury key. Anything that can read this\n> process' environment can spend from it.\n\n## The wallet needs\n\n- A little **USDC** on the chosen chain to pay per call.\n- On **Solana**, a tiny bit of **SOL** is *not* required for the payment itself\n  (the facilitator sponsors the transaction fee), but the receiving side must\n  have a USDC token account — which it does on the hosted service.\n\n## Develop\n\n```bash\npnpm install\npnpm --filter soldefi-mcp build      # tsc → dist/\nSOLANA_PRIVATE_KEY=… pnpm --filter soldefi-mcp dev   # run from source\n```\n\n## License\n\nMIT\n",
  "bytes": 5595,
  "sha": "4eae8e593b7d4a1deb1af46faa9f60b76a406e34173b4b55d111f66b96e3d7fe",
  "repo_slug": "thomenz/soldefi-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_thomenz_soldefi_mcp_174bf7ef/readme"
}