Agentpay MCP Server

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.

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.

Paying

Free trial

GET https://agentpay.agentpay-apis.workers.dev/credits/trial returns an API key with $0.05 of free credit (one per network per day). Use it as Authorization: Bearer <key> on any endpoint or MCP server.

Pay by hand with Pera Wallet

Open https://agentpay.agentpay-apis.workers.dev/pay, connect Pera, pick an endpoint (or buy credits), and approve the USDC payment in the app. Network fees are sponsored, so only USDC is needed.

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:wGHE2Pwdvd7S12BL5FaOP20EGYesN73ktiC1qzkkit8=, USDC ASA 31566704, exact scheme, network fees sponsored by the GoPlausible facilitator (extra.feePayer)

Any x402 v2 client handles this automatically:

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

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

{
  "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_..." } }
  }
}

Example responses

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

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

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