Connect

Interactive clients handle the OAuth handshake on first use. For headless agents, use an API key from dashboard/api-keys as a Bearer token.

The server URL is:

https://api.orakle.xyz/v1/mcp

AI web apps (custom connectors)

Most AI web apps connect to remote MCP servers through a custom connector configured in their settings. The flow is the same across apps:

1. Open the app's Settings → Connectors (or equivalent).
2. Choose Add custom connector.
3. Enter a name (e.g. Orakle) and the server URL above.
4. Save. On the first call, the app opens a browser window for OAuth sign-in and stores the resulting token.

No config file or API key is needed for this path — the app drives OAuth for you.

Config-based clients

Clients that read a JSON config file should add Orakle under mcpServers with the HTTP transport. Use an API key from dashboard/api-keys for headless use:

{
  "mcpServers": {
    "orakle": {
      "url": "https://api.orakle.xyz/v1/mcp",
      "headers": { "Authorization": "Bearer pk_user_..." }
    }
  }
}

Raw HTTP

To talk to the server directly — for scripts, testing, or custom agents — POST JSON-RPC over the Streamable HTTP transport:

curl -s https://api.orakle.xyz/v1/mcp \
  -H "Authorization: Bearer pk_user_..." \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Verify

tools/list should return get_pricing, submit_pricing_job, and get_job_result. The dashboard MCP page shows the timestamp of your most recent call so you can confirm the connection is live.