Agent Tools

Agent 工具

面向 Agent 的原生实用工具 API 套件。提供 9 个端点，同时支持 REST API 和 MCP 服务（streamable-http），并支持 x402 小额支付。现已上线：tools.beethoven2024.com。

面向 AI Agent（Claude、Cursor、自定义 Agent）： 将此 MCP 服务添加到配置中，即可立即使用 9 个实用工具。

面向开发者： 标准 REST API。以下任意子域名示例都可以作为可运行的样例。

立即试用

作为 MCP 服务（Claude、Cursor、Agent）

{
  "mcpServers": {
    "agent-tools": {
      "url": "https://tools.beethoven2024.com/mcp"
    }
  }
}

作为 REST API

curl https://tools.beethoven2024.com/health
# {"status":"ok","version":"0.1.0"}

curl "https://tools.beethoven2024.com/v1/dns/health?domain=example.com"
# Full DNS + mail security audit (requires x402 payment)

套件包含的内容

工具	端点	功能	价格
qr_generate	/v1/qr/generate	生成二维码（PNG/SVG，64–2048px）	$0.001
dns_health	/v1/dns/health	DNS 记录 + SPF/DMARC 邮件安全审计	$0.003
email_validate	/v1/email/validate	格式、MX、一次性邮箱域名、角色账户、SMTP 探测	$0.005
ip_lookup	/v1/ip/lookup	地理位置、ISP、代理/托管检测、反向 DNS	$0.005
url_health	/v1/url/health	状态码、重定向链、SSL 证书、响应时间	$0.003
whois_lookup	/v1/whois/lookup	注册商、创建/到期日期、名称服务器、状态	$0.005
headers_analyze	/v1/headers/analyze	HTTP 安全标头审计，提供 0–100 分评分（HSTS、CSP 等）	$0.003
extract_text	/v1/extract/text	从网页提取纯净文本（移除 HTML、导航栏、广告）	$0.005
tech_detect	/v1/tech/detect	网站技术栈——框架、CMS、CDN、分析工具	$0.005

免费： /health、/、/docs（OpenAPI），以及 MCP 协议方法 initialize / tools/list / ping。全部 9 个工具均需通过 MCP（tools/call）和 REST（/v1/*）使用 x402 支付。

为什么需要这些端点

每个端点都解决了 Agent 难以在本地完成的问题：

• 网络基础设施（DNS、WHOIS、标头、URL 健康状况、IP）——需要进行互联网探测，无法在进程内完成
• 专业解析（二维码、含 SMTP 的邮箱验证、技术检测）——特定领域的逻辑，不应由 Agent 重新实现
• 网页提取（文本提取）——从杂乱的 HTML 中提取纯净文本并不容易

9 个端点中有 8 个可完全自托管（上游 API 成本为零）。只有 IP 地理位置查询使用外部免费额度 API。

支付

x402（机器对机器小额支付）

如果请求未包含付款信息，每个付费端点都会返回 HTTP 402 Payment Required，并附带价格规格。支持 x402 的 Agent 会自动处理：

1. Agent 调用端点 → 收到包含 payment_requirements（网络、金额、收款地址）的 402 响应
2. Agent 为 Base 上的 USDC 签署 EIP-3009 transferWithAuthorization
3. Agent 在 X-PAYMENT 标头中附上支付信息后重试
4. 服务通过 facilitator 验证付款，执行请求并返回结果

结算在 Base 链上完成，确认时间不到 2 秒。

默认运行于 Base 主网。设置 AGENT_TOOLS_TESTNET=true 可使用 Base Sepolia 和公共测试网 facilitator。

传统计费

即将推出：为人工开发者和企业提供 API 密钥 + Stripe 按使用量计费。

技术栈

• Python 3.12 + FastAPI
• MCP SDK（mcp v1.27）——streamable-http 传输
• x402 SDK（x402[fastapi,evm] >=v2.11）——Base 上的 USDC 小额支付
• 9 个端点中有 8 个可自托管（无上游 API 成本）
• 单进程部署，内存占用约 62MB

自托管

Fly.io

git clone https://github.com/WingedGuardian/agent-tools.git
cd agent-tools
fly launch --copy-config
fly secrets set AGENT_TOOLS_PAY_TO=0xYourAddress AGENT_TOOLS_TESTNET=false
fly deploy

Docker

git clone https://github.com/WingedGuardian/agent-tools.git
cd agent-tools
cp .env.example .env
# Edit .env with your wallet address
docker compose up -d

手动部署

pip install ".[all]"
AGENT_TOOLS_PAY_TO=0xYourAddress uvicorn agent_tools.app:app --host 0.0.0.0 --port 8000

配置

变量	必需	默认值	说明
AGENT_TOOLS_PAY_TO	否	(empty)	用于接收 USDC 付款的 EVM 钱包地址。留空即可在免费/开发模式下运行。
AGENT_TOOLS_TESTNET	否	true	true = Base Sepolia 测试网（默认——可与公共 x402.org facilitator 配合使用）。false = Base 主网（需要支持主网的 facilitator）。

发现 / 注册表

• GitHub: https://github.com/WingedGuardian/agent-tools
• Smithery: (待注册)
• Glama: (待注册)
• x402-list: (待注册)
• npm: (待发布)

关键词

x402、微支付、USDC、Base、Agent 原生、MCP、Model Context Protocol、streamable-http、Agentic、AI Agent 工具、DNS 查询 API、WHOIS API、电子邮件验证 API、二维码 API、URL 健康状态 API、网页抓取 API、技术检测 API、安全标头分析器

许可证

MIT