# Olaa MCP server

Connect an MCP-compatible agent to Olaa over Streamable HTTP with a scoped API key.

Base URL: `https://api.olaa.com/mcp`

## Setup

Create an API key with at least threads:create, runs:create, runs:read. Then add the server to your client.

```
claude mcp add --transport http olaa https://api.olaa.com/mcp --header "Authorization: Bearer ol_live_sk_…"

// Cursor ~/.cursor/mcp.json
{ "mcpServers": { "olaa": { "url": "https://api.olaa.com/mcp", "headers": { "Authorization": "Bearer ol_live_sk_…" } } } }
```

## Tools

ask_olaa (one-shot), create_thread, send_message, wait_for_run, get_run, get_run_result, cancel_run, list_threads, get_thread, list_messages, list_runs, get_file_download_url, whoami.

## Errors

Tool errors come back as isError results with codes insufficient_scope, wait_timed_out, thread_busy, rate_limit_exceeded, insufficient_credits.