Skip to Content

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

ToolDescription
list_modelsList published image and video models with current prices
get_model_schemaInspect a model's native input_schema and unified parameter mapping
estimateEstimate cost for a candidate task without creating it
create_taskSubmit a generation task (pass idempotency_key to retry safely)
get_taskCheck task status, outputs, cost, or error details
list_tasksList recent tasks for your account
upload_filePrepare a reference file upload: returns upload_url and upload_headers to PUT the bytes to, and the url to use as input
get_balanceRead your balance, held amount, and limits

Client configuration

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

On this page

For AI agents

This page as Markdown: /docs/mcp.md

Everything at once: /llms-full.txt