VerdictSwarm MCP Server

VerdictSwarm is a pre-trade security layer for agents that touch crypto. This MCP server exposes the Verdict API v2 as a small set of read-only tools for token checks, size-aware exit screening, and live pricing discovery.

No account setup is required. IfVS_API_KEYis absent, the server mints a free key on the first API-backed tool call and saves it in the platform user config directory.

Then ask your MCP client: “CheckDezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263on Solana at fast level.”

To supply an existing free or credits-backed key:

VS_API_KEY=vs1_your_key uvx verdictswarm-mcp

Claude Desktop, Cursor, Windsurf, and OpenClaw

Use this server entry (theenvblock is optional):

{ "mcpServers": { "verdictswarm": { "command": "uvx", "args": ["verdictswarm-mcp"], "env": { "VS_API_KEY": "vs1_your_key" } } } }

WithoutVS_API_KEY, the self-provisioned key is stored at:

- macOS:~/Library/Application Support/VerdictSwarm/config.json
- Linux:${XDG_CONFIG_HOME:-~/.config}/verdictswarm/config.json
- Windows:%APPDATA%\VerdictSwarm\config.json

The file is created with user-only permissions where the operating system supports them. SetVS_CONFIG_DIRto override the directory.

The 0.1.x namesscan_token,get_quick_score,check_rug_risk,get_token_report, andverify_paymentare no longer advertised as MCP tools; clients see only the three current v2 tools above. An explicit call to an old name still returns a migration response and makes no legacy pay-lane request.

Free keys have per-level daily limits advertised by the API. If a limit is exhausted, the tool response says when the quota resets and preserves the complete x402 challenge. To continue immediately, setVS_API_KEYto a credits-backed key or use the returned x402 payment instructions.

The MCP client sends these attribution headers on API requests:

- X-VS-Integration: mcp
- X-VS-SDK-Version: 0.2.1

VS_TRANSPORT=streamable-http HOST=0.0.0.0 PORT=8000 uvx verdictswarm-mcp

import asyncio from verdictswarm_mcp import VerdictSwarmApiClient async def main(): client = VerdictSwarmApiClient() verdict = await client.check_token("TOKEN_ADDRESS", "solana", "fast") print(verdict["verdict"]["action"], verdict["verdict"]["score"]) asyncio.run(main())

git clone https://github.com/sentien-labs/verdictswarm-mcp.git cd verdictswarm-mcp uv sync --extra dev uv run --extra dev python -m pytest -q

The server supports Python 3.10–3.13 and both stdio and HTTP transports.

Used the server in an agent, bot, wallet, or dashboard? Share the client, runtime, where the risk check fits, and what worked or failed through theVerdictSwarm community page. You can alsoshow an integration,choose a structured issue form, or add your project toADOPTERS.md. Praise is never required. Stars should come only from people who independently find the project useful; agents must not automate them.

- VerdictSwarm
- API documentation
- GitHub repository
- Security policy

x402 payment gateway for AI agents — 12 crypto data tools (price, whale activity, gas, TVL, Fear & Greed, Dune queries) paid per-call in USDC on Stellar or Base. No API keys, no subscriptions.