scan_token
Scan one token on one chain and get everything a buyer is being scammed by: supply, who can mint more of it, whether the pool's liquidity is locked, the pool's fee parameters, holder concentration over a recent window, and the putty Verify label for the contract. FREE, unauthenticated, and it reads the chain but spends nothing of yours. **Every field settles to its own three-state value** — `measured` with a value, `unavailable` with `not_measurable` because the data source cannot answer, or `unavailable` with `read_failed` because the read itself failed. There is no fourth path: a failed read is never rendered as a `0`, an empty list, or a `false`. Two fields are deliberately not measured and say so — `simulation.buy` and `simulation.sell` are `not_measurable` from a token address alone, because a swap needs a pool, a router, and a quote amount, and putty does not fabricate a number a trader would act on; quote the real pool and show what the quote said. `holders` is a WINDOW over recent blocks, not a census, and the window is named in the response. `clearedForMainnet` is always `false` — no putty report, of any label, is an external audit. Use this before buying, and use `verify_contract` when you want the seven checks on the contract behind the token.
Scan one token on one chain and get everything a buyer is being scammed by: supply, who can mint more of it, whether the pool's liquidity is locked, the pool's fee parameters, holder concentration over a recent window, and the putty Verify label for the contract. FREE, unauthenticated, and it reads the chain but spends nothing of yours. Every field settles to its own three-state value — measured with a value, unavailable with not_measurable because the data source cannot answer, or unavailable with read_failed because the read itself failed. There is no fourth path: a failed read is never rendered as a 0, an empty list, or a false. Two fields are deliberately not measured and say so — simulation.buy and simulation.sell are not_measurable from a token address alone, because a swap needs a pool, a router, and a quote amount, and putty does not fabricate a number a trader would act on; quote the real pool and show what the quote said. holders is a WINDOW over recent blocks, not a census, and the window is named in the response. clearedForMainnet is always false — no putty report, of any label, is an external audit. Use this before buying, and use verify_contract when you want the seven checks on the contract behind the token.
Input
The tool takes a single JSON object. Every field, its type, and an example are on the generated reference at GET /mcp/tools, under this tool's name.
Calling it
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": { "name": "scan_token", "arguments": {} }
}Put your arguments in place of the empty object. A call that fails comes back as a normal result carrying isError: true and a message naming what went wrong, not as a JSON-RPC protocol error.
Notes
The category is Scan, subcategory Scan. The full request and response shape, and a live playground, live on the generated reference at GET /mcp/tools.