Skip to main content

​
Client API MCP Access

OMNI exposes legacy MCP-compatible routes under Client API v1. Canonical hosted transport is documented at /sources/client-api-mcp-hosted.

​
Endpoints

  • GET /v1/mcp/tools — list available OMNI tools
  • POST /v1/mcp/invoke — invoke a tool with idempotency support

​
Current tools

  • fred.search
  • fred.series

​
Invoke payload

{
  "tool": "fred.search",
  "arguments": {
    "q": "inflation",
    "limit": 5
  }
}

​
Required headers

  • Authorization: Bearer omni_live_...
  • Idempotency-Key: <required-for-post>

​
Billing and metering behavior

  • Successful invocations (2xx/3xx) generate billable usage events.
  • Replayed idempotent responses are not double-billed.
  • Usage can be forwarded to configured metering sinks.

​
Migration note

Use /mcp for new integrations. /v1/mcp/* routes are compatibility paths.