# Connect (/docs/mcp/connect)

Add the Orakle MCP server to any MCP-capable AI app or agent.



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

The server URL is:

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

## AI web apps (custom connectors) [#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 [#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](/dashboard/api-keys) for headless use:

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

## Raw HTTP [#raw-http]

To talk to the server directly — for scripts, testing, or custom agents —
POST JSON-RPC over the [Streamable HTTP transport](https://modelcontextprotocol.io/specification/2025-11-25/basic/transports):

```bash
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 [#verify]

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