Skip to main content
Glama
vswarm-ai

VerdictSwarm MCP Server

by vswarm-ai

πŸ” VerdictSwarm MCP Server

GitHub Python License: MIT MCP

The first crypto token scanner available via MCP. Give any AI agent the ability to analyze tokens for rug pulls, scams, and risk β€” powered by VerdictSwarm's 6-AI-agent consensus system.

Works with Claude Desktop, OpenClaw, Cursor, Codex, Windsurf, and any MCP-compatible client.


Why?

AI trading agents are making on-chain decisions with no risk analysis. VerdictSwarm MCP gives them instant access to:

  • 6-agent consensus scoring β€” not one model's opinion, six independent AI agents debate the risk

  • On-chain security audits β€” mint authority, freeze authority, honeypot detection, LP lock status

  • Rug pull detection β€” holder concentration, bundle/sniper activity, contract age analysis

  • Human-readable reports β€” markdown reports ready to share or embed

One tool call. Sub-second cached responses. No blockchain node required.

Quick Start

Install & Run

# Install from GitHub pip install git+https://github.com/vswarm-ai/verdictswarm.git#subdirectory=mcp-server VS_API_KEY=your_key verdictswarm-mcp # Or with uvx (zero-install) VS_API_KEY=your_key uvx git+https://github.com/vswarm-ai/verdictswarm.git#subdirectory=mcp-server # Or clone and run git clone https://github.com/vswarm-ai/verdictswarm.git cd verdictswarm/mcp-server uv run verdictswarm-mcp

Claude Desktop

Add to your claude_desktop_config.json:

{ "mcpServers": { "verdictswarm": { "command": "uvx", "args": ["git+https://github.com/vswarm-ai/verdictswarm.git#subdirectory=mcp-server"], "env": { "VS_API_KEY": "your_key_here" } } } }

Then ask Claude: "Check if this token is safe:

OpenClaw

mcpServers: verdictswarm: command: uvx args: ["verdictswarm-mcp"] env: VS_API_KEY: your_key_here

No API Key?

The server works without a key at free-tier limits (10 scans/day, basic scores only). Get a key at verdictswarm.ai for full access.

Tools

Tool

Description

Use When

scan_token

Full 6-agent consensus analysis

Deep due diligence on a specific token

get_quick_score

Fast cached score lookup (0-100)

Quick check before buying

check_rug_risk

Focused security/rug assessment

"Is this a scam?"

get_trending_risky

Trending high-risk tokens

Market surveillance (coming soon)

get_token_report

Formatted markdown report

Sharing analysis with others

Example: Quick Score

User: What's the risk score for BONK? Agent: [calls get_quick_score("DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263")] β†’ Score: 74/100 (Grade B) β€” LOW-MEDIUM risk

Example: Rug Check

User: Is this new memecoin safe? 7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU Agent: [calls check_rug_risk("7xKXtg...")] β†’ DANGER 🚨 Liquidity NOT burned or locked ⚠️ Mint authority active ⚠️ Token is less than 24 hours old ⚠️ Bundle/sniper activity detected

Resources & Prompts

Resources (reference data for agents):

  • verdictswarm://help β€” Tool usage guide

  • verdictswarm://scoring β€” Score interpretation (0-100 scale, grades A-F)

Prompts (pre-built workflows):

  • should_i_buy(token_address) β€” Full investment analysis with recommendation

  • portfolio_check(tokens) β€” Batch risk assessment across holdings

Supported Chains

Chain

Status

Solana

βœ… Full support

Ethereum

βœ… Full support

Base

βœ… Full support

BSC

βœ… Full support

Scoring Guide

Score

Grade

Risk Level

Meaning

80-100

A

LOW

Relatively safe, established project

70-79

B

LOW-MEDIUM

Minor concerns, generally okay

60-69

C

MEDIUM

Proceed with caution

40-59

D

HIGH

Significant red flags

0-39

F

CRITICAL

Likely scam or rug pull

Configuration

Environment Variable

Default

Description

VS_API_KEY

(empty β€” free tier)

Your VerdictSwarm API key

VS_API_URL

https://verdictswarm-production.up.railway.app

API base URL

VS_TIMEOUT

120

Request timeout in seconds

Architecture

MCP Client (Claude, Cursor, OpenClaw, Codex...) β”‚ β”‚ MCP Protocol (stdio) β–Ό β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚ VerdictSwarm MCP Server β”‚ ← This package (thin wrapper) β”‚ FastMCP + Python β”‚ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β”‚ HTTP (httpx) β–Ό β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚ VerdictSwarm API β”‚ ← Existing backend (Railway) β”‚ 6 AI agents + on-chain β”‚ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

The MCP server is a stateless wrapper β€” all intelligence lives in the VerdictSwarm API. This means:

  • Lightweight deployment (no GPU, no blockchain node)

  • Single source of truth for scan logic

  • API-level rate limiting and caching already work

Development

git clone https://github.com/vswarm-ai/verdictswarm.git cd verdictswarm/mcp-server pip install -e ".[dev]" pytest # 47 tests, ~0.3s

License

MIT β€” see LICENSE.


Built by

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/vswarm-ai/verdictswarm-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server