Get started - Hotfix Jobs

Connect an MCP client to Hotfix MCP with a company API key. You are done when the client lists Hotfix tools for that company.

Before you connect

Mint a company API key at Org → API. Any admin can create one.
Copy the secret when it appears. Prefix is hf_.
Keep the secret in an environment variable or a private config. Do not commit it.

URL:

https://rest.hotfix.jobs/mcp

Connect Cursor

Create .cursor/mcp.json in the project, or ~/.cursor/mcp.json for every project:

{
  "mcpServers": {
    "hotfix": {
      "url": "https://rest.hotfix.jobs/mcp",
      "headers": {
        "Authorization": "Bearer hf_…"
      }
    }
  }
}

Restart Cursor or reload MCP servers, then enable Hotfix. Confirm the client lists Hotfix tools.

Connect Claude Code

Run this in the terminal:

claude mcp add --transport http hotfix https://rest.hotfix.jobs/mcp --header "Authorization: Bearer hf_…"

--scope local is the default (this project, you only). --scope project writes .mcp.json for the team. --scope user is every project for you. If the header would land in a shared file, use an environment variable your shell already has, not the raw secret. Run /mcp in Claude Code and confirm Hotfix is connected.

Connect VS Code

Create .vscode/mcp.json in the workspace:

{
  "servers": {
    "hotfix": {
      "type": "http",
      "url": "https://rest.hotfix.jobs/mcp",
      "headers": {
        "Authorization": "Bearer hf_…"
      }
    }
  }
}

Open the Command Palette and run MCP: List Servers. Start Hotfix. For every workspace, use MCP: Open User Configuration instead.

Connect another client

Add Hotfix as a remote MCP server.

Transport: Streamable HTTP
URL: https://rest.hotfix.jobs/mcp
Header: Authorization: Bearer hf_…

If the client takes JSON:

{
  "mcpServers": {
    "hotfix": {
      "url": "https://rest.hotfix.jobs/mcp",
      "headers": {
        "Authorization": "Bearer hf_…"
      }
    }
  }
}

If the client only speaks local stdio, bridge with mcp-remote and pass the same URL and header. Do not run an unofficial hiring server.

Troubleshooting

A bad or missing key returns 401 before a tool runs.

{
  "error": "invalid_token",
  "error_description": "A valid API key is required."
}

Use https://rest.hotfix.jobs/mcp. mcp.hotfix.jobs is on the host allowlist, but DNS for that host is not wired. There is no OAuth login. If the client asks you to authorize in a browser, switch it to a bearer header. Next: Supported tools.

​Before you connect

​Connect Cursor

​Connect Claude Code

​Connect VS Code

​Connect another client

​Troubleshooting