agenticrail-mcp

Ein Model Context Protocol-Server, der das Live-AgenticRail-Enforcement-Gate als zwei Tools für jeden MCP-Client bereitstellt.

AgenticRail ist eine deterministische Enforcement-Schicht für KI-Agenten: Sie hält einen Agenten an seine deklarierte Schrittfolge, verweigert Wiederholungen und übersprungene Schritte und versiegelt jede abgeschlossene Sequenz mit einer signierten Quittung. Dieser Server ist der MCP-Adapter davor.

Endpunkt: https://mcp.agenticrail.nz/ (Streamable HTTP, zustandslos) Protokoll: 2026-07-28 — die Revision, die den initialize-Austausch und Mcp-Session-Id zurückgezogen hat. Dieser Server wurde ohne beides zustandslos gebaut, daher war keine Migration nötig. initialize wird für ältere Clients weiterhin beantwortet. Registry: nz.agenticrail/gate im offiziellen MCP-Registry

Tools

Rufe evaluate_step vor jedem Schritt einer Sequenz auf und führe keinen Schritt aus, den das Gate mit DENY ablehnt.

Ein DENY sagt dir, wie du es beheben kannst

Jede Ablehnung trägt ihre eigene Abhilfe im Antwort-Envelope — unsigniert, nur bei DENY, weil sie den aktuellen Zustand der Sequenz beschreibt und nicht die getroffene Entscheidung:

action_type ist ein Enum mit acht Werten, und jeder Schritt akzeptiert nur eine Teilmenge — ein konformer Client kann keinen ungültigen Wert konstruieren. step_order wird beim ersten Aufruf festgelegt und benötigt mindestens einen Eintrag; das Weglassen wählt die eingebaute MSMD-Spine aus, anstatt die Sperre zu löschen. Um den Plan zu ändern, starte also eine neue sequence_id.

Related MCP server: Proof Layer MCP

Verbinden

# zero config — uses the public demo key
claude mcp add --transport http agenticrail https://mcp.agenticrail.nz/

# with your own key
claude mcp add --transport http agenticrail https://mcp.agenticrail.nz/ \
  --header "Authorization: Bearer <your-agenticrail-key>"

Jeder Streamable-HTTP-MCP-Client funktioniert — zeige ihn auf die URL.

Ausprobieren ohne Installation

BASE=https://mcp.agenticrail.nz/

curl -s -X POST "$BASE" -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | jq .

# ⚠️ Use a sequence_id nobody else will pick. On the shared demo key the id is
# GLOBAL and sealing is PERMANENT — a fixed one in an example works once for one
# person on earth and returns SEALED_SEQUENCE for everyone after.
SEQ="mcp-smoke-$(date +%s)-$RANDOM"

curl -s -X POST "$BASE" -H 'content-type: application/json' \
  -d "{\"jsonrpc\":\"2.0\",\"id\":2,\"method\":\"tools/call\",\"params\":{
        \"name\":\"evaluate_step\",
        \"arguments\":{\"sequence_id\":\"$SEQ\",\"step\":\"intake\",
                       \"action_type\":\"CHECK_STATE\"}}}" | jq .

Ohne Authorization-Header wird der öffentliche Demo-Schlüssel verwendet und deine sequence_id kommt umgeschrieben zurück als demo-mcp-<deine id> — demo- markiert die öffentliche Spur, mcp- markiert sie als anonymen MCP-Verkehr. Verwende ab dann die in der Antwort zurückgegebene ID; die von dir gesendete wird nicht aufgelöst. Das ist beabsichtigt, kein Leck.

Ein demo--Sequenzbericht benötigt keinen Schlüssel zum Lesen, also behandle alles, was du darüber sendest, als öffentlich.

Design — vor Änderungen lesen

• Nur Protokoll-Adapter. Dieser Worker enthält keine internen Geheimnisse und hat keinen privilegierten Pfad zum Enforcement-Kern. Er ruft dieselbe öffentliche API auf, die auch ein externer Aufrufer verwendet, sodass die Tool-Logik von den Interna von AgenticRail und von der MCP-Transportversion entkoppelt ist.

• Service-Bindings, kein fetch. mcp.agenticrail.nz liegt in derselben Zone wie api. und report., daher wäre ein einfaches fetch() ein Loopback innerhalb derselben Zone (Cloudflare-Fehler 1002). Die Bindings treffen dieselben öffentlichen Handler — sie sind kein interner Bypass.

• Zustandsloses Streamable HTTP. Es wird keine Mcp-Session-Id ausgestellt oder benötigt; jeder POST ist in sich abgeschlossen. Die Transportschale ist handleRpc + der fetch-Handler — der einzige Teil, den eine Spezifikationsrevision berührt. Die werttragenden Aufrufe (callEvaluate / callVerify) sind einfaches HTTPS und ändern sich nicht.

• GET / liefert die Discovery-Karte; jeder andere GET-Pfad gibt 404. POST ist absichtlich permissiv gelassen, damit ein Client, der einen Pfad an die Endpunkt-URL anhängt, weiterhin funktioniert.

• Ein 404 auf /.well-known/oauth-* ist korrekt — so sagt ein MCP-Server keine Authentifizierung erforderlich. agent.json, agent-card.json, x402 und ai-plugin.json sind Protokolle, die dieser Server nicht implementiert; sie zu beantworten wäre eine Behauptung.

Bereitstellen

npx wrangler deploy

Links

• Doku — https://agenticrail.nz/docs/

• Sequenz selbst verifizieren — https://report.agenticrail.nz/report

• OpenAPI — https://agenticrail.nz/openapi.json

• Enforcement-Spezifikation — https://agenticrail.nz/spec/

Betrieben von TUARA KURI LIMITED (NZBN 9429053582867), Hokianga, Aotearoa Neuseeland.