rug-check
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@rug-check check token 0x4ed4e862860bed51a9570b96d89af5e1b0efefed on base"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
rug-check π¨
On-chain rug-pull & honeypot risk screen for ERC-20 tokens β for AI agents and traders.
Give it a token address and get a SAFE / CAUTION / HIGH-RISK verdict (0β100 score) in one call, built entirely from live public-RPC reads β no API key, no node, no signup.
rug-check is an automated on-chain risk screen, not financial advice or a safety guarantee. It pattern-matches deployed bytecode and reads chain state; it cannot catch every scam (off-chain admin keys, novel honeypots) and may flag benign contracts. Always do your own research.
Why it exists (the moat)
An AI coding/trading agent that "just reads the chain" does not know:
Which dangerous functions the token's deployed bytecode exposes β
mint,blacklist,pause,setFees,setMaxTxβ the levers used to trap or dilute holders.Whether ownership is renounced, or an active owner can still call those powers after you buy.
How concentrated supply is in the owner/deployer wallet (dump risk).
Whether a DEX liquidity pair exists, how deep it is, and whether the LP tokens are locked or burned β the single thing that decides if the deployer can pull all liquidity (the literal "rug pull").
rug-check ABI-encodes and batches all of that, decodes the bytecode, scores it, and returns one verdict.
Related MCP server: safeagent-token-safety
What it checks
Check | What it tells you |
Owner powers | scans runtime bytecode for |
Ownership | renounced vs active owner ( |
Concentration | % of total supply held by the owner wallet |
Liquidity | UniswapV2/Pancake pair reserves vs wrapped-native, depth, thin-liquidity flag |
LP lock/burn | % of LP supply in burn address or known lockers (Pinksale, Unicrypt, Team.Financeβ¦) |
Proxy | EIP-1967 upgradeable-proxy detection (behaviour can change post-launch) |
Chains: Ethereum, Base, BSC, Polygon, Arbitrum.
Use as an MCP server (free)
{
"mcpServers": {
"rug-check": { "command": "npx", "args": ["-y", "rugshield-mcp"] }
}
}Tools:
rug_check_tokenβ{ chain, address }β full risk report.rug_check_manyβ up to 10{ chain, address }β batch verdicts.
Or connect over HTTP at POST /mcp.
Free HTTP API
GET /check?chain=base&address=0x4ed4e862860bed51a9570b96d89af5e1b0efefed
GET /check?chain=ethereum&address=0x6b175474e89094c44da98b954eedeac495271d0fRate-limited 30/h/IP.
Pay-per-call (x402)
The /pro/* routes are gated by x402. Your agent pays $0.25 USDC per call automatically β no sign-up, no API key. Settles on-chain (Base) to the operator wallet.
GET /pro/check?chain=base&address=0x...
GET /pro/check_many?tokens=base:0x..,bsc:0x..Discovery: GET /openapi.json (with x-payment-info) and GET /.well-known/x402.
Develop
npm install
npm run build
npm run test:engine # offline unit tests + live on-chain sanity checks
npm run dev:http # local HTTP server on :8080 (payments OFF unless configured)
npm run dev:mcp # stdio MCP serverMIT Β© rug-check
Available Tools
2 toolsrug_check_manyA
Run rug_check on up to 10 tokens at once. Pass an array of {chain,address}. Returns the verdict and score for each so an agent can screen a watchlist or a batch of candidate tokens in one call.
Inputs: tokens (required).
rug_check_tokenA
Assess whether an ERC-20 token is a likely SCAM / rug pull BEFORE buying or interacting with it. Returns a risk score (0-100) and verdict (SAFE / CAUTION / HIGH RISK) built from LIVE on-chain reads: dangerous owner powers found in the token's deployed bytecode (mint, blacklist, pause, set-fee, set-max-tx), whether ownership is renounced, what % of supply the owner holds, whether a DEX liquidity pair exists and how deep it is, and whether the LP tokens are locked/burned (so the deployer can't pull liquidity). Use this whenever a user or agent is about to trade, approve, or add liquidity for an unfamiliar token. Chains: ethereum, base, bsc, polygon, arbitrum.
Inputs: chain (required), address (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
TDQS
Scored across 2 tools
The two tools have clearly distinct purposes: one for batch checking up to 10 tokens, the other for individual token assessment. No overlap.
Both tools follow a consistent 'rug_check_' prefix with descriptive verbs ('many' vs 'token'), all in snake_case.
With only 2 tools, the count is minimal but perfectly scoped for the domain of rug checking, covering both individual and batch needs.
The tool set covers the primary use case (assessing token risk) with both single and batch modes, leaving no obvious gaps for the intended purpose.
Related MCP Connectors
Honeypot detection & token risk scan for ERC-20s. Risk score 0-100, tax, source verification.
Token Risk β rug-pull / honeypot screening for crypto tokens.
Instant rug-check for any EVM or Solana token, distilled to one clear 0-10 risk verdict.
Read-only honeypot, holder and liquidity scam checks for tokens across 64 networks.
Related MCP Servers
- AlicenseAqualityDmaintenancePer-transaction crypto trade validator for AI agents, validates trades with PROCEED/CAUTION/BLOCK verdicts, scans tokens for anomalies, detects rug pulls, and searches across DEXes. Powered by WaveGuard physics engine with deterministic PDE-based analysis.526 PyPI1MIT
- AlicenseNot gradedqualityDmaintenanceToken safety oracle for AI agents. Honeypot detection, 17 scam pattern checks, LP lock verification across 6 EVM chains. Score 0-100 with risk flags. ERC Token Safety Score standard.1MIT
- AlicenseNot gradedqualityCmaintenanceOn-chain Solana token safety MCP β screens SPL / Token-2022 tokens for rug-pull and honeypot patterns (mint/freeze authority, liquidity, holders, sellability), then executes MEV-protected swaps.1MIT
- AlicenseAqualityCmaintenanceOn-chain Solana token safety for trading agents β traces coordinated wallet funding, same-block Jito bundles, serial-rug deployers and live coordinated dumps into one Exit-Liquidity Risk verdict before a swap. Free tier, then $0.02 USDC/query via x402.1103 npm2MIT