API Reference

Public machine interface for agents and integrations. The canonical external API is MCP JSON-RPC with OAuth access tokens or bearer API keys.

Base URL

https://attribution.ai/api

OpenAPI Spec

Machine-readable API contract for MCP and OAuth endpoints: https://attribution.ai/openapi/mcp.json

Public Endpoints

Authentication

Preferred: OAuth + PKCE. Fallback: Authorization: Bearer atai_... for API key access.

Authorization: Bearer atai_your_key_here

MCP JSON-RPC Endpoint

POST /api/mcp/rpc
Content-Type: application/json
Authorization: Bearer YOUR_TOKEN

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "performance",
    "arguments": {
      "start_date": "2026-01-01",
      "end_date": "2026-01-31"
    }
  },
  "id": 1
}

JSON-RPC Methods

• initialize
• tools/list
• tools/call
• resources/list / resources/read
• prompts/list / prompts/get

Internal Dashboard Routes

Many /api/dashboard/*, /api/sync/*, and /api/settings/* routes are session-based and power the web app UI. They are not the stable public connector contract for external agents.

Error Handling

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32600,
    "message": "Invalid request"
  },
  "id": 1
}

See Error Reference for complete codes and troubleshooting.

Full Tool Reference

Explore the MCP Tool Reference for all 16 tools, parameters, and response schemas.