VerdictSwarm MCP

Combate IA con IA. 6 agentes de IA adversariales debaten el riesgo de tokens cripto antes de que tu agente opere.

Documentación

VerdictSwarm MCP Server

VerdictSwarm es una capa de seguridad previa a la negociación para agentes que interactúan con criptomonedas. Este servidor MCP expone la API de Verdict v2 como un pequeño conjunto de herramientas de solo lectura para verificaciones de tokens, evaluación de salida consciente del tamaño y descubrimiento de precios en vivo.

Inicio rápido

No se requiere configuración de cuenta. Si VS_API_KEY está ausente, el servidor genera una clave gratuita en la primera llamada a una herramienta respaldada por la API y la guarda en el directorio de configuración de usuario de la plataforma.

uvx verdictswarm-mcp

Luego pídele a tu cliente MCP: «Verifica DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263 en Solana a nivel rápido».

Para proporcionar una clave gratuita existente o respaldada por créditos:

VS_API_KEY=vs1_your_key uvx verdictswarm-mcp

Claude Desktop, Cursor, Windsurf y OpenClaw

Usa esta entrada de servidor (el bloque env es opcional):

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

Sin VS_API_KEY, la clave autoaprovisionada se guarda en:

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

El archivo se crea con permisos solo para el usuario cuando el sistema operativo lo permite. Configura VS_CONFIG_DIR para anular el directorio.

Herramientas

Herramienta	Descripción
`check_token(address, chain="solana", level="fast")`	Llama a `POST /v2/verdict` y devuelve acción, puntuación, resumen y las cinco señales más fuertes. Los niveles son `triage`, `fast` y `deep`.
`exit_sim(address, size_usd, side)`	Solicita `include:["exit_sim"]` y devuelve el bloque fresco de simulación de salida de Solana. El lado es `buy` o `sell`.
`get_pricing()`	Lee precios en vivo, niveles, límites y cadenas compatibles desde `GET /v2/verdict/info`.

Los nombres 0.1.x scan_token, get_quick_score, check_rug_risk, get_token_report y verify_payment ya no se anuncian como herramientas MCP; los clientes solo ven las tres herramientas v2 actuales anteriores. Una llamada explícita a un nombre antiguo aún devuelve una respuesta de migración y no realiza ninguna solicitud heredada de carril de pago.

Cuota gratuita y desbordamiento x402

Las claves gratuitas tienen límites diarios por nivel anunciados por la API. Si se agota un límite, la respuesta de la herramienta indica cuándo se restablece la cuota y conserva el desafío x402 completo. Para continuar de inmediato, configura VS_API_KEY con una clave respaldada por créditos o usa las instrucciones de pago x402 devueltas.

El cliente MCP envía estos encabezados de atribución en las solicitudes a la API:

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

Configuración

Variable de entorno	Predeterminado	Descripción
`VS_API_KEY`	sin configurar	Clave API v2 opcional gratuita o respaldada por créditos.
`VS_API_URL`	`https://api.vswarm.io`	URL base de la API de VerdictSwarm.
`VS_TIMEOUT`	`120`	Tiempo de espera de solicitud HTTP en segundos.
`VS_CONFIG_DIR`	directorio de configuración de usuario de la plataforma	Directorio para la clave autoaprovisionada.
`VS_TRANSPORT`	`stdio`	Transporte MCP. Usa `streamable-http` para HTTP.
`HOST`	`0.0.0.0`	Host de enlace HTTP.
`PORT`	`8000`	Puerto de enlace HTTP.

Para transporte HTTP:

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

Cliente programático

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

Desarrollo

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

El servidor es compatible con Python 3.10–3.13 y con los transportes stdio y HTTP.

Comentarios y comunidad

¿Usaste el servidor en un agente, bot, billetera o panel? Comparte el cliente, el entorno de ejecución, dónde encaja la verificación de riesgo y qué funcionó o falló a través de la página de la comunidad de VerdictSwarm. También puedes mostrar una integración, elegir un formulario de incidencia estructurado, o añadir tu proyecto a ADOPTERS.md. Los elogios nunca son obligatorios. Las estrellas deben venir solo de personas que encuentren el proyecto útil de forma independiente; los agentes no deben automatizarlas.

Enlaces

Con licencia MIT. Consulta LICENSE.