VerdictSwarm MCP Server

VerdictSwarm MCP 服务

已于 2026 年 10 月 7 日停用。 托管的 VerdictSwarm API 和 MCP 服务已停止运行。已发布的软件包依赖该已停用的 API，因此不再提供代币检查、免费密钥、实时定价或支付服务。本仓库根据现有许可证保留实现，供参考和复用。下方的设置说明描述的是此前提供的服务。

VerdictSwarm 是面向接触加密货币的 Agent 的交易前安全层。此 MCP 服务将 Verdict API v2 封装为一组精简的只读工具，用于代币检查、考虑交易规模的退出筛查和实时价格查询。

快速开始

无需设置账户。如果未设置 VS_API_KEY，服务会在首次调用由 API 提供支持的工具时生成一个免费密钥，并将其保存到平台用户配置目录中。

uvx verdictswarm-mcp

然后向 MCP 客户端提出请求：“在 Solana 上以 fast 级别检查 DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263。”

若要提供已有的免费密钥或由额度支持的密钥：

VS_API_KEY=vs1_your_key uvx verdictswarm-mcp

Claude Desktop、Cursor、Windsurf 和 OpenClaw

使用此服务条目（env 块为可选项）：

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

未设置 VS_API_KEY 时，自行配置的密钥会保存到：

• macOS：~/Library/Application Support/VerdictSwarm/config.json
• Linux：${XDG_CONFIG_HOME:-~/.config}/verdictswarm/config.json
• Windows：%APPDATA%\VerdictSwarm\config.json

在操作系统支持的情况下，创建的文件仅向当前用户开放权限。设置 VS_CONFIG_DIR 可覆盖此目录。

工具

工具	描述
check_token(address, chain="solana", level="fast")	调用 POST /v2/verdict，并返回操作、评分、摘要和最强的五项信号。级别包括 triage、fast 和 deep。
exit_sim(address, size_usd, side)	请求 include:["exit_sim"]，并返回最新的 Solana 退出模拟区块。方向为 buy 或 sell。
get_pricing()	从 GET /v2/verdict/info 读取实时定价、级别、限制和支持的链。

0.1.x 版本中的 scan_token、get_quick_score、check_rug_risk、get_token_report 和 verify_payment 不再作为 MCP 工具提供；客户端只能看到上述三个当前的 v2 工具。显式调用旧名称仍会返回迁移说明，且不会发出旧版付费通道请求。

免费额度与 x402 超额处理

API 会公布免费密钥各级别的每日限额。额度用尽时，工具响应会说明额度重置时间，并保留完整的 x402 挑战。若要立即继续，请将 VS_API_KEY 设置为由额度支持的密钥，或使用返回的 x402 支付说明。

MCP 客户端会在 API 请求中发送以下归属标头：

• X-VS-Integration: mcp
• X-VS-SDK-Version: 0.2.1

配置

环境变量	默认值	描述
VS_API_KEY	未设置	可选的免费或由额度支持的 v2 API 密钥。
VS_API_URL	https://api.vswarm.io	VerdictSwarm API 基础 URL。
VS_TIMEOUT	120	HTTP 请求超时时间，单位为秒。
VS_CONFIG_DIR	平台用户配置目录	自行配置密钥的目录。
VS_TRANSPORT	stdio	MCP 传输方式。使用 streamable-http 可采用 HTTP。
HOST	0.0.0.0	HTTP 绑定主机。
PORT	8000	HTTP 绑定端口。

HTTP 传输方式：

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

编程式客户端

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

开发

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

此服务支持 Python 3.10–3.13，以及 stdio 和 HTTP 两种传输方式。

反馈与社区

在 Agent、机器人、钱包或仪表板中使用了此服务？请通过 VerdictSwarm 社区页面分享客户端、运行时、风险检查的适用环节，以及哪些做法有效或无效。 你也可以展示集成方案， 选择结构化的问题表单， 或将你的项目添加到 ADOPTERS.md。无需刻意称赞。 只有独立认为该项目有用的人才应点星标； Agent 不得自动点星标。

链接

• VerdictSwarm
• API 文档
• GitHub 仓库
• 安全策略

采用 MIT 许可。请参阅 LICENSE。