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 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
{
"mcpServers": {
"kerox": {
"type": "http",
"url": "https://api.kerox.ai/mcp",
"headers": {
"Authorization": "Bearer ${KEROX_API_KEY}"
}
}
}
}