check_token
Return a v2 verdict summary with action, score, and strongest signals on the free tier.
LABSCO SUMMARY
A risk check that answers in one call and needs nothing set up first.
Three read-only tools and self-provisioning keys make this cheap to place in front of a trade — the interesting one is exit_sim, which asks whether you could get out at the size you are proposing, not just whether the token looks legitimate. When a free level's daily quota runs out the response says when it resets and hands back the full payment challenge rather than failing opaquely.
What it is
A pre-trade security layer for agents that touch crypto. It exposes the Verdict API v2 as three read-only tools: a token check that returns an action and score, an exit simulation that tests a proposed trade size against exit-risk caps, and a pricing lookup that reports the current levels and quotas.
What you get
- check_token — a v2 verdict for an address on a chain, returning the recommended action, the score and the five strongest signals; levels are triage, fast and deep
- exit_sim — screen a proposed Solana trade size against exit-risk caps, buy or sell
- get_pricing — live free-tier levels, quotas, limits and supported chains, read from the discovery endpoint
Requirements
No account setup: run uvx verdictswarm-mcp and, if VS_API_KEY is absent, the server mints a free key on the first API-backed call and stores it in the platform user config directory with user-only permissions where the OS supports them. Supply an existing free or credits-backed key through VS_API_KEY to lift the per-level daily limits. VS_CONFIG_DIR moves the stored key, VS_API_URL and VS_TIMEOUT adjust the endpoint and timeout, and VS_TRANSPORT=streamable-http runs it over HTTP with HOST and PORT. Python 3.10 to 3.13.
Setup effort
One command — uvx verdictswarm-mcp
USE CASES
01
Checking a token before buying it
Run a verdict at the depth you need and read the action, score and strongest signals.
02
Testing whether your position size is exitable
Screen the proposed trade size against the exit-risk caps before committing to it.
03
Knowing what a deeper check costs
Read the current levels, quotas and supported chains before choosing a depth.
3 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
exit_sim
Screen a proposed Solana trade size against exit risk caps on the free tier.
get_pricing
Return live free-tier levels, quotas, and pricing from the v2 discovery endpoint.
BEFORE YOU INSTALL
What to know first
Tools you get
3 tools when we connected. All are read-only. check_token offers triage, fast and deep levels with daily limits on free keys, then returns an x402 payment challenge. Older names such as scan_token and get_quick_score now return a migration response.
Requires
uvx on PATH
CONTEXT COST
Light Standing cost
Rated by the size of the 3 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
uvx verdictswarm-mcpMCP Clients
Claude Desktop, Cursor, Windsurf, OpenClaw
JSON
{
"mcpServers": {
"verdictswarm": {
"command": "uvx",
"args": [
"verdictswarm-mcp"
],
"env": {
"VS_API_KEY": "<YOUR_VS_API_KEY>"
}
}
}
}Self-host — HTTP
SELF-HOST — HTTP · TERMINAL
VS_TRANSPORT=streamable-http HOST=0.0.0.0 PORT=8000 uvx verdictswarm-mcp
