English Français العربية

Agent Tools

Official registry Search and web

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

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

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

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  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

Frequently asked questions

What is Agent Tools?

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

How do I install Agent Tools?

It runs as a remote server. In Claude Code: claude mcp add --transport http agent-tools 'https://tools.beethoven2024.com/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Agent Tools need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is Agent Tools open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Agent Tools?

It is published by WingedGuardian. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.