English Français العربية

Agent Tools

السجل الرسمي البحث والويب

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

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http agent-tools 'https://tools.beethoven2024.com/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "agent-tools": {
            "type": "http",
            "url": "https://tools.beethoven2024.com/mcp"
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Agent Tools
  2. Try it now
  3. What's in the bundle
  4. Why these endpoints
  5. Payment
  6. Tech stack
  7. Self-host
  8. Configuration
  9. Discovery / registries
  10. Keywords
  11. License

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)
{
  "mcpServers": {
    "agent-tools": {
      "url": "https://tools.beethoven2024.com/mcp"
    }
  }
}
As 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)

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
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
Manual
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

الأسئلة الشائعة

ما هو Agent Tools؟

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

كيف أثبّت Agent Tools؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http agent-tools 'https://tools.beethoven2024.com/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Agent Tools إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل Agent Tools مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Agent Tools؟

ينشره WingedGuardian. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.