Connect your agent host

Nous Research's open-source agent framework (CLI, desktop, gateway).

hermes mcp add

mcp_servers:
  pdfex:
    url: "https://pdfex.io/mcp"
    headers:
      Authorization: "Bearer pdfex_your_key_here"

Verify: hermes mcp list

`hermes mcp add` is a discovery-first wizard; it writes the entry for you. Hermes stores connections as YAML under `mcp_servers`, not JSON. Do not hand-edit the file — a stray indent corrupts it and breaks the running gateway.

Coding agent CLI by Mario Zechner (@earendil-works/pi).

pi mcp add pdfex --url https://pdfex.io/mcp --bearer-token-env-var PDFEX_API_KEY

Verify: pi mcp list

`--bearer-token-env-var` is a documented Pi flag that sends `Authorization: Bearer <value of that env var>`, so the key never lands in the file. `pi mcp list` exits non-zero when a server fails — it is a real health check. Use `-l` to scope the server to the current project instead of globally.

Anthropic's terminal coding agent.

claude mcp add --transport http pdfex https://pdfex.io/mcp \
  --header "Authorization: Bearer $PDFEX_API_KEY"

Verify: claude mcp list

`--transport http` is required — without it Claude Code assumes a local stdio command. Add `--scope project` to write `.mcp.json` into the repo so a whole team shares it.

OpenAI's terminal coding agent.

codex mcp add

Verify: codex mcp list

`codex mcp add` exists but its flag spelling was not confirmed — run `codex mcp add --help` first. Codex reads TOML, so a JSON block will not work; the entry belongs under `[mcp_servers.pdfex]` in `~/.codex/config.toml`.

Google's open-source terminal agent.

gemini mcp add pdfex https://pdfex.io/mcp

Verify: gemini mcp list

`gemini mcp add <name> <commandOrUrl>` is confirmed from `--help`. The header flag spelling is not — run `gemini mcp add --help` and add the Authorization header, otherwise the server will answer 401.

Open-source terminal coding agent.

opencode mcp add

Verify: opencode mcp list

Note the key is `mcp`, not `mcpServers` — OpenCode uses its own schema. `opencode mcp add` is interactive and will prompt for the URL and header.

Self-hosted assistant gateway that connects chat apps to agents.

openclaw mcp add pdfex --url https://pdfex.io/mcp \
  --transport streamable-http

Verify: openclaw mcp doctor pdfex --probe

OpenClaw's own docs make the point this matrix is built on: saving a definition proves nothing about reachability — `doctor --probe` does. Also keep the key out of the config literal; OpenClaw asks you to store sensitive headers through its secret mechanism. You can also add it from the Control UI under Settings → MCP.

GitHub's Copilot agent for the terminal.

copilot mcp add pdfex

Verify: copilot mcp list

A `copilot mcp` subcommand exists, but the add syntax was not confirmed. Run `copilot mcp --help` before trusting this line.

Charm's terminal-first coding agent.

crush

Verify: crush --help

Crush reads `mcp` entries from its config file. Not confirmed on this machine — check the repo before publishing a command.

Anthropic's desktop app.

{
  "mcpServers": {
    "pdfex": {
      "type": "http",
      "url": "https://pdfex.io/mcp",
      "headers": { "Authorization": "Bearer pdfex_your_key_here" }
    }
  }
}

Verify: Restart the app; the pdfex tools appear in the tool picker.

Reachable from Settings → Developer → Edit Config. Restart the app after editing — it reads this file only at startup.

AI code editor.

{
  "mcpServers": {
    "pdfex": {
      "type": "http",
      "url": "https://pdfex.io/mcp",
      "headers": { "Authorization": "Bearer pdfex_your_key_here" }
    }
  }
}

Verify: Settings → MCP shows pdfex connected with its tools listed.

A project-scoped `.cursor/mcp.json` is also honoured, which is the better choice for a shared repo.

Codeium's AI code editor.

{
  "mcpServers": {
    "pdfex": {
      "type": "http",
      "url": "https://pdfex.io/mcp",
      "headers": { "Authorization": "Bearer pdfex_your_key_here" }
    }
  }
}

Verify: Cascade panel → MCP servers lists pdfex.

Windsurf also has an in-app MCP settings UI that edits this same file.

Autonomous coding agent as a VS Code extension.

{
  "mcpServers": {
    "pdfex": {
      "type": "http",
      "url": "https://pdfex.io/mcp",
      "headers": { "Authorization": "Bearer pdfex_your_key_here" }
    }
  }
}

Verify: The MCP Servers panel shows pdfex as connected.

Cline offers a remote-server form in its UI, which is less error-prone than editing the JSON.

VS Code coding agent (Cline fork).

{
  "mcpServers": {
    "pdfex": {
      "type": "http",
      "url": "https://pdfex.io/mcp",
      "headers": { "Authorization": "Bearer pdfex_your_key_here" }
    }
  }
}

Verify: MCP Servers tab in the Roo Code panel shows pdfex connected.

Same shape as Cline, different file location. Prefer the UI's remote-server form.

GitHub Copilot Chat inside VS Code.

{
  "servers": {
    "pdfex": {
      "type": "http",
      "url": "https://pdfex.io/mcp",
      "headers": { "Authorization": "Bearer pdfex_your_key_here" }
    }
  }
}

Verify: Command Palette → “MCP: List Servers” shows pdfex running.

THE TRAP: VS Code uses the key `servers`, not `mcpServers`. A block copied from Cursor or Claude Desktop is silently ignored here. This is the single most common copy-paste failure in this matrix.

Open-source IDE assistant (VS Code / JetBrains).

mcpServers:
  - name: pdfex
    type: http
    url: https://pdfex.io/mcp
    headers:
      Authorization: "Bearer pdfex_your_key_here"

Verify: The Continue sidebar lists the pdfex tools.

Continue's YAML takes a LIST of servers, not a map — note the leading `-`. Its JSON form (`config.json`) uses a map like everyone else.

Block's open-source local agent.

extensions:
  pdfex:
    type: streamable_http
    uri: https://pdfex.io/mcp
    headers:
      Authorization: "Bearer pdfex_your_key_here"

Verify: `goose` starts and lists pdfex among its extensions.

Goose calls MCP servers “extensions” and spells the transport `streamable_http` with an underscore, and the URL field `uri` not `url`. Three differences from every other host — copy from here, not from the canonical block.

Collaborative code editor.

{
  "context_servers": {
    "pdfex": {
      "source": "custom",
      "command": https://pdfex.io/mcp,
      "args": []
    }
  }
}

Verify: Zed's agent panel lists the pdfex tools.

Zed uses the key `context_servers`, not `mcpServers` — another silent-ignore trap. Newer Zed builds support remote HTTP servers directly; consult the docs, since this schema has been changing.