API reference

Quickstart

One request. No account step, because there is no account.

curl -X POST https://MY_DOMAINNAME/api/v1/pdf \
  -H "Content-Type: application/json" \
  -d '{
    "url":"https://example.com",
    "format":"A4",
    "printBackground":true
  }'

{
  "success": true,
  "price": "$0.03",
  "pages": 7,
  "render_ms": 4281,
  "content_type": "application/pdf",
  "download_url": "/files/abc123.pdf"
}

The first unpaid call returns 402 with a price and a nonce. A client that speaks x402 signs and retries automatically; see x402 payment.

Endpoints

Every service, its path and its unit price. All endpoints accept JSON and return JSON unless you ask for bytes.

Parameters

Shared parameters plus the ones specific to each service. Sending a parameter a service does not use returns 400 rather than ignoring it silently.

x402 payment flow

x402 lets a client receive a 402 response, authorize the payment and retry the request automatically. Nonces are single-use, bound to a hash of the request body, and expire in 120 seconds.

HTTP/1.1 402 Payment Required
Content-Type: application/json
X-Payment-Nonce: pn_9f2c81a4

{
  "error": "payment_required",
  "accepts": [
    {
      "scheme": "x402/exact",
      "network": "base",
      "asset": "USDC",
      "amount": "0.03",
      "nonce": "pn_9f2c81a4",
      "expires_in": 120
    }
  ]
}

curl -X POST https://MY_DOMAINNAME/api/v1/pdf \
  -H "X-PAYMENT: $(x402 sign 0.03)" \
  -H "Content-Type: application/json" \
  -d @request.json

MCP

All seven services are exposed as MCP tools, so an agent framework can discover them without a bespoke wrapper. Add the server to your client configuration:

{
  "mcpServers": {
    "agentnorth": {
      "url": "https://MY_DOMAINNAME/mcp",
      "transport": "http"
    }
  }
}

Tool names match the service paths — render, markdown, screenshot, pdf, seo, security, links. Each declares its price so an agent can budget before calling.

Errors

Failure modes and their codes. Only 2xx responses settle — everything on this list leaves the payment authorization unused, so none of them cost you anything.