TrustBench

@trustbench/mcp

Servidor MCP nativo para TrustBench — uma camada de roteamento e auditoria não custodial para pagamentos de agentes x402.

Adiciona três ferramentas somente leitura a qualquer host compatível com MCP:

Ferramenta	O que faz
get_rankings	Lista de provedores x402 pontuados por capacidade. Sem chave de API.
get_receipt	Busca qualquer recibo TrustBench por ID (rcpt_… / rrcpt_…). Sem chave de API.
verify_receipt	Confirma assinatura Ed25519 + status on-chain. Dois modos: consulta por ID ou verificação offline de um JSON de recibo. Sem chave de API.

Funciona em Claude Desktop, Claude Cowork, Grok (xAI Connectors), Kimi Code CLI, Cherry Studio, Cursor e qualquer host compatível com MCP.

Configuração

Adicione ao arquivo de configuração MCP do seu host (ex.: claude_desktop_config.json para Claude Desktop, ~/.kimi/mcp.json para Kimi):

{
  "mcpServers": {
    "trustbench": {
      "command": "npx",
      "args": ["-y", "@trustbench/mcp"]
    }
  }
}

Reinicie o aplicativo do host. As três ferramentas acima ficam disponíveis imediatamente — sem chave de API, sem necessidade de conta.

Variáveis de ambiente

Variável	Padrão	Descrição
TRUSTBENCH_BASE_URL	https://trustbench.io	Substitui a base da API (útil para desenvolvimento local).

O que as ferramentas retornam

get_rankings — Array JSON de provedores pontuados para a capacidade solicitada. Capacidades: search, inference, data, media, infra. As pontuações são derivadas de verificações de atividade via sonda HEAD (3 amostras de um host). Consulte trustbench.io/methodology para a fórmula completa de pontuação.

get_receipt — Envelope completo de recibo assinado. Recebidos são imutáveis após a emissão. IDs da Fase 3 começam com rcpt_, recibos de roteamento da Fase 4 começam com rrcpt_.

verify_receipt — Dois modos (forneça exatamente uma entrada):

• Modo consulta (receipt_id) — busca o recibo de trustbench.io e reexecuta a verificação Ed25519 + on-chain. Útil quando o agente tem apenas um ID.
• Modo offline (receipt_json) — verifica um envelope completo {receipt, signature} que um agente recebeu de terceiros contra a chave pública publicada, sem confiar no banco de dados. O caminho do verificador terceirizado.

Ambos os modos retornam um resumo JSON com signature_valid (booleano), on_chain_verified (booleano quando aplicável), signature_alg (ed25519) e pubkey_url. Para verificação sem rede, sem ida e volta ao TrustBench, use o pacote npm @trustbench/verify-receipt em vez disso.

Ferramentas de roteamento (v1.5)

route_quote e route_settle (o fluxo de roteamento pago) exigem uma chave de API tb_live_… e serão lançadas na próxima versão. Solicite acesso enviando DM para @TrustBench no X.

Detalhes técnicos

• Transporte: stdio (JSON-RPC 2.0) — o padrão MCP
• Sem dependências externas além dos módulos nativos do Node.js
• Node ≥ 18 necessário (usa fetch e readline nativos)
• Código-fonte: github.com/lithvall/TrustBench

Pacotes relacionados

• @trustbench/verify-receipt — verificador offline autônomo de recibos Ed25519