Agent Tools

io.github.WingedGuardianPublished by GitHub account WingedGuardianv0.1.0Updated Oct 24, 2026

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

Overview

AI-generated overview

Remote MCP server bundling nine network and web utility tools (DNS, WHOIS, email, IP, URL, headers, QR, text, tech) paid per call with x402 USDC micropayments.

What you can do
  • Run DNS record and SPF/DMARC mail security audits, plus WHOIS registrar and nameserver lookups
  • Check IP geolocation, ISP, proxy/hosting detection and reverse DNS
  • Validate email addresses (format, MX, disposable, role account, SMTP probe)
  • Probe URL status, redirect chains, SSL certificates and response times, and score HTTP security headers
  • Generate QR codes as PNG or SVG and extract clean text from webpages
  • Detect a site's technology stack (frameworks, CMS, CDN, analytics)
When to use it
Useful when an assistant needs live internet probes or domain-specific parsing it cannot do locally: auditing a domain's mail security, checking whether a site is up and secure, validating an email address, or identifying a site's stack. Each call is billed individually, so it suits occasional lookups rather than high-volume use.
Requirements
Remote streamable-HTTP endpoint; no local install, account or API key. Every tool call requires an x402 payment in USDC on Base, so the client must be able to sign EIP-3009 authorizations and hold funds; the payment is sent in an X-PAYMENT header. Network access to the endpoint is required.
Before you install
All nine tools cost money per call (roughly $0.001–$0.005 each) and settle on-chain on Base mainnet by default, so a wallet with USDC and signing capability is involved. The service receives the domains, URLs, IPs and email addresses you submit, and IP geolocation is resolved through an external free-tier API. Payment handling is automated, so spending limits should be set on the wallet.

Installation

In SourceWeft

  1. Open Agent Tools in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.WingedGuardian%2Fagent-tools/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "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

Source: README.md at commit ed41b71

Tools

0
SourceWeft has not read this server's tools yet.

Version history

1
  1. v0.1.0LatestSep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts