agentpay-sentinel-mcp

AgentPay Sentinel MCP

一个看门狗 MCP，会在每次 Agent 支付请求执行前，针对全部 9 项安全检查进行验证，及时发现策略违规、重放攻击、金额篡改、令牌撤销和预算超支。

Agent 可以执行的操作

• 在执行任何支付交易前进行预检审计，并获取 PASS 或 BLOCKED 结果以及未通过的具体检查项
• 验证令牌完整性：确认 SHA-256 哈希与预期的 merchant_id:amount 绑定相符，从而发现伪造或篡改的令牌
• 执行预算上限检查：拒绝 current_spend + amount > budget_cap 的交易，并返回确切的剩余预算
• 检查商家是否在允许名单中，并阻止购买受限类别的商品
• 在支付发起前验证令牌是否过期以及是否超出速率限制
• 模拟已知攻击途径（令牌伪造、预算超限、重放攻击、商家冒充、绕过过期检查），并获取每种攻击对应的具体防御机制和检测方法

安装

要求： Python 3.10+、mcp 包。

pip install mcp

Claude Desktop — 添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "agentpay-sentinel": {
      "command": "python",
      "args": ["/absolute/path/to/agentpay-sentinel-mcp/server.py"]
    }
  }
}

Cursor — 添加到项目根目录下的 .cursor/mcp.json：

{
  "mcpServers": {
    "agentpay-sentinel": {
      "command": "python",
      "args": ["/absolute/path/to/agentpay-sentinel-mcp/server.py"]
    }
  }
}

工具参考

工具	描述	关键参数
sentinel_audit_transaction	执行全部 9 项安全检查；返回 PASS/BLOCKED 及 SHA-256 审计哈希	token_hash、merchant_id、amount、current_spend、budget_cap（必需）· nonce、token_id、approved_amount（启用检查 7–9）
sentinel_revoke_token	永久撤销令牌——此后所有使用该 token_id 的审计都会返回 BLOCK	token_id、reason
sentinel_clear_nonce	从重放存储中移除 nonce（仅用于合法退款/重试）	nonce
sentinel_verify_chain	验证一系列审计哈希是否构成完整的哈希链	audit_hashes、expected_chain_root
sentinel_threat_model	模拟指定的任意攻击途径；返回严重性、防御方式和检测方法	attack_vector、context

sentinel_audit_transaction 执行的全部 9 项检查

#	检查项	检测内容	参数
1	令牌完整性	SHA-256 哈希不匹配——令牌伪造	token_hash
2	预算执行	支出超出上限	current_spend、budget_cap
3	商家允许名单	向名单外的商家付款	allowlist
4	类别限制	在屏蔽的类别中购买	blocked_categories
5	过期检查	令牌已过期	expires_at
6	速率限制	每分钟调用次数过多	calls_this_minute
7	金额不匹配	Agent 在人工批准后更改金额	approved_amount
8	重放攻击	同一 nonce 被使用两次（基于文件的存储）	nonce
9	规避撤销	Agent 使用已撤销的令牌	token_id

传入对应参数后会启用检查 7–9。状态会持久化到 ~/.sentinel/。

sentinel_threat_model 支持的攻击途径

token_forgery · budget_overflow · replay_attack · amount_mismatch · revocation_evasion · merchant_spoof · expiry_bypass

安全性

sentinel_audit_transaction 返回的是建议性判定，不会拦截网络流量。Agent 负责在执行支付前调用此工具，并在结果为 BLOCKED 时停止操作。返回的审计哈希是所有检查结果的 SHA-256 摘要，可为每次预检决策提供防篡改记录。

定价

方案	价格	包含内容
Free	$0	每月 50 次审计
Pro	$19/月	无限次审计 + 威胁模型模拟

升级到 Pro

License

MIT — AgentPay Labs. Source: github.com/Rumblingb/agentpay-sentinel-mcp