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

# MCP server

> Use the knowledge base from Claude, Cursor, and other MCP clients

Amoreg exposes a [Model Context Protocol](https://modelcontextprotocol.io)
server so AI assistants can search your regulatory knowledge base directly.

```txt theme={"theme":"css-variables"}
https://app.amoreg.com/api/mcp/v1
```

Transport is streamable HTTP. Authenticate with the same organisation API key,
via `Authorization: Bearer` or `X-Api-Key`. Any valid key can connect; each
tool enforces its own [scope](/authentication#scopes) — a missing scope
returns a structured tool error with `"status": 403`.

## Tools

| Tool                  | Scope                    | Description                                                                                                                    | Cost                                             |
| --------------------- | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------ |
| `searchKnowledgeBase` | `search`                 | Hybrid search, optionally scoped to jurisdictions                                                                              | 2p per call                                      |
| `listJurisdictions`   | `search` or `screenings` | Jurisdictions enabled for the organisation                                                                                     | Free                                             |
| `getCreditBalance`    | `credits`                | Current balance, holds, and available credit                                                                                   | Free                                             |
| `runScreening`        | `screenings`             | Batch keyword screening as a durable background run                                                                            | 2p per keyword (reserved, settled on completion) |
| `getScreening`        | `screenings`             | Screening run status and results                                                                                               | Free                                             |
| `listDocuments`       | `documents`              | Policy documents in the knowledge base                                                                                         | Free                                             |
| `getDocument`         | `documents`              | One document's status and metadata                                                                                             | Free                                             |
| `executePython`       | `executions`             | Python in an isolated sandbox. Waits up to `waitSeconds` (default 45s, max 120s) for the result, then returns a run id to poll | 5p + 1p/second                                   |
| `getExecution`        | `executions`             | Execution status and output                                                                                                    | Free                                             |

Document *upload* is deliberately REST/dashboard-only — MCP has no multipart
transport. Long screenings and executions return a run id immediately; poll
the matching `get*` tool.

## Claude Code

```bash theme={"theme":"css-variables"}
claude mcp add amoreg --transport http https://app.amoreg.com/api/mcp/v1 \
  --header "Authorization: Bearer $AMOREG_API_KEY"
```

## Claude Desktop / generic client config

```json theme={"theme":"css-variables"}
{
  "mcpServers": {
    "amoreg": {
      "type": "http",
      "url": "https://app.amoreg.com/api/mcp/v1",
      "headers": {
        "Authorization": "Bearer amrg_live_..."
      }
    }
  }
}
```

## Cursor

```json theme={"theme":"css-variables"}
{
  "mcpServers": {
    "amoreg": {
      "url": "https://app.amoreg.com/api/mcp/v1",
      "headers": { "Authorization": "Bearer amrg_live_..." }
    }
  }
}
```

Tool calls that search the knowledge base debit prepaid credits exactly like
the REST API — see [Credits & pricing](/credits).