Docs & API

Anserra API and MCP server

The API returns the same data as the dashboard, as JSON, authenticated with a per-account key. The MCP server exposes it as tools an AI assistant can call. Both are included on Multi-50 and Enterprise. Endpoints marked “private beta” are in use by the dashboard and open to Multi-50 customers on request; “available” means public with a stable contract.

Updated: September 17, 2026

Authentication

Send your key in the Authorization header. Keys are created and revoked in the dashboard under Settings → API.

curl https://api.anserra.io/v1/businesses \
  -H "Authorization: Bearer ans_live_…"

Endpoints

Method and path	Returns	Status
`GET /v1/businesses`	Tracked businesses with current score, interval and level	Private beta
`GET /v1/businesses/:id`	One business: score components, latest run summary	Private beta
`GET /v1/businesses/:id/findings`	Findings and fix plan tasks with status	Private beta
`GET /v1/businesses/:id/history`	Per-prompt, per-engine mention history	Private beta
`POST /v1/scans`	Queue a scan for a business or a batch; returns a job id	Private beta
`GET /v1/scans/:jobId`	Job status and per-domain progress	Private beta
`GET /v1/businesses/:id/report.pdf`	Branded PDF for the latest run	Planned
`GET /v1/badge/:id.svg`	Agent-ready badge for embedding	Available

Rate limits are per account and returned in X-RateLimit-* headers. Errors use standard HTTP status codes with a JSON body { "error": { "code", "message" } }.

MCP server

The Model Context Protocol server exposes the endpoints above as tools: list_businesses, get_business, get_findings, get_history, queue_scan. Connect it in Claude or ChatGPT with your API key, then ask in plain language: “which of my clients dropped below their interval this week?”, “list clients at L0 in Austin”.

{
  "mcpServers": {
    "anserra": {
      "url": "https://mcp.anserra.io",
      "headers": { "Authorization": "Bearer ans_live_…" }
    }
  }
}

Bulk CSV format

The same format the dashboard accepts. Only domain is required.

domain,business_name,city,vertical
cedarparkdental.com,Cedar Park Dental,Austin TX,dentist
northsideauto.com,Northside Auto Repair,Austin TX,auto repair
smilebrightdds.com,,,

Changes

API changes are listed on the changelog. Breaking changes get a new version prefix and 90 days of overlap.

API and MCP are on Multi-50

Fifty client businesses, weekly agent runs, priority queue.

Run a free scan Scan a client list