Attester Oracle

attester-mcp

适用于 attester.dev 的 MCP 服务：为 AI Agent 提供验证和 API 存在性判定工具，可从任何 MCP 客户端（Claude Code、Cursor、Windsurf、LangChain、CrewAI）调用。

每个结果都附带钱包签名的证明，你无需信任我们即可自行验证：POST https://attester.dev/receipts/verify 免费。

快速入门：免费判定工具，无需密钥

无需安装。将 MCP 客户端指向托管端点：

{
  "mcpServers": {
    "attester": {
      "url": "https://attester.dev/mcp/"
    }
  }
}

四种判定工具可立即使用：无需账户、API 密钥或钱包。每个客户端 IP 每天可免费调用 25 次，四种工具共享额度，每天 00:00 UTC 重置。（此配置块适用于 Claude Code、Claude Desktop 和 Cursor；也适用于任何支持可流式 HTTP 的 MCP 客户端。）

工具	功能	每次调用价格
attester_package_exists	这个 PyPI/npm 包名确实存在吗？未找到时会标记与其名称相近的拼写抢注包。	免费（无密钥时每天 25 次）；付费 $0.002
attester_symbol_exists	这个函数、类或常量在包中存在吗？未找到时会提供最接近的匹配建议。	免费（无密钥时每天 25 次）；付费 $0.005
attester_symbol_signature	精确签名、结构化参数、文档字符串、弃用状态，均在指定版本解析。	免费（无密钥时每天 25 次）；付费 $0.01
attester_version_diff	两个指定版本之间的符号级差异：新增、移除、变更，以及破坏性／增量性／中性变更。	免费（无密钥时每天 25 次）；付费 $0.02

改为在本地运行（stdio）：运行 pip install git+https://github.com/maminihds/attester-mcp.git 从源代码安装，然后在上面的配置中使用 "command": "attester-mcp"。软件包发布到 PyPI 后即可使用无需安装的 uvx attester-mcp 命令。

引导你的 Agent：CLAUDE.md / Cursor Rules 片段

- Before installing or importing a package, call attester_package_exists (and attester_symbol_exists for specific functions) to confirm the name exists. Never import a name the oracle says does not exist.

付费工具

工具	功能	每次调用价格
oracle_verify_work	检查其他 Agent 的工作：引文支持、代码正确性、数据／架构验证。返回判定结果和签名证明。	$0.15 USDC
oracle_code_research	带引文的编码研究；会重新检查引文并附上证明。	$0.10 USDC
oracle_judge	根据你的评分标准对输出评分；返回带签名的分数及每项标准的证据。	$0.10 USDC
oracle_watchtower_report	提供已签名的 24 小时报告，说明某项 x402 服务是否遵守其公开报价。	$0.05 USDC
oracle_spend_check	付款前检查交易对手：你的 Agent 应该向这个地址付款吗？	$0.005 USDC

付款方式有两种：

• 预付额度（个人用户，无需加密货币）： 通过 此 Stripe 链接购买价值 $5 的额度包，访问 https://attester.dev/credits/claim?session_id=cs_... 兑换一次性密钥 att_live_...，并在服务环境中设置 ATTESTER_API_KEY=att_live_...。每次付费调用都会从余额中扣除。使用密钥访问 GET https://attester.dev/credits/balance 可查看余额。 （CREDITS_API_KEY 仍可用作别名。）免费判定工具也支持此密钥：演示路由会跳过每日额度限制，且不会扣费。
• x402（持有钱包的 Agent）： 将 BUYER_PRIVATE_KEY 设置为持有 USDC 的 Base 钱包私钥。封装器会自动按次付款（402、签名、重试），并将钱包地址作为 X-Payer 发送，由此为付费端点的免费额度计数。

如果未提供任何密钥，付费端点会返回 HTTP 402，并在响应正文中提供付款条款。

Agent 技能包（skills/attester）

同一套 API 封装为 Agent Skill，可供 Agent 配置作为默认工具加载：包含使用时机规则、每个端点对应的精确 curl 命令（判定检查使用无密钥的 /demo/v1/* 免费路径，其余端点使用 X-Payer 免费额度）、判定结果解读和回执验证。

安装方式：

# Claude Code
/plugin marketplace add maminihds/attester-mcp

# skills.sh CLI (Claude Code, Cursor, Codex, 30+ agents)
npx skills add maminihds/attester-mcp

# OpenClaw (manifestless Claude bundle)
openclaw plugins install https://github.com/maminihds/attester-mcp

也可以手动将 skills/attester/ 复制到 ~/.claude/skills/。该技能包包含一个辅助脚本（skills/attester/scripts/call.py，使用标准库和 httpx）以及两个完整示例记录，位于 skills/attester/examples/。

从源代码安装

pip install -r requirements.txt
python server.py            # stdio (default, for agents)
python server.py --http     # streamable-http on :8100

环境变量：

• SERVER_URL：API 基础 URL，默认为 https://attester.dev。
• ATTESTER_API_KEY：预付费额度密钥（att_live_...），可选。
• BUYER_PRIVATE_KEY：用于 x402 付款的 Base 钱包，可选。

客户端示例

examples/plain_python.py：使用官方 SDK 直接调用并通过 x402 付款。 examples/langchain_example.py：LangChain 工具包装器。

链接

• 网站：https://attester.dev
• OpenAPI：https://attester.dev/openapi.json
• llms.txt：https://attester.dev/llms.txt
• 目录列表：https://x402-list.com/services/attester-verification-oracle-verified-research