# Other MCP hosts

Source: https://www.geardex.app/api-docs/mcp-adapter/other-hosts

API access requires the GearDex Studio plan and a scoped Studio API key.

Add the GearDex MCP adapter to Cursor, Hermes Agent or other hosts that start local MCP servers.

## MCP config

Cursor, Hermes Agent and other hosts that start local (stdio) servers use the same config as [Claude Desktop](https://www.geardex.app/api-docs/mcp-adapter/claude#claude-desktop). On Windows, change the command from `npx` to `npx.cmd`.

**MCP config**

```json
{
  "mcpServers": {
    "geardex": {
      "command": "npx",
      "args": [
        "--yes",
        "--package",
        "https://github.com/dylandersen/geardex-public/releases/download/mcp-v0.2.0/geardex-mcp-0.2.0.tgz",
        "geardex-mcp"
      ],
      "env": {
        "GEARDEX_STUDIO_API_KEY": "gdx_live_REPLACE_ME"
      }
    }
  }
}
```

Use your Studio API key

Replace  `gdx_live_REPLACE_ME`  with your key. Read tools need read scopes. Tools that change records need the related write scopes. Keep the key in the host config. Do not give the key to other persons.

## Key file

Some hosts cannot set environment variables. For these hosts, use `--key-file`, as in the [Gemini setup](https://www.geardex.app/api-docs/mcp-adapter/gemini).

1. Copy your key.
2. Run the **Save the key** command for your system. The command writes the key to `~/.local/share/geardex/studio-api-key`.
3. In your host, set the command below as the server command.

**Save the key (macOS Terminal)**

```bash
mkdir -p ~/.local/share/geardex && pbpaste > ~/.local/share/geardex/studio-api-key && chmod 600 ~/.local/share/geardex/studio-api-key
```

**Save the key (Windows PowerShell)**

```text
New-Item -ItemType Directory -Force "$HOME\.local\share\geardex" | Out-Null; (Get-Clipboard).Trim() | Set-Content -NoNewline "$HOME\.local\share\geardex\studio-api-key"
```

**Command**

```bash
npx --yes --package https://github.com/dylandersen/geardex-public/releases/download/mcp-v0.2.0/geardex-mcp-0.2.0.tgz geardex-mcp --key-file ~/.local/share/geardex/studio-api-key
```