Wire AI-visibility data into your systems and agents

1 · Get an API key

Create an API key on the Settings page after logging in (the plaintext is shown only once — store it safely). Open API and MCP are Pro-plan features; each key is limited to 600 requests per hour.

Go to Settings to create a key →

2 · REST Open API v1

Three read-only endpoints plus one for logging publications (JSON; scores/counts are server-computed strings — don't recompute):

• GET /api/v1/brandsmonitored brands
• GET /api/v1/brands/:id/scoreslatest overall + per-engine + 30-day trend
• GET /api/v1/brands/:id/citationstop 20 cited domains (workspace-level aggregate; :id is for ownership validation)
• GET / POST /api/v1/brands/:id/publicationslog a publication that has already happened, plus the monitored questions it targets, for per-question before/after

★The publications endpoint records facts that have already happened — OrcaScope never publishes anything on your behalf. There is no DELETE: correct mistakes in the console, where you can see exactly which record you are removing.

The POST response includes utmStatus (compliant / partial / untagged) and utmWarnings: we check the link against the UTM convention (utm_source=platform, utm_medium=earned-content, utm_campaign=batch). utmWarnings is an array of machine codes, not prose — one of unparsable / missing_source / missing_medium / medium_mismatch / missing_campaign, where medium_mismatch also carries an actual field with the value we found. Codes rather than sentences so you can automate against them: wording changes with language and revision, codes do not. ★Non-compliance never blocks registration — it is recorded as-is. ★This is link-parameter compliance only, not traffic attribution: traffic data lives in your own analytics tool.

curl https://orca-scope.com/api/v1/brands \
  -H "Authorization: Bearer geo_live_..."

3 · MCP endpoint (for AI agents)

A standard MCP (Model Context Protocol) Streamable HTTP endpoint — stateless JSON-RPC 2.0. Add it to any MCP client and your agent can query brand visibility scores, citation sources, industry benchmarks and the engine list directly.

Endpoint

POST https://orca-scope.com/api/mcp
Authorization: Bearer geo_live_...

Tools (first batch, all read-only)

• list_brands
• get_brand_scores
• get_brand_citations
• get_benchmarks
• list_engines

Client config (Claude Code / Cursor, generic format)

{
  "mcpServers": {
    "orcascope": {
      "type": "http",
      "url": "https://orca-scope.com/api/mcp",
      "headers": { "Authorization": "Bearer geo_live_..." }
    }
  }
}

Or verify with curl

curl -X POST https://orca-scope.com/api/mcp \
  -H "Authorization: Bearer geo_live_..." \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'