Skip to main content
Glama
MSMD-RUA

agenticrail-mcp

agenticrail-mcp

一个 Model Context Protocol 服务器,将实时的 AgenticRail 执行门以两个工具的形式暴露给任何 MCP 客户端。

AgenticRail 是面向 AI 代理的确定性执行层:它让代理严格遵守其声明的步骤顺序,拒绝重放和跳过的步骤,并用签名回执封存每个已完成的序列。本服务器就是它前面的 MCP 适配器。

端点: https://mcp.agenticrail.nz/(Streamable HTTP,无状态) 协议: 2026-07-28 — 该修订版废弃了 initialize 交换和 Mcp-Session-Id。本服务器以无状态方式构建,两者均未使用,因此无需迁移。对于较旧的客户端,initialize 仍会得到响应。 注册表: 官方 MCP 注册表 上的 nz.agenticrail/gate

工具

工具

作用

调用

evaluate_step

在单个代理步骤运行前给出 ALLOW/DENY;封存签名回执

POST https://api.agenticrail.nz/v1/evaluate

verify_receipt

获取序列的验证报告;确认回执链完整

POST https://report.agenticrail.nz/report

在运行序列的每个步骤之前调用 evaluate_step,并且不要运行门拒绝(DENY)的步骤。

DENY 会告诉你如何修复

每次拒绝都会在响应信封中携带其自身的补救措施——未签名、仅限 DENY,因为它描述的是序列当前的状态,而非已做出的决定:

拒绝类型

返回内容

ACTION_NOT_ALLOWED

allowed_action_types — 该步骤本可接受的精确类型

SEQUENCE_VIOLATION

next_expected_step — 序列正在等待的步骤

STEP_ORDER_MISMATCH

locked_step_order — 该序列在首次调用时被锁定的顺序

UNKNOWN_STEP

expected_step_order + step_order_source(caller 或 msmd_spine)

action_type 是一个包含八个值的枚举,每个步骤只接受其中一部分——合规的客户端无法构造出无效值。step_order 在首次调用时被锁定,且至少需要一个条目;省略它会选择内置的 MSMD 主干,而不是清除锁定,因此要更改计划,请启动一个新的 sequence_id。

Related MCP server: Proof Layer MCP

连接

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

任何 Streamable-HTTP MCP 客户端都可以使用——将其指向该 URL 即可。

无需安装任何东西即可试用

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 .

在没有 Authorization 头的情况下,会使用公共演示密钥,你的 sequence_id 会被重写为 demo-mcp-<your id>——demo- 标记公共通道,mcp- 标记其为匿名 MCP 流量。此后请使用响应中返回的 id;你发送的那个将无法解析。 这是有意为之,并非泄露。

demo- 序列的报告无需密钥即可读取,因此请将你在其上发送的任何内容视为公开信息。

设计——修改前请阅读

  • 仅协议适配器。 此 worker 不持有任何内部机密,也没有通往执行核心的特权路径。它调用与外部调用者相同的公共 API,因此工具逻辑与 AgenticRail 的内部实现以及 MCP 传输版本解耦。

  • 服务绑定,而非 fetch。 mcp.agenticrail.nz 与 api. 和 report. 位于同一区域,因此普通的 fetch() 将是同区域回环(Cloudflare 错误 1002)。绑定访问的是相同的公共处理器——它们不是内部绕过。

  • 无状态 Streamable HTTP。 不签发也不要求 Mcp-Session-Id;每个 POST 都是自包含的。传输外壳是 handleRpc + fetch 处理器——这是规范修订唯一会触及的部分。承载价值的调用(callEvaluate / callVerify)是普通 HTTPS,不会改变。

  • GET / 提供发现卡片;所有其他 GET 路径返回 404。 POST 有意保持宽松,以便在端点 URL 后附加路径的客户端仍然可以工作。

  • /.well-known/oauth-* 返回 404 是正确的——这是 MCP 服务器表示无需认证的方式。agent.json、agent-card.json、x402 和 ai-plugin.json 是本服务器未实现的协议;响应它们将是一种声明。

部署

npx wrangler deploy

链接


由 TUARA KURI LIMITED(NZBN 9429053582867)运营,Hokianga,Aotearoa 新西兰。

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    C
    maintenance
    Provides tools to issue, verify, and export cryptographically signed receipts for AI agent actions, enabling tamper-proof audit trails for compliance with regulations like the EU AI Act.
    4
    26 npm
    1
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Provides cryptographic governance receipts for AI agents, enabling pre-execution evaluation and signed verdicts (EXECUTE/BLOCK/REVIEW/SHADOW) with offline-verifiable audit trails.
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Issue and verify signed receipts for agent actions, enabling durable, independently checkable proof of policy decisions. Supports offline verification via get_keyset and verify_receipt tools without an account.
    0
    Inno Setup
  • A
    license
    Not graded
    quality
    B
    maintenance
    Provides permission gates and tamper-evident audit logging for AI agent tool executions, with declarative policies, consent ladders, and hash-chained verification.
    MIT