x402 Agent Tools

io.github.signal-forge-aiPublished by GitHub account signal-forge-aiv1.1.0Updated Nov 3, 2026

Pay-per-call web, Base onchain and crypto-alert tools for agents. USDC on Base via x402, no API key.

VerifiedStreamable HTTPWeb executableFinance

Overview

x402 Agent Tools's hosted MCP server (x402-agent-tools.x402agenttools.workers.dev); no sign-in required; Streamable HTTP; 9 tools.

No AI overview yet: these facts come from the registry entry and the server itself.

Endpoint
x402-agent-tools.x402agenttools.workers.dev
Last checked

Installation

In SourceWeft

  1. Open x402 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.signal-forge-ai%2Fx402-agent-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": {
    "x402-agent-tools": {
      "type": "http",
      "url": "https://x402-agent-tools.x402agenttools.workers.dev/mcp"
    }
  }
}

README

x402 Agent Tools

Pay-per-call tools for AI agents. Pay with USDC on Base using the x402 protocol (HTTP 402). No API key, no signup, no account.

Tools and prices

EndpointPrice (USDC)What it does
GET /v1/markdown?url=$0.01Web page to clean Markdown
GET /v1/extract?url=$0.04Structured JSON: meta/OpenGraph, JSON-LD, headings, links, tables, emails
GET /v1/crawl?url=&max_pages=$0.16Same-origin crawl, up to 10 pages, Markdown each
GET /v1/token-risk?address=$0.04Base token/contract heuristic risk check (proxy, owner, risky selectors)
GET /v1/token-price?address=$0.005Base token USD price (GeckoTerminal, DefiLlama fallback)
GET /v1/wallet-profile?address=$0.02Base wallet ETH/USDC balances, nonce, recent USDC transfers
GET /v1/fx?from=&to=&amount=&date=$0.002Fiat FX rates (ECB reference)
GET /v1/alerts/latest?limit=$0.01Latest factual crypto/market alerts
GET|POST /v1/alerts/pass$17-day Bearer token for GET /v1/alerts?since=
GET /v1/alerts/samplefree3 alerts delayed 60+ min

Crypto alerts are visible about 1 to 2 minutes after they fire. Stock news alerts are delayed 15 to 20 minutes. Alerts are factual observations (price/volume moves) only: no scores, no buy/sell calls, not investment advice.

Free trial

The first 3 calls per day per caller (hashed IP) to /v1/markdown, /v1/token-price and /v1/fx are free; just call without a payment header. A global daily cap applies. The X-Free-Trial-Remaining response header shows what is left. Crawl and alert passes are never free.

How agents pay (x402)

  1. Call an endpoint. You get 402 Payment Required with a PAYMENT-REQUIRED header (x402 v2) and a JSON body listing accepts (scheme exact, network eip155:8453, asset USDC, payTo, amount).
  2. Sign the USDC authorization with your wallet and retry with the PAYMENT-SIGNATURE (v2) or X-PAYMENT (v1) header.
  3. The facilitator verifies and settles; you get the result plus a PAYMENT-RESPONSE header.
js
// any x402 client works, e.g. @x402/fetch:import { wrapFetchWithPayment } from "@x402/fetch";const fetchWithPay = wrapFetchWithPayment(fetch, yourX402Client);const res = await fetchWithPay("https://x402-agent-tools.x402agenttools.workers.dev/v1/markdown?url=https://example.com");

MCP

Remote MCP server, stateless Streamable HTTP (JSON responses), no install needed:

json
{ "mcpServers": { "x402-agent-tools": { "type": "http", "url": "https://x402-agent-tools.x402agenttools.workers.dev/mcp" } } }

Tools: web_markdown, web_extract, web_crawl, base_token_risk, base_token_price, base_wallet_profile, fx_rates, alerts_latest, alerts_sample (free).

Paid tools called without payment return isError: true with the x402 requirements in structuredContent["x402/payment-required"]. Retry the same tools/call with the base64 x402 payment payload in the PAYMENT-SIGNATURE HTTP header, or in params._meta["x402/payment"]. Settlement info comes back in result._meta["x402/payment-response"].

No npm needed: any MCP client with HTTP transport works, or plain curl:

sh
curl -s https://x402-agent-tools.x402agenttools.workers.dev/mcp -H 'content-type: application/json' \  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Self-host

Cloudflare Worker (Hono + @x402/hono).

sh
npm install# edit wrangler.toml: account_id, KV namespace id, PAY_TO (your own receive address)npx wrangler secret put ALERTS_HMAC   # random secret for alert tokensnpx wrangler deploy

No secrets live in this repo; everything sensitive is a Wrangler secret or env var.

License

MIT. Operated by an autonomous AI agent team. Informational data only, not investment advice.

Source: README.md at commit bffdabe

Tools

9

web_markdown

Any public web page URL -> clean Markdown (Readability + Turndown). Returns {url,title,byline,length,markdown}. Price $0.01 USDC on Base via x402 (3 free calls/day per caller).

Parametersurlrequired

web_extract

Structured JSON extraction from a web page: title, meta/OpenGraph, JSON-LD, headings, links, tables, contact emails, plus Markdown body. Price $0.04 USDC on Base via x402.

Parametersurlrequired

web_crawl

Same-origin multi-page crawl (up to 10 pages, breadth-first) returning Markdown for each page. Price $0.16 USDC on Base via x402.

Parametersurlrequiredmax_pages

base_token_risk

Base mainnet token/contract risk check via public RPC: ERC-20 metadata, owner, EIP-1967 proxy, risky bytecode selectors (mint/blacklist/pause/fee setters), heuristic risk score. Price $0.04 USDC on Base via x402.

Parametersaddressrequired

base_token_price

Current USD price of a Base token by contract address (GeckoTerminal, fallback DefiLlama), with 24h change, volume, liquidity/FDV where available. Price $0.005 USDC on Base via x402 (3 free calls/day per caller).

Parametersaddressrequired

base_wallet_profile

Base wallet profile via public RPC: ETH and USDC balances, nonce (tx count), contract-or-EOA, recent USDC transfers (last ~10k blocks). Price $0.02 USDC on Base via x402.

Parametersaddressrequired

fx_rates

Fiat exchange rates (ECB reference rates via frankfurter.app), latest or historical. Price $0.002 USDC on Base via x402 (3 free calls/day per caller).

Parameterstodatefromamount

alerts_latest

One-shot: latest factual market alerts (symbol, time, signal type, price, % move, timeframe, source). Informational data only, not investment advice. Price $0.01 USDC on Base via x402.

Parameterslimit

alerts_sample

FREE: 3 factual crypto/market alerts delayed 60+ minutes. Informational data only, not investment advice. Alerts are automated factual observations (price/volume moves); no buy/sell recommendation is made or implied.

Takes no parameters.

Version history

1
  1. v1.1.0LatestNov 3, 2026

Score

100% 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
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts