API + MCP

Use The Same Report Engine From The
Web, API, and MCP

Create reports programmatically, poll status, and read the same saved report object your team sees on the website.

Access model

Account + card

API access is account-linked. Create an account, add a card, then issue one API key for direct API and MCP access.

One report object

Website sessions, API calls, and agent sessions read from the same saved report state.

Straightforward flow

Create a report, poll for status, then read preview or full results from the same object.

Available endpoints

POST/api/v1/reports

Create a new report or reuse one that already exists.

GET/api/v1/reports/:id

Get the latest report status and sections.

GET/api/v1/reports/:id/result

Read the full report result payload.

Example Response
{
  "success": true,
  "report": {
    "jobId": "383c5318-5e81-45a8-9df8-579d10442f72",
    "stage": "snapshot_ready",
    "status": "completed",
    "targetUrl": "https://rbeckner.com",
    "isSnapshotReady": true,
    "preview": {
      "sectionKeys": ["hero_summary", "top_findings"]
    },
    "paidUnlock": {
      "unlockEligible": true,
      "unlocked": false
    }
  },
  "pollAfterMs": 0
}