Funnel Mage API and agent docs

Funnel Mage is a product humans buy in a browser. It is not a partner platform and it has no OAuth authorization server. Lazige (Ian Hitge and Nicola Lazzari) run it.

When to use Funnel Mage

Use it when a business is already paying for ads to a live page and wants a proof-it-first list of why those clicks are not buying. Do not use it to manage ad accounts, log into analytics, place test orders, or run a retainer.

How an agent should help

Read /llms.txt for facts and prices. Send the human to /start to pick checks and pay. After payment they land on /run/{id}. That UUID is the only credential for GET /api/v1/runs/{id}. Do not invent star ratings. Do not promise results.

Public API

Machine-verifiable surface on this host: /openapi.json (also /openapi.yaml). Canonical paths are /api/v1/* and /v1/*. Unversioned /api/* is a permanent alias. Try GET /api/v1 for a JSON index, GET /api/v1/checkout for a typed 405, or POST /api/v1/checkout with an empty body to see a typed RFC 9457 error. Errors always include code, message, and hint.

Versioning

Current version is 1. Responses send API-Version: 1. Breaking changes will be /api/v2 and /v2. Before removing v1 we will send Deprecation (RFC 9745) and Sunset (RFC 8594) headers at least 90 days in advance. Those headers are absent today because v1 is current.

MCP

Streamable HTTP at /mcp, advertised at /.well-known/mcp. Tools are discovery-only (facts and OpenAPI). The server cannot start checkout or charge a card.

Auth

There is no API key, no OAuth, and no contact-sales form. Checkout is Stripe. A finished run is readable by anyone who has its unguessable UUID (scope: run:read on that id). Unknown API paths return JSON, not HTML. Checkout is limited to 10 POSTs per IP per 60 seconds; 429 responses include Retry-After and RateLimit headers.

Zero-auth onboarding

Agents do not need an account. GET /api/v1 (also GET /v1) returns auth: "none" with no credentials. The free sandbox is /sandbox (same report as /sample-report). Humans who want a paid run go to /start.