AgentPay Doc Tools

io.github.noah-silverv1.1.0更新于 Oct 1, 2026

Pay-per-call PDF to text, RSS/Atom to JSON, sitemap to URLs for agents. x402 USDC, Base/Algorand.

已验证Streamable HTTP可网页运行Files & StorageWeb Search & Scraping

概览

AI 生成的概览

远程 MCP 服务器,可将 PDF 转为逐页文本、将 RSS/Atom/JSON 订阅源转为规范化条目、将站点地图转为 URL 列表,按次付费。

功能
AgentPay Doc Tools 通过 Streamable HTTP 提供三个付费工具:tools_pdf_text 从不超过 20 MB 的 PDF 链接提取逐页文本,tools_feed 将 RSS、Atom 或 JSON Feed 规范化为条目,tools_sitemap 在遵循 robots.txt 和站点地图索引的前提下列出站点 URL。列出工具是免费的,每次工具调用按请求计费。相同功能也以 REST API 形式提供。
适用场景
当助手需要读取 PDF、采集订阅源或枚举站点 URL,而又不想自行搭建和托管解析流程时适用;也适合希望按次付费而非运行本地解析代码的场景。
运行要求
一个基于 Streamable HTTP 的远程 MCP 端点,无需本地运行时或安装包。需要两种方式之一:在 Authorization 请求头中携带从积分购买端点获取的 Bearer 积分 API 密钥,或使用支持 x402 的客户端在 Base 或 Algorand 上以 USDC 按次支付。需要能访问该端点以及所抓取的 URL。
安装前请注意
工具调用会产生费用:每次调用约 0.005 至 0.02 USDC,积分需预付,金额从 1 到 500 美元。使用 x402 按次支付需要客户端持有用于签署 USDC 付款的私钥,应将该私钥视为敏感信息。Authorization 请求头携带积分 API 密钥,须保密。服务会在请求时抓取你提供的任意 URL,因此不要传入内部或私有地址。

安装

在 SourceWeft 中

  1. 打开 控制台中的 AgentPay Doc Tools,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "agentpay-tools": {
      "type": "http",
      "url": "https://agentpay-tools.agentpay-apis.workers.dev/mcp"
    }
  }
}

README

AgentPay — pay-per-call APIs and MCP tools for AI agents

Web extraction, domain/network intelligence, and document tools that agents can use without signing up. Pay per request with x402 in USDC on Base or Algorand, or prepay credits for an API key. Every product is available as a REST API and as a remote MCP server.

ProductWhat it doesBase URLMCP server
Web ExtractAny URL → clean, LLM-ready markdown + title, metadata, Open Graph, canonical URL and linkshttps://agentpay-extract.agentpay-apis.workers.dev…/mcp
Domain & Network LookupDNS records, WHOIS/RDAP registration, IP ownership + reverse DNS, one-call domain report (email provider, SPF/DMARC, hosting)https://agentpay-lookup.agentpay-apis.workers.dev…/mcp
Doc ToolsPDF → per-page text, RSS/Atom/JSON Feed → JSON, sitemap (via robots.txt) → URL listhttps://agentpay-tools.agentpay-apis.workers.dev…/mcp
BundleAll of the above on one hosthttps://agentpay.agentpay-apis.workers.dev…/mcp

Machine-readable docs: /llms.txt · /openapi.json · /.well-known/x402

Endpoints and pricing

Same price on Base and Algorand. Invalid input is rejected before payment, and x402 payments are only settled if the call succeeds — failed calls cost nothing.

EndpointDescriptionPrice (USDC)
GET /extract/v1/page?url=Web page → markdown, metadata, links (maxChars optional)$0.005
GET /lookup/v1/dns?name=&type=A, AAAA, CNAME, MX, NS, TXT, SOA, CAA, PTR, SRV$0.005
GET /lookup/v1/whois?domain=Registrar, created/updated/expires, status, nameservers (RDAP)$0.01
GET /lookup/v1/ip?ip=Network owner, range, country, reverse DNS$0.01
GET /lookup/v1/domain-report?domain=Registration + DNS + email provider + SPF/DMARC + hosting$0.02
GET /tools/v1/pdf-text?url=Per-page text from a PDF URL (≤20 MB)$0.01
GET /tools/v1/feed?url=&limit=RSS / Atom / JSON Feed → normalized items$0.005
GET /tools/v1/sitemap?url=&limit=Site URLs from sitemaps, following robots.txt and indexes$0.005
GET /credits/buy?usd=Prepaid credits ($1–$500) → API key. +10% bonus at $5, +20% at $20= amount

