Skip to main content
Glama

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.

MCP x402 license

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 mint / blacklist / pause / setFees / setMaxTx

Ownership

renounced vs active owner (owner() / getOwner() β†’ zero/dead = renounced)

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=0x6b175474e89094c44da98b954eedeac495271d0f

Rate-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 server

MIT Β© rug-check

Available Tools

2 tools
rug_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

    A4.4/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools have clearly distinct purposes: one for batch checking up to 10 tokens, the other for individual token assessment. No overlap.

    Naming Consistency5/5

    Both tools follow a consistent 'rug_check_' prefix with descriptive verbs ('many' vs 'token'), all in snake_case.

    Tool Count5/5

    With only 2 tools, the count is minimal but perfectly scoped for the domain of rug checking, covering both individual and batch needs.

    Completeness5/5

    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

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Per-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.
      5
      26 PyPI
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Token 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.
      1
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      On-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.
      1
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      On-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.
      1
      103 npm
      2
      MIT