indox-mcp

MCP server for the Indox conversion API. It lets an AI client — Claude Code, Claude Desktop, Cursor, VS Code — convert documents, images, video, 3D models and fonts, check credits, manage stored files and webhooks, and ask questions about PDFs. Every tool is a thin wrapper over the official Python SDK, indox-client.

Requires: Python ≥ 3.11 · an Indox API key (ak_…, created in the dashboard under API Keys)

It runs two ways from the same tools:

Tools

Tools that spend credits or change data are marked as not read-only, so clients can ask before running them. Text extracted from your documents is treated as data, never as instructions.

Local mode (stdio)

pip install indox-mcp

The server starts only when every variable below is set, and names the first one missing.

If a client cannot find indox-mcp, use the full path that which indox-mcp prints.

Hosted mode

The hosted server is not live yet; it will be at https://mcp.indox.org/mcp. Send your API key as Authorization: Bearer ak_…; each call runs with that key alone.

Downloads: a hosted download_result returns a link with needs_api_key=true — fetch it with the same API key. Key-free signed links are planned; until they ship, hosted downloads need the caller's key.

Client setup

Replace ak_your_key and /absolute/path/to/files with your own values.

Claude Code — local, then hosted:

claude mcp add --env INDOX_API_KEY=ak_your_key --env INDOX_BASE_URL=https://indox.org \
  --env INDOX_MCP_WORKSPACE_DIR=/absolute/path/to/files \
  --env INDOX_MCP_WAIT_MAX_SECONDS=120 --env INDOX_MCP_POLL_SECONDS=2 \
  --transport stdio indox -- indox-mcp

claude mcp add --transport http indox-hosted https://mcp.indox.org/mcp \
  --header "Authorization: Bearer ak_your_key"

Add --scope project to share the server through .mcp.json, or --scope user for every project.

Claude Desktop — Settings › Developer › Edit Config opens claude_desktop_config.json (macOS ~/Library/Application Support/Claude/, Windows %APPDATA%\Claude\):

{
  "mcpServers": {
    "indox": {
      "command": "indox-mcp",
      "env": {
        "INDOX_API_KEY": "ak_your_key",
        "INDOX_BASE_URL": "https://indox.org",
        "INDOX_MCP_WORKSPACE_DIR": "/absolute/path/to/files",
        "INDOX_MCP_WAIT_MAX_SECONDS": "120",
        "INDOX_MCP_POLL_SECONDS": "2"
      }
    }
  }
}

The hosted server is added as a custom connector (Customize › Connectors › Add custom connector), not in this file. An API key goes under Request headers as Bearer ak_your_key; that option is in beta, and on Team and Enterprise plans every member would share one key — use local mode there.

Cursor — .cursor/mcp.json in a project, or ~/.cursor/mcp.json for every project:

{
  "mcpServers": {
    "indox": {
      "type": "stdio",
      "command": "indox-mcp",
      "env": {
        "INDOX_API_KEY": "${env:INDOX_API_KEY}",
        "INDOX_BASE_URL": "https://indox.org",
        "INDOX_MCP_WORKSPACE_DIR": "/absolute/path/to/files",
        "INDOX_MCP_WAIT_MAX_SECONDS": "120",
        "INDOX_MCP_POLL_SECONDS": "2"
      }
    },
    "indox-hosted": {
      "url": "https://mcp.indox.org/mcp",
      "headers": { "Authorization": "Bearer ${env:INDOX_API_KEY}" }
    }
  }
}

VS Code (Copilot agent mode) — .vscode/mcp.json; VS Code prompts for the key and hides what you type:

{
  "inputs": [
    { "type": "promptString", "id": "indox-key", "description": "Indox API key", "password": true }
  ],
  "servers": {
    "indox": {
      "type": "stdio",
      "command": "indox-mcp",
      "env": {
        "INDOX_API_KEY": "${input:indox-key}",
        "INDOX_BASE_URL": "https://indox.org",
        "INDOX_MCP_WORKSPACE_DIR": "/absolute/path/to/files",
        "INDOX_MCP_WAIT_MAX_SECONDS": "120",
        "INDOX_MCP_POLL_SECONDS": "2"
      }
    },
    "indox-hosted": {
      "type": "http",
      "url": "https://mcp.indox.org/mcp",
      "headers": { "Authorization": "Bearer ${input:indox-key}" }
    }
  }
}

Run the HTTP server yourself

indox-mcp --http serves Streamable HTTP at /mcp and an open /healthz. Each request uses the caller's own key; the server holds no key of its own. Required variables:

Client config formats checked on 2026-10-29 against Claude Code, Claude Desktop and custom connectors, Cursor and VS Code.