Paying

x402 (no account)

Call any endpoint. You get 402 Payment Required with a base64 PAYMENT-REQUIRED header (x402 v2) offering:

  • Base — eip155:8453, USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, exact scheme (EIP-3009)
  • Algorand — algorand:wGHE2Pwdvd7S12BL5FaOP20EGYesN73k, USDC ASA 31566704, exact scheme

Any x402 v2 client handles this automatically:

js
import { wrapFetchWithPaymentFromConfig } from '@x402/fetch';import { ExactEvmScheme } from '@x402/evm';import { privateKeyToAccount } from 'viem/accounts';
const fetchWithPayment = wrapFetchWithPaymentFromConfig(fetch, {  schemes: [{ network: 'eip155:8453', client: new ExactEvmScheme(privateKeyToAccount(process.env.EVM_PRIVATE_KEY)) }],});const res = await fetchWithPayment('https://agentpay-lookup.agentpay-apis.workers.dev/lookup/v1/domain-report?domain=example.com');console.log(await res.json());

Full example for both networks: examples/x402-client.mjs.

Prepaid credits (fastest for repeated use)

GET https://agentpay.agentpay-apis.workers.dev/credits/buy?usd=5 (paid once via x402) returns { "apiKey": "ak_…" }. Send Authorization: Bearer ak_… on any endpoint or MCP server. Failed calls are refunded automatically. Balance: GET /credits/balance. Algorand holders can also pay by transfer: examples/buy-credits.mjs.

Using the MCP servers

Remote MCP over Streamable HTTP. Listing tools is free; tool calls are paid via x402 (params._meta["x402/payment"], per the x402 MCP transport) or with a credits key header.

Claude Code

bash
claude mcp add --transport http agentpay-lookup https://agentpay-lookup.agentpay-apis.workers.dev/mcp --header "Authorization: Bearer ak_..."

Cursor / Claude Desktop / any client with remote MCP support

json
{  "mcpServers": {    "agentpay-extract": { "url": "https://agentpay-extract.agentpay-apis.workers.dev/mcp", "headers": { "Authorization": "Bearer ak_..." } },    "agentpay-lookup":  { "url": "https://agentpay-lookup.agentpay-apis.workers.dev/mcp",  "headers": { "Authorization": "Bearer ak_..." } },    "agentpay-tools":   { "url": "https://agentpay-tools.agentpay-apis.workers.dev/mcp",   "headers": { "Authorization": "Bearer ak_..." } }  }}
MCP serverTools
agentpay-extractextract_page
agentpay-lookuplookup_dns, lookup_whois, lookup_ip, lookup_domain_report
agentpay-toolstools_pdf_text, tools_feed, tools_sitemap
agentpay (bundle)all 8

Example responses

GET /lookup/v1/whois?domain=anthropic.com

json
{ "domain": "anthropic.com", "registered": true, "registrar": "MarkMonitor Inc.", "created": "2001-10-02T18:10:32Z",  "expires": "2033-10-02T18:10:32Z", "status": ["client delete prohibited", "client transfer prohibited"],  "nameservers": ["isla.ns.cloudflare.com", "randy.ns.cloudflare.com"], "source": "RDAP" }

GET /lookup/v1/ip?ip=1.1.1.1

json
{ "ip": "1.1.1.1", "version": 4, "reverseDns": ["one.one.one.one."],  "network": { "name": "APNIC-LABS", "range": "1.1.1.0 - 1.1.1.255", "country": "AU", "organization": "APNIC Research and Development" } }

Data sources

DNS over HTTPS (Cloudflare 1.1.1.1), IANA RDAP bootstrap → authoritative registry RDAP servers, and the regional internet registries. Web, PDF, feed and sitemap tools fetch the URL you provide at request time.

Support

Open an issue in this repository.

来源:README.md,提交 5df9d36

工具

0
工具元数据尚未被收录。

版本历史

1
  1. v1.1.0最新Oct 1, 2026