Tools · web
Web page reader
Read any public web page as clean text: title, description, canonical URL, the readable body with scripts, styles and navigation stripped, the first 50 links resolved to absolute URLs, and a word count. One URL in, up to 100,000 characters out; redirects are not followed, and a page with no readable text (JavaScript-only) is 422 and not charged. Pay-per-call via x402. An empty body is answered for the published example page (https://example.com/); send {"url":"https://…"} for any other page.
$0.0018 per call, paid in USDC on Base or Solana with x402 — no account, no API key. POST https://fiatdock.com/v1/web/read (or GET with the same fields as query parameters) · MCP tool web_read. An answer the tool cannot produce is refused with 4xx/5xx and is not charged.
Inputs
| Field | Type | Description | Example |
|---|---|---|---|
url | string | Absolute http(s) URL of the page to read (no credentials) | "https://example.com/" |
maxChars | number | Cap on the returned text, 1000-100000 (default 40000) | |
Example
Request body
{"url":"https://example.com/"}
Answer (the published example)
{"url":"https://example.com/","status":200,"contentType":"text/html","title":"Example Domain","description":"","lang":"","canonical":"","text":"Example Domain\n\nThis domain is for use in illustrative examples in documents.","textChars":79,"totalChars":79,"truncated":false,"wordCount":13,"links":[{"href":"https://www.iana.org/domains/example","text":"More information..."}],"fetchedAt":"2026-09-21T00:00:00.000Z","note":"Extracted from a live fetch; scripts, styles and navigation stripped; redirects not followed."}
Call it
curl
# 1) ask: an unpaid call answers 402 with the exact price (free)
curl -i -X POST https://fiatdock.com/v1/web/read -H 'content-type: application/json' -d '{"url":"https://example.com/"}'
# 2) pay: any x402 client signs that 402 and resends — see Node or Python below
Node
// npm i @x402/fetch @x402/evm viem
import { wrapFetchWithPaymentFromConfig } from "@x402/fetch";
import { ExactEvmScheme } from "@x402/evm";
import { privateKeyToAccount } from "viem/accounts";
const pay = wrapFetchWithPaymentFromConfig(fetch, {
schemes: [{ network: "eip155:*", client: new ExactEvmScheme(privateKeyToAccount(process.env.AGENT_PRIVATE_KEY)) }],
});
const r = await pay("https://fiatdock.com/v1/web/read", {
method: "POST",
headers: { "content-type": "application/json" },
body: JSON.stringify({"url":"https://example.com/"}),
});
console.log(r.status, await r.json());
Python
# pip install "x402[httpx,evm]"
import asyncio, json, os
from eth_account import Account
from x402 import x402Client
from x402.http.clients import x402HttpxClient
from x402.mechanisms.evm.exact import register_exact_evm_client
async def main():
client = register_exact_evm_client(x402Client(), Account.from_key(os.environ["AGENT_PRIVATE_KEY"]))
async with x402HttpxClient(client) as http:
r = await http.post("https://fiatdock.com/v1/web/read", json=json.loads("{\"url\":\"https://example.com/\"}"))
print(r.status_code, r.json())
asyncio.run(main())
MCP (Claude, Cursor, any MCP client)
{"mcpServers":{"fiatdock":{"command":"npx","args":["-y","fiatdock-mcp"],"env":{"AGENT_PRIVATE_KEY":"0x<your agent wallet key>"}}}}
// then call the tool "web_read" — the package pays each call from that wallet
The wallet needs USDC on Base. Prefer no install? The remote server https://fiatdock.com/mcp answers the 402 as tool output for an agent that signs its own payments.
Related tools
- Domain intel: registration, DNS, email auth, TLS — $0.0045
- Website contacts: socials, role emails, phones — $0.0027
- Technical SEO audit of a web page — $0.009
- RSS / Atom feed reader — $0.0022
Machine-readable: OpenAPI · tools.json · llms.txt · /.well-known/x402