> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cruq.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP server

> Call Cruq AI from any MCP client over Streamable HTTP.

Cruq AI exposes a [Model Context Protocol](https://modelcontextprotocol.io)
server so agents and MCP clients (Claude, Cursor, and others) can drive the
platform directly, using the same tools as the REST API.

## Endpoint

* **URL:** `https://api.cruq.ai/mcp`
* **Transport:** Streamable HTTP
* **Auth:** the same API key as the REST API, sent as a bearer token:
  `Authorization: Bearer cruq_sk_...`

The server is stateless, so any MCP client that speaks Streamable HTTP can
connect without session setup.

## Connecting a client

Point your MCP client at the endpoint with an `Authorization` header. For a
client configured via JSON:

```json theme={null}
{
  "mcpServers": {
    "cruq": {
      "url": "https://api.cruq.ai/mcp",
      "headers": { "Authorization": "Bearer cruq_sk_..." }
    }
  }
}
```

## Tools

| Tool                   | Description                                                 |
| ---------------------- | ----------------------------------------------------------- |
| `list_agents`          | List the agents in your workspace.                          |
| `run_agent`            | Run an agent's published version and return its final text. |
| `list_runs`            | List recent runs.                                           |
| `get_run`              | Get a run and its tool-call step trace.                     |
| `search_memory`        | Semantically recall stored memories.                        |
| `add_memory`           | Store a memory for later recall.                            |
| `search_knowledge`     | Search knowledge bases (RAG).                               |
| `list_knowledge_bases` | List knowledge bases.                                       |
| `list_tools`           | List the workspace tool catalog.                            |

Each tool maps to the same operation as the [REST API](/docs/api-reference/overview);
see the [OpenAPI spec](https://www.cruq.ai/openapi.json) for the full schema.