{
  "markdown": "# Agent Tools\n\n> 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](https://tools.beethoven2024.com).\n\n**For AI agents (Claude, Cursor, custom):** Add this MCP server to your config and use 9 utility tools instantly.\n\n**For developers:** Standard REST API. Use any subdomain example below as a working sample.\n\n## Try it now\n\n### As MCP server (Claude, Cursor, agents)\n\n```json\n{\n  \"mcpServers\": {\n    \"agent-tools\": {\n      \"url\": \"https://tools.beethoven2024.com/mcp\"\n    }\n  }\n}\n```\n\n### As REST API\n\n```bash\ncurl https://tools.beethoven2024.com/health\n# {\"status\":\"ok\",\"version\":\"0.1.0\"}\n\ncurl \"https://tools.beethoven2024.com/v1/dns/health?domain=example.com\"\n# Full DNS + mail security audit (requires x402 payment)\n```\n\n## What's in the bundle\n\n| Tool | Endpoint | What it does | Price |\n|------|----------|-------------|-------|\n| `qr_generate` | `/v1/qr/generate` | QR code generation (PNG/SVG, 64–2048px) | $0.001 |\n| `dns_health` | `/v1/dns/health` | DNS records + SPF/DMARC mail security audit | $0.003 |\n| `email_validate` | `/v1/email/validate` | Format, MX, disposable domain, role account, SMTP probe | $0.005 |\n| `ip_lookup` | `/v1/ip/lookup` | Geolocation, ISP, proxy/hosting detection, reverse DNS | $0.005 |\n| `url_health` | `/v1/url/health` | Status code, redirect chain, SSL cert, response time | $0.003 |\n| `whois_lookup` | `/v1/whois/lookup` | Registrar, creation/expiration dates, nameservers, status | $0.005 |\n| `headers_analyze` | `/v1/headers/analyze` | HTTP security headers audit with 0–100 score (HSTS, CSP, etc.) | $0.003 |\n| `extract_text` | `/v1/extract/text` | Clean text extraction from webpages (strips HTML, nav, ads) | $0.005 |\n| `tech_detect` | `/v1/tech/detect` | Website technology stack — frameworks, CMS, CDN, analytics | $0.005 |\n\n**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/*`).\n\n## Why these endpoints\n\nEvery endpoint solves a problem agents can't easily do locally:\n\n- **Network infrastructure** (DNS, WHOIS, headers, URL health, IP) — needs internet probes, can't be done in-process\n- **Specialized parsing** (QR, email validation with SMTP, tech detection) — domain-specific logic agents shouldn't reimplement\n- **Web extraction** (text extraction) — clean text from messy HTML is hard\n\n8 of 9 endpoints are fully self-hosted (zero upstream API cost). Only IP geolocation uses an external free-tier API.\n\n## Payment\n\n### x402 (machine-to-machine micropayments)\n\nEvery paid endpoint returns **HTTP 402 Payment Required** with the price spec when no payment is included. x402-capable agents handle this automatically:\n\n1. Agent calls endpoint → receives 402 with payment_requirements (network, amount, recipient address)\n2. Agent signs EIP-3009 `transferWithAuthorization` for USDC on Base\n3. Agent retries with `X-PAYMENT` header\n4. Service verifies payment via facilitator, executes, returns result\n\nSettlement happens on-chain on Base. Sub-2-second confirmation.\n\nRuns on Base mainnet by default. Set `AGENT_TOOLS_TESTNET=true` to use Base Sepolia with the public testnet facilitator.\n\n### Traditional billing\n\nComing soon: API key + Stripe usage billing for human developers and businesses.\n\n## Tech stack\n\n- Python 3.12 + FastAPI\n- MCP SDK (`mcp` v1.27) — streamable-http transport\n- x402 SDK (`x402[fastapi,evm]` >=v2.11) — USDC micropayments on Base\n- 8/9 endpoints self-hosted (no upstream API cost)\n- Single-process deploy, ~62MB memory footprint\n\n## Self-host\n\n### Fly.io\n\n```bash\ngit clone https://github.com/WingedGuardian/agent-tools.git\ncd agent-tools\nfly launch --copy-config\nfly secrets set AGENT_TOOLS_PAY_TO=0xYourAddress AGENT_TOOLS_TESTNET=false\nfly deploy\n```\n\n### Docker\n\n```bash\ngit clone https://github.com/WingedGuardian/agent-tools.git\ncd agent-tools\ncp .env.example .env\n# Edit .env with your wallet address\ndocker compose up -d\n```\n\n### Manual\n\n```bash\npip install \".[all]\"\nAGENT_TOOLS_PAY_TO=0xYourAddress uvicorn agent_tools.app:app --host 0.0.0.0 --port 8000\n```\n\n## Configuration\n\n| Variable | Required | Default | Description |\n|----------|----------|---------|-------------|\n| `AGENT_TOOLS_PAY_TO` | No | _(empty)_ | EVM wallet address for receiving USDC payments. Leave empty to run free/dev mode. |\n| `AGENT_TOOLS_TESTNET` | No | `true` | `true` = Base Sepolia testnet (default — works with public x402.org facilitator). `false` = Base mainnet (requires mainnet-capable facilitator). |\n\n## Discovery / registries\n\n- GitHub: https://github.com/WingedGuardian/agent-tools\n- Smithery: _(pending registration)_\n- Glama: _(pending registration)_\n- x402-list: _(pending registration)_\n- npm: _(pending publish)_\n\n## Keywords\n\nx402, 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\n\n## License\n\nMIT\n",
  "bytes": 5142,
  "sha": "3b5b6fc099befe6d3c4acdb12a4bed2185972df30286d853e23f3b42b4bb6ec0",
  "repo_slug": "wingedguardian/agent-tools",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_wingedguardian_agent_tools_815aedb7/readme"
}