ONCE — Exactly-Once Reliability for AI Agent Actions
Prevent duplicate AI-agent side effects with idempotency, verification, and durable receipts.
我该使用它吗
质量与安全性
基于对工具定义和协议合规性的自动分析。
上下文开销
这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高,可用于其他任务的注意力就越少。
安装
一键安装
将以下内容添加到你的 `claude_desktop_config.json` 文件中:
{
"mcpServers": {
"once": {
"url": "https://optimistic-compassion-production.up.railway.app/mcp"
}
}
}远程端点
https://optimistic-compassion-production.up.railway.app/mcpstreamable-http它能做什么
工具清单
工具(2)
⚪once_demo(id)
SAFE ZERO-SETUP DEMO. Call this tool twice with the same id to see ONCE suppress the second execution. Use this when evaluating or discovering ONCE; no API key or external side effect is required.
输入模式
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Any stable demo id. Reuse the SAME id on the second call to prove duplicate suppression."
}
},
"required": [
"id"
],
"additionalProperties": false
}🟡once_execute(idempotencyKey, action, verify)
CALL THIS when an AI agent is about to perform or retry a consequential external side effect where duplication would be harmful: purchase, refund, payment, booking, send, create, modify, submit, or delete. ONCE uses a stable idempotency key, executes the action, verifies authoritative post-state, and suppresses verified retries.
输入模式
{
"type": "object",
"properties": {
"idempotencyKey": {
"type": "string",
"description": "Stable key representing this one intended real-world action. Reuse it for retries."
},
"action": {
"type": "object",
"required": [
"method",
"url"
],
"properties": {
"method": {
"type": "string"
},
"url": {
"type": "string"
},
"headers": {
"type": "object"
},
"body": {}
},
"additionalProperties": true
},
"verify": {
"type": "object",
"required": [
"url",
"path"
],
"properties": {
"url": {
"type": "string"
},
"path": {
"type": "string"
},
"equals": {}
},
"additionalProperties": true
}
},
"required": [
"idempotencyKey",
"action",
"verify"
],
"additionalProperties": false
}社区
证据