@verifiedstate/mcp

Name: verifiedstate-mcp
Author: verifiedstate

Offizielle MCP-Brücke für VerifiedState – verbinden Sie Claude Code, Cursor, Windsurf und andere MCP-Clients mit verifiziertem Speicher und dem Proof Meter.

Dieses Paket führt einen lokalen stdio-MCP-Server aus, der Tool-Aufrufe an den gehosteten Endpunkt weiterleitet. Ihr API-Schlüssel verlässt Ihren Computer niemals, außer als Authorization: Bearer an VerifiedState.

Gehosteter MCP-Server

Element	Wert
MCP-URL	`https://mcp.verifiedstate.ai/mcp`
Discovery (Agent Card)	`https://mcp.verifiedstate.ai/.well-known/agent-card.json`
Dashboard & Schlüssel	verifiedstate.ai · API-Schlüssel

Clients, die Remote-HTTP-MCP unterstützen, können direkt auf die oben genannte URL verweisen und Folgendes senden:

Authorization: Bearer vs_live_...

Tools (13)

Tool	Beschreibung
`memory_ingest`	Inhalte in den verifizierten Speicher aufnehmen; gibt `artifact_id` zurück.
`memory_query`	Semantische Suche über verifizierten Speicher mit bewerteten Behauptungen und Belegen.
`memory_verify`	Überprüfung einer Behauptung durchführen; erzeugt einen signierten Beleg.
`memory_health`	Namespace-Integrität: Anzahl, Verifizierungsverhältnis, veraltet/abgelaufen, Konflikte.
`meter_authorize`	Erstellen einer Proof-Meter-Berechtigung mit einem Ausgabenbudget.
`meter_spend`	Ausgaben für eine Berechtigung aufzeichnen; gibt einen Hash-verketteten Beleg zurück.
`meter_budget`	Verbleibendes Budget und Ausgabenzusammenfassung für eine Berechtigung.
`meter_settle`	Belege in einem Merkle-verwurzelten Batch abrechnen.
`meter_verify`	Einen Ausgabenbeleg kryptografisch verifizieren.
`meter_receipts`	Ausgabenbelege für einen Namespace auflisten und filtern.
`session_save`	Sitzungsstatus beibehalten (Zusammenfassung, Dateien, Entscheidungen, nächste Schritte).
`session_load`	Die zuletzt gespeicherte Sitzung für ein Projekt laden.
`session_end`	Sitzung mit optionaler Zusammenfassung beenden (Sitzungen werden auch automatisch gespeichert).

Installation

npm install @verifiedstate/mcp

Oder ohne Installation verwenden:

npx -y @verifiedstate/mcp

Umgebung

Variable	Erforderlich	Beschreibung
`VERIFIEDSTATE_API_KEY`	Ja (für `tools/call`)	API-Schlüssel von verifiedstate.ai/keys
`VERIFIEDSTATE_NAMESPACE_ID`	Nein	Standard-`namespace_id`, die in Tool-Argumente eingefügt wird, wenn sie weggelassen wird

MCP-Konfiguration

Cursor

Fügen Sie dies zu Ihrer MCP-Konfiguration hinzu (z. B. Cursor Settings → MCP) und ersetzen Sie den Platzhalter-Schlüssel:

{
  "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

Gleiche Struktur wie bei Cursor – in Ihre Claude Code MCP-Konfiguration einfügen:

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

Windsurf

Verwenden Sie den entsprechenden MCP-Server-Eintrag in der Konfiguration von Windsurf (stdio-Befehl + env):

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

Remote HTTP (falls Ihr Client dies unterstützt)

Verweisen Sie den Client auf https://mcp.verifiedstate.ai/mcp und konfigurieren Sie die Bearer-Authentifizierung mit Ihrem API-Schlüssel. Die genaue JSON-Struktur hängt vom Produkt ab; lesen Sie in der Dokumentation Ihres Clients unter „Remote MCP“ oder „SSE/HTTP MCP“ nach.

Programmatischer Konfigurationshelfer

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

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

Lizenz

MIT – siehe LICENSE.

Mitwirken

Siehe CONTRIBUTING.md.

verifiedstate-mcp