@verifiedstate/mcp

Name: verifiedstate-mcp
Author: verifiedstate

Puente MCP oficial para VerifiedState: conecta Claude Code, Cursor, Windsurf y otros clientes MCP a la memoria verificada y a Proof Meter.

Este paquete ejecuta un servidor MCP stdio local que redirige las llamadas a herramientas al endpoint alojado. Tu clave API nunca sale de tu máquina, excepto como Authorization: Bearer hacia VerifiedState.

Servidor MCP alojado

Elemento	Valor
URL de MCP	`https://mcp.verifiedstate.ai/mcp`
Descubrimiento (Tarjeta de agente)	`https://mcp.verifiedstate.ai/.well-known/agent-card.json`
Panel de control y claves	verifiedstate.ai · Claves API

Los clientes que admiten MCP HTTP remoto pueden apuntar directamente a la URL anterior y enviar:

Authorization: Bearer vs_live_...

Herramientas (13)

Herramienta	Descripción
`memory_ingest`	Ingiere contenido en la memoria verificada; devuelve `artifact_id`.
`memory_query`	Búsqueda semántica sobre la memoria verificada con afirmaciones y recibos clasificados.
`memory_verify`	Ejecuta la verificación de una afirmación; produce un recibo firmado.
`memory_health`	Estado del espacio de nombres: recuentos, ratio de verificación, obsoletos/caducados, conflictos.
`meter_authorize`	Crea una capacidad de Proof Meter con un presupuesto de gasto.
`meter_spend`	Registra un gasto contra una capacidad; devuelve un recibo encadenado por hash.
`meter_budget`	Presupuesto restante y resumen de gastos para una capacidad.
`meter_settle`	Liquida recibos en un lote con raíz Merkle.
`meter_verify`	Verifica criptográficamente un recibo de gasto.
`meter_receipts`	Lista y filtra los recibos de gasto para un espacio de nombres.
`session_save`	Persiste el estado de la sesión (resumen, archivos, decisiones, próximos pasos).
`session_load`	Carga la última sesión guardada para un proyecto.
`session_end`	Finaliza la sesión con un resumen opcional (las sesiones también se guardan automáticamente).

Instalación

npm install @verifiedstate/mcp

O úsalo sin instalar:

npx -y @verifiedstate/mcp

Entorno

Variable	Requerido	Descripción
`VERIFIEDSTATE_API_KEY`	Sí (para `tools/call`)	Clave API de verifiedstate.ai/keys
`VERIFIEDSTATE_NAMESPACE_ID`	No	`namespace_id` predeterminado inyectado en los argumentos de la herramienta cuando se omite

Configuración de MCP

Cursor

Añádelo a tu configuración de MCP (ej. Cursor Settings → MCP), reemplazando la clave de marcador de posición:

{
  "mcpServers": {
    "verifiedstate": {
      "command": "npx",
      "args": ["-y", "@verifiedstate/mcp"],
      "env": {
        "VERIFIEDSTATE_API_KEY": "vs_live_YOUR_KEY_HERE",
        "VERIFIEDSTATE_NAMESPACE_ID": "optional-default-namespace-uuid"
      }
    }
  }
}

Claude Code

La misma estructura que Cursor: combínalo en tu configuración de MCP de Claude Code:

{
  "mcpServers": {
    "verifiedstate": {
      "command": "npx",
      "args": ["-y", "@verifiedstate/mcp"],
      "env": {
        "VERIFIEDSTATE_API_KEY": "vs_live_YOUR_KEY_HERE"
      }
    }
  }
}

Windsurf

Usa la entrada de servidor MCP equivalente en la configuración de Windsurf (comando stdio + env):

{
  "mcpServers": {
    "verifiedstate": {
      "command": "npx",
      "args": ["-y", "@verifiedstate/mcp"],
      "env": {
        "VERIFIEDSTATE_API_KEY": "vs_live_YOUR_KEY_HERE"
      }
    }
  }
}

HTTP remoto (si tu cliente lo admite)

Apunta el cliente a https://mcp.verifiedstate.ai/mcp y configura la autenticación Bearer con tu clave API. La estructura JSON exacta depende del producto; consulta la documentación de tu cliente para "MCP remoto" o "SSE/HTTP MCP".

Ayudante de configuración programática

import { getConfig } from '@verifiedstate/mcp';

const config = getConfig('vs_live_...', 'optional-namespace-id');
// => { mcpServers: { verifiedstate: { command, args, env } } }

Licencia

MIT: consulta LICENSE.

Contribución

Consulta CONTRIBUTING.md.

verifiedstate-mcp