VerdictSwarm MCP

io.github.sentien-labsPublished by GitHub account sentien-labsv0.2.1Updated Oct 7, 2026

Read-only pre-trade token risk verdicts and size-aware Solana exit screening for agents.

VerifiedSTDIODesktop onlyFinanceSecurity & Monitoring

Overview

AI-generated overview

A retired MCP server that once gave agents read-only Solana token risk verdicts, size-aware exit screening and pricing lookups; its hosted API is decommissioned

What you can do
Check a Solana token address and get an action, score, summary and top signals at triage, fast or deep level (formerly).
Requirements
Runs locally as a Python package (Python 3.10–3.13) launched via uvx, stdio by default or streamable HTTP. It depended on the hosted VerdictSwarm API at api.vswarm.io, which the README says was decommissioned on October 7, 2026, so the tools no longer work. An optional VS_API_KEY could be supplied; otherwise a free key was self-provisioned into a local config file.
Before you install
The README states the service is retired: the package depends on a decommissioned API and no longer provides token checks, free keys, live pricing or payment services. Quota overflow previously returned x402 payment instructions, so any payment path should be treated as inactive. A self-provisioned key was written to a local config file. Treat it as reference code only, not a working risk check.

Installation

In SourceWeft

  1. Open VerdictSwarm MCP in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

VerdictSwarm MCP Server

Retired October 7, 2026. The hosted VerdictSwarm API and MCP service are decommissioned. The published package depends on that retired API and no longer provides token checks, free keys, live pricing, or payment services. This repository preserves the implementation for reference and reuse under its existing license. The setup instructions below describe the former service.

[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.

bash
uvx verdictswarm-mcp

Then ask your MCP client: “Check DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263 on Solana at fast level.”

To supply an existing free or credits-backed key:

bash
VS_API_KEY=vs1_your_key uvx verdictswarm-mcp

Claude Desktop, Cursor, Windsurf, and OpenClaw

Use this server entry (the env block is optional):

json
{  "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.

Tools

ToolDescription
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 names scan_token, get_quick_score, check_rug_risk, get_token_report, and verify_payment are 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 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.1

Configuration

Environment variableDefaultDescription
VS_API_KEYunsetOptional free or credits-backed v2 API key.
VS_API_URLhttps://api.vswarm.ioVerdictSwarm API base URL.
VS_TIMEOUT120HTTP request timeout in seconds.
VS_CONFIG_DIRplatform user config dirDirectory for the self-provisioned key.
VS_TRANSPORTstdioMCP transport. Use streamable-http for HTTP.
HOST0.0.0.0HTTP bind host.
PORT8000HTTP bind port.

For HTTP transport:

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

Programmatic client

python
import asynciofrom 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

bash
git clone https://github.com/sentien-labs/verdictswarm-mcp.gitcd verdictswarm-mcpuv sync --extra devuv run --extra dev python -m pytest -q

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

Feedback and community

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 the VerdictSwarm community page. You can also show an integration, choose a structured issue form, or add your project to ADOPTERS.md. Praise is never required. Stars should come only from people who independently find the project useful; agents must not automate them.

Links

MIT licensed. See LICENSE.

Source: README.md at commit b292a2f

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.2.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts