# MCP server

> Connect Claude Code, Cursor, or any MCP client to Kerox over streamable HTTP with your API key.

## Endpoint & authentication

Kerox exposes a remote Model Context Protocol (MCP) server over streamable HTTP authenticated with your Bearer API key:

- **URL**: `https://api.kerox.ai/mcp`
- **Header**: `Authorization: Bearer $KEROX_API_KEY`

Tasks created through MCP follow the same pricing and the same hold, settle, and refund rules. They appear in [Console → Tasks](/console/tasks) and in `GET /v1/tasks` with `source: "mcp"`.

## Available tools

| Tool | Description |
| --- | --- |
| `list_models` | List published image and video models with current prices |
| `get_model_schema` | Inspect a model's native `input_schema` and unified parameter mapping |
| `estimate` | Estimate cost for a candidate task without creating it |
| `create_task` | Submit a generation task (pass `idempotency_key` to retry safely) |
| `get_task` | Check task status, outputs, cost, or error details |
| `list_tasks` | List recent tasks for your account |
| `upload_file` | Prepare a reference file upload: returns `upload_url` and `upload_headers` to `PUT` the bytes to, and the `url` to use as input |
| `get_balance` | Read your balance, held amount, and limits |

## Client configuration

```json
{
  "mcpServers": {
    "kerox": {
      "type": "http",
      "url": "https://api.kerox.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${KEROX_API_KEY}"
      }
    }
  }
}
```
