VerdictSwarm MCP Server

Perform comprehensive token risk analysis using VerdictSwarm's 6-AI-agent consensus system. This tool executes a full scan of a token contract and returns detailed findings including overall score, risk level, agent-level analysis, and security checks. Cost: 0.10 USDC per call (or valid API key). Args: token_address: The contract or mint address to analyze. chain: Target blockchain (solana, ethereum, base, bsc). depth: Analysis depth (basic, full, debate). api_key: Optional API key for authenticated access. tx_signature: Optional Solana transaction signature for USDC micropayment. Returns: Dictionary containing full analysis results from VerdictSwarm API, or an error payload.

Get a quick risk score for a token using cached or fast-path analysis. Use this when you need a fast confidence check before deeper analysis. Returns score (0-100), derived risk level, and basic token metadata. Free tier: 10 calls/day (no auth required). Cost: 0.02 USDC per call beyond free tier. Args: token_address: The contract or mint address to inspect. chain: Target blockchain (solana, ethereum, base, bsc). api_key: Optional API key for authenticated access. tx_signature: Optional Solana transaction signature for USDC micropayment. client_id: Optional identifier for free-tier rate limiting (e.g. agent wallet address). Returns: Minimal structured score summary, or an error payload.

Run a focused rug-pull risk assessment with high-signal security indicators. Evaluates common red flags such as mint/freeze controls, liquidity lock/burn status, honeypot-like behavior, concentration concerns, and related risk indicators present in the scan response. Cost: 0.05 USDC per call (or valid API key). Args: token_address: The contract or mint address to assess. chain: Target blockchain (solana, ethereum, base, bsc). api_key: Optional API key for authenticated access. tx_signature: Optional Solana transaction signature for USDC micropayment. Returns: Structured verdict containing SAFE/CAUTION/DANGER, risk factors, and security checks, or an error payload.

Get trending risky tokens for the selected chain. This endpoint is planned for a future API phase. For now, it returns a clear placeholder payload so clients can integrate against a stable tool signature. Args: chain: Blockchain to query (solana, ethereum, base). min_risk_level: Threshold to include (MEDIUM, HIGH, CRITICAL). limit: Number of items requested (1-20). Returns: Placeholder response describing current availability status.

Get a human-readable markdown report for a token. Generates a formatted report suitable for sharing that includes score, risk level, major risk factors, security checks, and optional recommendation fields when available. Cost: 0.02 USDC per call (or valid API key). Args: token_address: The contract or mint address to report on. chain: Target blockchain (solana, ethereum, base, bsc). api_key: Optional API key for authenticated access. tx_signature: Optional Solana transaction signature for USDC micropayment. Returns: Markdown-formatted report text, or a markdown error message.

Get the current pricing table for all VerdictSwarm MCP tools. Returns pricing in USDC per call, payment wallet address, USDC mint, and instructions for submitting micropayments from autonomous agents. Returns: Dictionary with per-tool pricing, wallet info, and payment instructions.

Verify that a Solana USDC payment was received for a specific tool call. Agents can use this to confirm their payment before calling an expensive tool, or to debug failed payment verifications. Args: tx_signature: The Solana transaction signature of the USDC transfer. tool_name: The tool name the payment is intended for (used to check amount). Returns: Verification result with verified status, amount, and sender info.