VerdictSwarm MCP

Combata IA com IA. 6 agentes de IA adversários debatem o risco de tokens cripto antes de seu agente negociar.

Documentação

Servidor VerdictSwarm MCP

O VerdictSwarm é uma camada de segurança pré-negociação para agentes que lidam com criptomoedas. Este servidor MCP expõe a API Verdict v2 como um pequeno conjunto de ferramentas somente leitura para verificação de tokens, triagem de saída sensível ao tamanho e descoberta de preços em tempo real.

Início rápido

Nenhuma configuração de conta é necessária. Se VS_API_KEY estiver ausente, o servidor gera uma chave gratuita na primeira chamada de ferramenta com suporte à API e a salva no diretório de configuração do usuário da plataforma.

uvx verdictswarm-mcp

Em seguida, pergunte ao seu cliente MCP: "Verifique DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263 na Solana no nível rápido."

Para fornecer uma chave existente gratuita ou com créditos:

VS_API_KEY=vs1_your_key uvx verdictswarm-mcp

Claude Desktop, Cursor, Windsurf e OpenClaw

Use esta entrada de servidor (o bloco env é opcional):

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

Sem VS_API_KEY, a chave autoprovisionada é armazenada em:

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

O arquivo é criado com permissões somente do usuário onde o sistema operacional suporta isso. Defina VS_CONFIG_DIR para substituir o diretório.

Ferramentas

Ferramenta	Descrição
`check_token(address, chain="solana", level="fast")`	Chama `POST /v2/verdict` e retorna ação, pontuação, resumo e os cinco sinais mais fortes. Os níveis são `triage`, `fast` e `deep`.
`exit_sim(address, size_usd, side)`	Solicita `include:["exit_sim"]` e retorna o bloco atualizado de simulação de saída da Solana. O lado é `buy` ou `sell`.
`get_pricing()`	Lê preços em tempo real, níveis, limites e blockchains suportados de `GET /v2/verdict/info`.

Os nomes 0.1.x scan_token, get_quick_score, check_rug_risk, get_token_report e verify_payment não são mais anunciados como ferramentas MCP; os clientes veem apenas as três ferramentas v2 atuais acima. Uma chamada explícita a um nome antigo ainda retorna uma resposta de migração e não faz nenhuma solicitação legada de via de pagamento.

Cota gratuita e estouro x402

Chaves gratuitas têm limites diários por nível anunciados pela API. Se um limite for esgotado, a resposta da ferramenta informa quando a cota é redefinida e preserva o desafio x402 completo. Para continuar imediatamente, defina VS_API_KEY para uma chave com créditos ou use as instruções de pagamento x402 retornadas.

O cliente MCP envia estes cabeçalhos de atribuição nas solicitações à API:

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

Configuração

Variável de ambiente	Padrão	Descrição
`VS_API_KEY`	não definido	Chave de API v2 opcional gratuita ou com créditos.
`VS_API_URL`	`https://api.vswarm.io`	URL base da API VerdictSwarm.
`VS_TIMEOUT`	`120`	Tempo limite da solicitação HTTP em segundos.
`VS_CONFIG_DIR`	diretório de configuração do usuário da plataforma	Diretório para a chave autoprovisionada.
`VS_TRANSPORT`	`stdio`	Transporte MCP. Use `streamable-http` para HTTP.
`HOST`	`0.0.0.0`	Host de vinculação HTTP.
`PORT`	`8000`	Porta de vinculação 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())

Desenvolvimento

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

O servidor suporta Python 3.10–3.13 e ambos os transportes stdio e HTTP.

Feedback e comunidade

Usou o servidor em um agente, bot, carteira ou painel? Compartilhe o cliente, o runtime, onde a verificação de risco se encaixa e o que funcionou ou falhou através da página da comunidade VerdictSwarm. Você também pode mostrar uma integração, escolher um formulário de problema estruturado, ou adicionar seu projeto a ADOPTERS.md. Elogios nunca são necessários. Estrelas devem vir apenas de pessoas que independentemente acham o projeto útil; agentes não devem automatizá-las.

Links

Licenciado sob MIT. Consulte LICENSE.