Soldefi Mcp
@thomenz
About Soldefi Mcp
An MCP (Model Context Protocol) server that gives AI agents paid access to Solana DeFi risk intelligence
Config
Add this server to your MCP-compatible client using the configuration below.
{
"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>"
}
}
}
}Tools
13Rug & honeypot scan of a Solana SPL token by mint. On-chain: mint/freeze authority renounced?, Token-2022 transfer tax, top-holder concentration, plus a live Jupiter buy->sell round trip proving the token is sellable at scan time (catches most honeypots). Returns a 0-100 risk score, machine flags and an agent-readable verdict (AVOID/CAUTION/LOW RISK). Paid ($0.005).
Deep liquidity-pool analysis for a Solana token across Raydium, Orca, Meteora and pumpswap. Per pool: real fee APR (volume x fee / TVL), wash-trade risk (turnover + executable-depth cross-check), age and TVL. Plus a token rug/honeypot verdict and a real Jupiter slippage ladder for true liquidity depth. Recommends the best risk-adjusted pool. Paid ($0.015).
The real best Solana DEX pools: the same top-pools feed a free API returns, but wash-traded and fake-volume pools are filtered out and the rest ranked by risk-adjusted fee yield (Raydium/Orca/Meteora). Returns clean, decision-ready pools plus an `excluded` list showing exactly which pools were dropped and why. Paid ($0.02).
Assess how durable a Solana token's liquidity is and whether a dev could pull it: 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). A durability signal, not a cryptographic LP time-lock proof. Paid ($0.005).
Trace who launched a Solana token: the mint's creator wallet, how much of the token the deployer still holds, the deployer wallet's age and the token's age. Returns a 0-100 risk score + verdict flagging fresh wallets, heavy insider self-holding and brand-new tokens. Paid ($0.01).
Simulate exiting a specific USD amount of a Solana token via a live Jupiter buy->sell round trip: whether you can actually sell, USDC recovered, real sell price impact and tax/friction loss. Answers 'can I get $X out right now, and at what cost?' — catches honeypots and thin books at your real trade size. Paid ($0.003).
Answer 'can I actually EXIT this Solana token right now, or am I trapped?' Crosses Birdeye smart-money signals — whale net buy/sell flow (24h), bundler/sniper manipulation tags, 1h sell-pressure and holder count — with a LIVE Jupiter exit-slippage ladder at $1k and $10k. Returns an exit_risk verdict (LOW/ELEVATED/HIGH): are the whales dumping into a thin book that traps you, or is the exit clean? The sellability wedge — for exit-planning and trading agents. Paid ($0.015).
One paid call that bundles the honeypot/sellability scan, liquidity-durability (LP) check, deployer reputation and live exit-risk (Birdeye smart-money x Jupiter exit-slippage) into a single verdict — cheaper than buying the four separately (~$0.035 -> $0.03). Returns each sub-report plus an aggregated `overall` {riskScore, riskLevel, verdict, topFlags}. The whole picture before you buy or exit. Paid ($0.03).
Read a Solana wallet's SPL holdings and run the full honeypot/rug scan on each (up to 10 positions). Returns per-token risk plus a summary of how many holdings are critical/high/medium/low and which mints to exit. For portfolio-manager and risk agents auditing exposure. Paid ($0.03).
Scan up to 10 Solana token mints in one paid call and get the full per-token honeypot verdict (0-100 risk score, flags, sellability) for each — cheaper than scanning individually. For vetting a watchlist or a set of launch candidates at once. Paid ($0.02).
Re-check up to 10 Solana mints and get back ONLY what moved since you last looked: risk score rises/falls and, crucially, individual signals that appeared or cleared (a freeze authority coming back barely moves the score, and is exactly what a holder needs to know). Pass the `state` object returned by your previous call as `baseline`; the response carries a fresh `state` to store for the next one. Without a baseline every mint comes back as `new`. This is the call to make on a schedule — the others answer 'what is the risk today', this one answers 'what changed'. Paid ($0.02).
Build a ready-to-sign Solana swap (Jupiter) with a rug check in front of it. Buying a token whose verdict is critical — or that cannot be sold — returns the verdict and NO transaction, so the swap you were about to make simply does not get built. Returns an UNSIGNED versioned transaction: your wallet signs and sends it, this service never custodies funds and cannot move anything. A 0.5% platform fee applies ONLY when selling into USDC/SOL; buying is fee-free. The fee is disclosed in the response and rides inside the transaction you sign. Paid ($0.001) for the build itself.
Free local base58 address-format validation of a single Solana mint. No payment required. Use it to avoid paying on a malformed mint.
Overview
What is 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. The intelligence runs server-side on the hosted Solana DeFi Intelligence API.
How to use Soldefi MCP?
Add it to your MCP client (e.g., Claude Code, Claude Desktop) by configuring the server with npx -y soldefi-mcp and setting the required environment variable SOLANA_PRIVATE_KEY (or EVM_PRIVATE_KEY for Base). A dedicated wallet with a small USDC balance is required; everything else defaults to production.
Key features of Soldefi MCP
- Rug/honeypot scanning with 0–100 risk score and verdict
- Deep liquidity-pool analysis across Raydium/Orca/Meteora/pumpswap
- Wash-trade-filtered “real best pools” ranking
- Live Jupiter buy→sell round trip for sellability checks
- Deployer reputation and wallet age analysis
- Batch and portfolio rug scanning capabilities
Use cases of Soldefi MCP
- Scan a Solana token for honeypot/rug risk before buying
- Analyze which liquidity pool offers the best risk-adjusted fee yield
- Check whether you can exit a position at a specific USD amount
- Assess a wallet’s total exposure to rugs in a single call
- Identify wash-traded or fake-volume pools to avoid
FAQ from Soldefi MCP
How are payments handled?
Each call is an x402 micropayment settled in USDC on Solana or Base. The call is charged only on success; malformed input is rejected for free.
What chains can I use for payment?
You can pay on Solana mainnet (using SOLANA_PRIVATE_KEY) or Base mainnet (using EVM_PRIVATE_KEY). If both are set, the x402 layer uses whichever rail the server’s payment challenge advertises.
Is there a free tier?
Yes, the validate_mint tool is free and performs a local base58 mint-address format check. No payment is required for that tool.
What are the security precautions?
Use a dedicated wallet with a small balance, never a personal or treasury key. Anything that can read the process environment can spend from it. The server does not need SOL on Solana for the payment itself (the facilitator sponsors the transaction fee), but the receiving side must have a USDC token account.
Where does the data come from?
The intelligence runs server-side on the hosted Solana DeFi Intelligence API (https://soldefi.thomenz.me by default). The MCP server is a thin payment-client bridge.
Frequently asked questions
How are payments handled?
Each call is an x402 micropayment settled in USDC on Solana or Base. The call is charged only on success; malformed input is rejected for free.
What chains can I use for payment?
You can pay on Solana mainnet (using `SOLANA_PRIVATE_KEY`) or Base mainnet (using `EVM_PRIVATE_KEY`). If both are set, the x402 layer uses whichever rail the server’s payment challenge advertises.
Is there a free tier?
Yes, the `validate_mint` tool is free and performs a local base58 mint-address format check. No payment is required for that tool.
What are the security precautions?
Use a dedicated wallet with a small balance, never a personal or treasury key. Anything that can read the process environment can spend from it. The server does not need SOL on Solana for the payment itself (the facilitator sponsors the transaction fee), but the receiving side must have a USDC token account.
Where does the data come from?
The intelligence runs server-side on the hosted Solana DeFi Intelligence API (`https://soldefi.thomenz.me` by default). The MCP server is a thin payment-client bridge.
Basic information
More AI & Agents MCP servers
XDC AI
XDC AI is a remote MCP server available at https://xdcai.tech.
Legion MCP
faulkjMCP-native LLM councils for debates, juries, blind panels, voting, refinement, and custom multi-model deliberation.
UnificAlly MCP
unifically-devUnificAlly MCP server. One API for 100+ AI video, image, music and speech models. https://mcp.unifically.com/mcp

Plainpaper
PlainpaperThe AI marketing canvas for Claude and MCP agents. Your agent drafts campaigns as cards on a shared board, briefed by your brand rules, approved by you.

Simplepages
SimplepagesBuild and edit landing pages and websites from your AI assistant, and pull how they are performing.
Comments