| scan_token | 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_quick_score | 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.
|
| check_rug_risk | 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 | 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_token_report | 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_pricing | 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_payment | 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.
|
