For AI agents · MCP · REST · self-serve Pro

A rug check your agent can call

Trading agents and assistants touch unfamiliar Solana tokens all day. RugRadar gives them a read-only risk check over MCP or plain HTTP, and lets an agent buy Pro on its own with USDC or SOL.

Remote MCP server

URL
https://rugradar-bgcm.onrender.com/mcp
Transport
Streamable HTTP (stateless, JSON responses)
Auth
None for the free tier. Pro: Authorization: Bearer <key> or the api_key tool argument
Open source client
github.com/HOBSTER6615/rugradar-mcp (MIT, stdio)

Tools

check_token

Check a Solana token for rug-pull and scam risk. Input: a mint address, a pump fun or DexScreener link, or a $TICKER. Returns a 0-100 risk score (0-29 low risk, 30-59 caution, 60-100 high risk), plain-English red flags (mint/freeze authority, Token-2022 extensions, holder concentration, dev wallet and its launch history, linked insider wallets, LP lock, honeypot sell test, liquidity, drawdown) and a dump-model probability for tokens under 6 hours old. Read-only: never needs a wallet connection or signature. Free: 5 checks/day per IP (shared with the REST API); Pro key: unlimited. Automated risk signals, not financial advice. A low score is not a recommendation to buy.

scan_wallet

List the SPL tokens held by a PUBLIC Solana wallet address, riskiest first, with a quick risk score and top red flags per token. Never send a private key or seed phrase. Free: the 3 riskiest tokens, 5 scans/day per IP; Pro key: every token, unlimited. Automated risk signals, not financial advice. A low score is not a recommendation to buy.

scan_link

Scan a URL or pasted post text for wallet-drainer and phishing patterns (fake claim/airdrop pages, lookalike domains, wallet-connect bait). Free: 20/day per IP; Pro: unlimited.

get_pro_quote

Get a payment quote for RugRadar Pro ($9 for 30 days, no auto-renewal): the exact USDC and SOL amounts, the Solana pay-to address, a unique reference to include in the payment (as a Solana Pay reference key or in an SPL Memo), a signed order token, and x402 details when available. Does not move funds; the agent or its user must send the payment from their own wallet.

verify_payment_and_get_key

After paying a quote, verify the Solana transaction on-chain (correct recipient, amount worth at least 95% of the price, carries the quote reference, confirmed, under 7 days old) and receive a RugRadar Pro API key valid for 30 days per payment. Idempotent: the same signature with the same order returns the same key; a signature can only be redeemed once.

get_pro_status

Check whether a RugRadar Pro API key is valid and when it expires, plus the current free and Pro limits.

watch_token

Pro: add a token to this key's agent watchlist (up to 25). RugRadar stores a baseline snapshot (score, liquidity, holder concentration, dev and insider holdings, sell test, authorities). Poll get_watch_status to see what changed. There are no push notifications over MCP; for push alerts use the Telegram bot.

unwatch_token

Pro: remove a token from this key's agent watchlist.

get_watch_status

Pro: re-check watched tokens (up to 5 stale ones per call; others use their last check) and report changes since each baseline: dev or insider wallets selling, liquidity pulled or draining, holder concentration jumps, sell test failing, authorities re-enabled, risk score or dump-model spikes, price halving. Automated risk signals, not financial advice. A low score is not a recommendation to buy.

Automated risk signals, not financial advice. RugRadar never needs a wallet connection, signature, private key or seed phrase to check anything.

Set up

Claude Code

claude mcp add --transport http rugradar https://rugradar-bgcm.onrender.com/mcp
# with a Pro key:
claude mcp add --transport http rugradar https://rugradar-bgcm.onrender.com/mcp --header "Authorization: Bearer YOUR_KEY"

Cursor

~/.cursor/mcp.json (or .cursor/mcp.json in a project)

{
  "mcpServers": {
    "rugradar": {
      "url": "https://rugradar-bgcm.onrender.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_KEY" }
    }
  }
}

Drop the headers line for the free tier.

Claude Desktop

Settings → Connectors → Add custom connector, URL https://rugradar-bgcm.onrender.com/mcp. Or run the open-source stdio client from claude_desktop_config.json (needs Node 18+):

{
  "mcpServers": {
    "rugradar": {
      "command": "npx",
      "args": ["-y", "github:HOBSTER6615/rugradar-mcp"],
      "env": { "RUGRADAR_API_KEY": "" }
    }
  }
}

Any MCP client

Point a Streamable HTTP client at https://rugradar-bgcm.onrender.com/mcp. Raw JSON-RPC works too:

curl -s https://rugradar-bgcm.onrender.com/mcp \
  -H 'content-type: application/json' -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"check_token","arguments":{"query":"DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"}}}'

REST

curl -s 'https://rugradar-bgcm.onrender.com/api/check?q=DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263'
curl -s 'https://rugradar-bgcm.onrender.com/api/wallet?address=<public wallet>' -H 'Authorization: Bearer YOUR_KEY'
curl -s https://rugradar-bgcm.onrender.com/api/scan-link -H 'content-type: application/json' -d '{"text":"https://example.com/claim"}'

Full spec: /openapi.json (OpenAPI 3.1). Summary for LLMs: /llms.txt.

Let the agent buy Pro

Free: 5 API or MCP checks a day per IP, the 3 riskiest tokens per wallet scan. Pro: unlimited checks, full wallet scans, an agent watchlist of 25 tokens with change reports, and the Telegram alerts. $9 per 30 days, no auto-renewal. Have the agent ask its user before it spends funds.

1. Get a quote

MCP get_pro_quote, GET /api/pro/quote, or the body of any 402 Payment Required response once the free limit is used up.

curl -s https://rugradar-bgcm.onrender.com/api/pro/quote
{ "price_usd": 9, "pay_to": "3B9w9iQrCn4LrmdmPqCttjms6DB1psZRPmA1aJre8SZS",
  "options": [ { "asset": "USDC", "amount": "9", "amount_atomic": "9000000" }, { "asset": "SOL", "amount": "…" } ],
  "reference": "<unique pubkey>", "memo": "<same reference>", "order": "ro1.…",
  "verify": { "method": "POST", "url": "https://rugradar-bgcm.onrender.com/api/pro/verify" } }

2. Pay on Solana mainnet

Send 9 USDC (mint EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v) or the quoted SOL to 3B9w9iQrCn4LrmdmPqCttjms6DB1psZRPmA1aJre8SZS in one transaction that carries the reference: as a read-only account key on the transfer (Solana Pay, which the quote's solana_pay_url does for you) or as an SPL Memo containing it.

3. Verify and get the key

curl -s https://rugradar-bgcm.onrender.com/api/pro/verify -H 'content-type: application/json' \
  -d '{"signature":"<tx signature>","order":"ro1.…"}'
{ "ok": true, "key": "rr1.…", "expires": "…" }

RugRadar checks on-chain that the payment reached the address, is worth at least 95% of the price, carries the reference, is confirmed and is under 7 days old. One signature gives one key; repeating the call with the same order returns the same key. Use it as Authorization: Bearer rr1.…, or in Telegram with /pro rr1.….

x402

Available now: x402 v2, scheme exact, network solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp, 9 USDC (9000000 base units), settled through the https://facilitator.payai.network facilitator, which pays the network fee. Call GET /api/pro/x402 (or any metered endpoint past the free limit), read the PAYMENT-REQUIRED header, and retry with PAYMENT-SIGNATURE. The response carries your Pro key in the body and in X-RugRadar-Pro-Key.

Limits worth knowing