Skip to main content
Glama
sentien-labs

VerdictSwarm MCP Server

by sentien-labs

VerdictSwarm MCP Server

PyPI Python License: MIT MCP

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.

Quick start

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

uvx verdictswarm-mcp

Then ask your MCP client: “Check DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263 on 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 (the env block is optional):

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

Without VS_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. Set VS_CONFIG_DIR to override the directory.

Related MCP server: aegis-defi

Tools

Tool

Description

check_token(address, chain="solana", level="fast")

Calls POST /v2/verdict and returns action, score, summary, and the five strongest signals. Levels are triage, fast, and deep.

exit_sim(address, size_usd, side)

Requests include:["exit_sim"] and returns the fresh Solana exit-simulation block. Side is buy or sell.

get_pricing()

Reads live pricing, levels, limits, and supported chains from GET /v2/verdict/info.

The 0.1.x tools scan_token, get_quick_score, check_rug_risk, get_token_report, and verify_payment remain callable for migration safety, but return a deprecation response and make no legacy pay-lane request.

Free quota and x402 overflow

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, set VS_API_KEY to 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.0

Configuration

Environment variable

Default

Description

VS_API_KEY

unset

Optional free or credits-backed v2 API key.

VS_API_URL

https://api.vswarm.io

VerdictSwarm API base URL.

VS_TIMEOUT

120

HTTP request timeout in seconds.

VS_CONFIG_DIR

platform user config dir

Directory for the self-provisioned key.

VS_TRANSPORT

stdio

MCP transport. Use streamable-http for HTTP.

HOST

0.0.0.0

HTTP bind host.

PORT

8000

HTTP bind port.

For HTTP transport:

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

Programmatic client

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())

Development

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.

MIT licensed. See LICENSE.

Install Server
A
license - permissive license
A
quality
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
1Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    -
    quality
    F
    maintenance
    MCP server for real-time Solana token risk analysis. Cross-references RugCheck.xyz, DexScreener, and GoPlus Security to generate three-layer reports: machine verdict → LLM analysis → raw on-chain evidence. Live on Solana mainnet with USDC micropayments ($0.02/audit). Give any AI agent the ability to check if a token is safe before trading.
    Last updated
    2
    MIT
  • A
    license
    A
    quality
    B
    maintenance
    Provides post-deploy Solana threat intelligence, enabling AI agents to check operators, tokens, and network stats for detecting rug pulls and malicious activity.
    Last updated
    5
    26
    MIT

View all related MCP servers

Related MCP Connectors

View all MCP Connectors

Appeared in Searches

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/sentien-labs/verdictswarm-mcp'

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