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.

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"}'