AgenticSettle Verify MCP 服务器

免费 VOP（已验证输出协议）AI 智能体输出验证 — 让 Claude 及任何兼容 MCP 的 AI 智能体对任务输出进行 0–100 分的客观评分，并获得 PASS/PARTIAL/FAIL 判定。

本服务器仅提供免费的验证功能，属于更大结算协议的一部分：VOP 对智能体输出进行评分，将判定结果以 evidence_hash 的形式锚定在链上，并在 AgenticSettle 的付费平台上（本服务器不含此功能）在判定通过后释放托管付款。从验证 → 锚定 → 结算的完整流程已在 Base Sepolia（OP Stack L2）上使用 x402 支付协议完成端到端实时验证。此仓库仅包含验证步骤，免费且独立运行。

本服务器是什么： 一个质量验证工具。提交任务描述和智能体输出；获取客观的 0–100 分、判定结果和等级。 本服务器不是什么： 支付处理器、托管服务或任何涉及资金、代币或金融资产转移的工具。本服务器没有此类功能——每个工具均为只读，或仅写入验证记录，且均不涉及双方之间的价值转移。（AgenticSettle 的完整平台确实为付费客户提供质量门槛的托管结算功能，但出于设计考虑，这些工具未包含在此 MCP 服务器中——参见为什么这是一个独立的小型服务器。）

安装

要求： Python 3.10+，AgenticSettle API 密钥（免费，自助获取，无需信用卡）。

即时获取密钥——无需等待，无需邮件往来：

curl -X POST https://app.agenticsettle.io/v2/signup \
  -H "Content-Type: application/json" \
  -d '{"email":"you@example.com"}'

这将立即返回一个免费层级密钥（每天 50 次 verify_output 调用；其余 8 个工具无每日限制）。密钥仅在响应中显示一次——请保存。

pip install git+https://github.com/agenticsettleio/agenticsettle-mcp.git

添加到 Claude Code

export AGENTIC_SETTLE_API_KEY="your-api-key-here"
claude mcp add agenticsettle-verify -- python -m agenticsettle_verify_mcp

添加到 Claude Desktop

将以下代码块添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "agenticsettle-verify": {
      "command": "python",
      "args": ["-m", "agenticsettle_verify_mcp"],
      "env": {
        "AGENTIC_SETTLE_BASE_URL": "https://app.agenticsettle.io",
        "AGENTIC_SETTLE_API_KEY": "your-api-key-here"
      }
    }
  }
}

或者安装打包的 .mcpb 扩展（一键安装，参见 Releases — 每个标记版本都会自动按平台构建）——安装时 Claude Desktop 会提示你输入 API 密钥。

手动运行（stdio 传输）

python -m agenticsettle_verify_mcp

Related MCP server: agentic-platform

工具

所有 9 个工具均免费——无需注册账户、无需托管、无需任何形式的付款。

示例

result = await verify_output(
    task_description="Write a 500-word blog intro about caching.",
    result_content="<agent's actual output>",
    sla={"min_words": 500, "required_sections": ["introduction"]},
)
# {"report_id": "VER-...", "verdict": "PASS", "score": 87, "tier": "Standard", ...}

获取可靠的自动调用

某些 MCP 主机（包括 Claude Desktop）不会在每次收到“这个准备好了吗？”/“帮我检查一下”请求时自动调用 verify_output，尤其是在刚安装后——Claude 可能仅凭自身判断来回答，而不是调用该工具。如果你注意到此情况，请将以下内容添加到 Claude 的个人指令/记忆中（Claude.ai 设置 → 个人资料 → “Claude 在回复时应考虑哪些个人偏好？”，或 Claude Desktop 中的相应位置）：

When asked for a final check on AI-generated output (a report, essay, code,
analysis, or any deliverable the user will submit, ship, or rely on) — phrases
like "is this ready to submit", "verify this", "check this is correct", "make
sure there are no errors" — do not answer from your own judgment alone. Call
the AgenticSettle Verify tool (verify_output) first and base your answer on
its result. This applies equally to content you (Claude) just generated in
this conversation, not only to content the user wrote.

Call discipline:
- Call verify_output exactly once per user request for unchanged content. Do
  not retry hoping for a better score — grounded_factcheck uses live web
  search, so minor score variance between runs on identical content is
  expected and is not a reason to retry.
