Agent Tools

io.github.WingedGuardian由 GitHub 账号 WingedGuardian 发布v0.1.0更新于 Oct 24, 2026

9 utility tools for agents: DNS, WHOIS, email, IP, URL, headers, QR, text, tech. x402 on Base.

已验证Streamable HTTP可网页运行网页搜索与抓取开发者工具安全与监控

概览

AI 生成的概览

远程 MCP 服务器,打包九个网络与网页实用工具(DNS、WHOIS、邮箱、IP、URL、响应头、二维码、文本、技术栈),按次通过 x402 USDC 微支付计费。

可以做什么
  • 执行 DNS 记录与 SPF/DMARC 邮件安全审计,并查询 WHOIS 注册商与域名服务器
  • 查询 IP 地理位置、ISP、代理/托管检测与反向 DNS
  • 校验邮箱地址(格式、MX、一次性域名、角色账号、SMTP 探测)
  • 检测 URL 状态码、跳转链、SSL 证书与响应时间,并为 HTTP 安全响应头打分
  • 生成 PNG 或 SVG 二维码,并从网页中提取干净正文
  • 识别网站技术栈(框架、CMS、CDN、分析工具)
适用场景
适合助手需要本地无法完成的实时网络探测或专门解析时使用,例如审计域名的邮件安全、检查网站是否可访问且安全、校验邮箱地址或识别网站技术栈。每次调用单独计费,更适合偶发查询而非高频批量使用。
运行要求
远程 streamable-HTTP 端点,无需本地安装、账号或 API 密钥。每次工具调用都需通过 x402 以 Base 上的 USDC 付款,因此客户端需能签署 EIP-3009 授权并持有资金,付款通过 X-PAYMENT 请求头发送。需要能访问该端点的网络。
安装前请注意
九个工具均按次收费(约每次 0.001–0.005 美元),默认在 Base 主网链上结算,因此涉及持有 USDC 且具备签名能力的钱包。服务方会收到你提交的域名、URL、IP 和邮箱地址,IP 地理位置查询还会经由外部免费额度 API。付款为自动处理,建议为钱包设置支出上限。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Agent Tools,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.WingedGuardian%2Fagent-tools/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

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

README

Agent Tools

Agent-native utility API bundle. 9 endpoints exposed as both REST API and MCP server (streamable-http), with x402 micropayments. Live at tools.beethoven2024.com.

For AI agents (Claude, Cursor, custom): Add this MCP server to your config and use 9 utility tools instantly.

For developers: Standard REST API. Use any subdomain example below as a working sample.

Try it now

As MCP server (Claude, Cursor, agents)

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

As REST API

bash
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)

What's in the bundle

ToolEndpointWhat it doesPrice
qr_generate/v1/qr/generateQR code generation (PNG/SVG, 64–2048px)$0.001
dns_health/v1/dns/healthDNS records + SPF/DMARC mail security audit$0.003
email_validate/v1/email/validateFormat, MX, disposable domain, role account, SMTP probe$0.005
ip_lookup/v1/ip/lookupGeolocation, ISP, proxy/hosting detection, reverse DNS$0.005
url_health/v1/url/healthStatus code, redirect chain, SSL cert, response time$0.003
whois_lookup/v1/whois/lookupRegistrar, creation/expiration dates, nameservers, status$0.005
headers_analyze/v1/headers/analyzeHTTP security headers audit with 0–100 score (HSTS, CSP, etc.)$0.003
extract_text/v1/extract/textClean text extraction from webpages (strips HTML, nav, ads)$0.005
tech_detect/v1/tech/detectWebsite technology stack — frameworks, CMS, CDN, analytics$0.005

Free: /health, /, /docs (OpenAPI), and MCP protocol methods initialize / tools/list / ping. All 9 tools require x402 payment via both MCP (tools/call) and REST (/v1/*).

Why these endpoints

Every endpoint solves a problem agents can't easily do locally:

  • Network infrastructure (DNS, WHOIS, headers, URL health, IP) — needs internet probes, can't be done in-process
  • Specialized parsing (QR, email validation with SMTP, tech detection) — domain-specific logic agents shouldn't reimplement
  • Web extraction (text extraction) — clean text from messy HTML is hard

8 of 9 endpoints are fully self-hosted (zero upstream API cost). Only IP geolocation uses an external free-tier API.

Payment

x402 (machine-to-machine micropayments)

Every paid endpoint returns HTTP 402 Payment Required with the price spec when no payment is included. x402-capable agents handle this automatically:

  1. Agent calls endpoint → receives 402 with payment_requirements (network, amount, recipient address)
  2. Agent signs EIP-3009 transferWithAuthorization for USDC on Base
  3. Agent retries with X-PAYMENT header
  4. Service verifies payment via facilitator, executes, returns result

Settlement happens on-chain on Base. Sub-2-second confirmation.

Runs on Base mainnet by default. Set AGENT_TOOLS_TESTNET=true to use Base Sepolia with the public testnet facilitator.

Traditional billing

Coming soon: API key + Stripe usage billing for human developers and businesses.

Tech stack

  • Python 3.12 + FastAPI
  • MCP SDK (mcp v1.27) — streamable-http transport
  • x402 SDK (x402[fastapi,evm] >=v2.11) — USDC micropayments on Base
  • 8/9 endpoints self-hosted (no upstream API cost)
  • Single-process deploy, ~62MB memory footprint

Self-host

Fly.io

bash
git clone https://github.com/WingedGuardian/agent-tools.gitcd agent-toolsfly launch --copy-configfly secrets set AGENT_TOOLS_PAY_TO=0xYourAddress AGENT_TOOLS_TESTNET=falsefly deploy

Docker

bash
git clone https://github.com/WingedGuardian/agent-tools.gitcd agent-toolscp .env.example .env# Edit .env with your wallet addressdocker compose up -d

Manual

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

Configuration

VariableRequiredDefaultDescription
AGENT_TOOLS_PAY_TONo(empty)EVM wallet address for receiving USDC payments. Leave empty to run free/dev mode.
AGENT_TOOLS_TESTNETNotruetrue = Base Sepolia testnet (default — works with public x402.org facilitator). false = Base mainnet (requires mainnet-capable facilitator).

Discovery / registries

Keywords

x402, micropayments, USDC, Base, agent-native, MCP, Model Context Protocol, streamable-http, agentic, AI agent tools, DNS lookup API, WHOIS API, email validation API, QR code API, URL health API, web scraping API, tech detection API, security headers analyzer

License

MIT

来源:README.md,提交 ed41b71

工具

0
SourceWeft 尚未读取此服务器的工具。

版本历史

1
  1. v0.1.0最新Sep 16, 2026

评分

已满足适用检查项的 85%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分