scan_token
Scan a token contract for rug-pull risk before trading. Get a structured report with risk score, verdict, and flags.
Instructions
Run a pre-trade rug-pull risk scan on a token contract.
Returns a structured risk report. Pays $0.01 USDC on Base behind the
scenes via x402. The spend is tracked against per-session and 24 h
caps configured in the MCP server — if a cap is breached the call
returns a spend_cap_exceeded error WITHOUT signing.
Args:
chain: Chain identifier. base for Base mainnet EVM token
(14 heuristics). solana for Solana SPL mint (5 heuristics).
address: Token contract address — 0x... for EVM, base58 mint
address for Solana.
Returns:
On success: {score: 0-100, verdict: safe|low_risk|medium_risk|high_risk|critical|uncertain,
score_confidence: high|medium|low|insufficient_data,
rug_probability_30d: 0.0-1.0,
flags: [{code, severity, evidence}, ...],
scan_id: uuid for follow-up via explain_scan(...)}.
On failure: {error, message}. error is one of missing_credentials,
spend_cap_exceeded, payment_failed, request_failed,
non_200.
In demo mode (RUGGUARD_MCP_DEMO=1 or `--demo`): returns one of three
canned scenarios deterministically by `address[-1]`. Response has
`_demo: true` — never trade on this. No wallet, no network call.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| chain | Yes | ||
| address | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||