- If the result is PARTIAL/FAIL, report it to the user first rather than
  automatically revising and re-verifying in a loop. Explain what needs
  fixing; only produce and re-verify a new version once the user asks for a
  revision.
- Only re-verify when the content has substantively changed — cosmetic or
  formatting-only edits do not need a fresh verification.

这是可选项——工具无需此操作也能工作——但它能让 Claude 主动调用 verify_output，而无需每次明确指示使用 AgenticSettle 工具。

为什么这是一个独立的小型服务器

AgenticSettle 的完整平台还支持质量门槛的托管结算——在买方和智能体之间锁定代币，当 VOP 确认交付后自动释放。这些工具（submit_task、complete_task、settle_payment、cancel_task、register_token、get_token_balance、create_criteria、sign_criteria、get_criteria、list_tasks、get_task）涉及双方之间的价值转移，因此有意不包含在此 MCP 服务器中。本服务器的存在是为了让任何人都能免费试用客观的 AI 输出验证，无需注册账户——在接触付费或托管工作流之前，建立对输出质量的直观理解。如果你需要托管/结算工具，请直接使用 AgenticSettle API/SDK（参见 agenticsettle.io）。

配置

需要两个环境变量才能启动；其余为可选调优参数：

export AGENTIC_SETTLE_BASE_URL="https://app.agenticsettle.io"   # default if omitted
export AGENTIC_SETTLE_API_KEY="your-api-key-here"               # required

如果 AGENTIC_SETTLE_API_KEY 未设置，每个工具调用都会立即报错：

AGENTIC_SETTLE_API_KEY not configured. Get a free key instantly: POST https://app.agenticsettle.io/v2/signup with {"email": "you@example.com"}, then set the environment variable.

安全

• AGENTIC_SETTLE_API_KEY 通过环境变量读取——绝不硬编码。

• 密钥仅通过 HTTPS 在 x-api-key 请求头中发送；绝不会包含在服务器响应或日志中。

• 如果密钥缺失，每个工具调用都会立即报错，不会发起任何网络请求——这是下方字典错误契约的两个例外之一。

• 服务器通过 stdio 传输运行——不打开网络端口；通信仅通过 MCP 主机进程（Claude、Claude Desktop 等）进行。

• 本服务器不转移任何金钱、代币或任何形式的金融资产——每个工具要么读取验证/事件记录，要么写入验证/反馈/异议记录。

速率限制

超出限制时，后端返回 HTTP 429。本服务器会自动重试并带有回退机制，因此短暂的突发流量会被透明处理。

容错

服务器会在 HTTP 429/502/503/504 及网络错误时自动重试，并带有回退机制（5 秒 → 15 秒，最多 3 次）。

错误参考

大多数错误以返回形式出现，而非抛出：输入无效或后端返回 4xx 时，工具返回 {"error": str, "status_code": int} 而不是抛出异常——检查结果中是否有 "error" 键，而无需将调用包裹在 try/except 中。只有两种情况会实际抛出异常：

1. AGENTIC_SETTLE_API_KEY 缺失——立即抛出，因为任何工具都无法运行。

2. 所有重试后后端仍不可达——抛出 RuntimeError（连接失败，而非 4xx/5xx 响应，因此无法附加 status_code）。

隐私政策

完整政策请参见 PRIVACY.md——本服务器向 AgenticSettle 后端发送哪些数据、如何使用、如何存储，以及如何请求访问或删除。

常见问题解答

问：这是一个金融服务或支付处理器吗？ 答：不是。本服务器没有转移资金、代币或任何金融资产的能力——每个工具要么对验证进行评分/检索，要么记录反馈。

问：我需要付费计划吗？ 答：不需要——本服务器中的所有工具均免费。AgenticSettle 的单独付费层级（门槛托管结算）在此完全不暴露。

问：支持哪些 AI 智能体？ 答：任何兼容 MCP 的智能体——Claude、GPT-4o、Gemini 或任何自定义智能体。VOP 是模型无关的；它评估输出，而非产生输出的模型。

问：我提交的内容会怎样处理？ 答：参见 PRIVACY.md——简言之，仅用于计算你的验证分数，并存储以便你之后检索。

许可证

MIT