Skip to main content
Add the Hotfix URL to your MCP client, then sign in with your Hotfix account. You are done when the client lists Hotfix tools for your company.
There is no key to paste. The client opens a browser, you sign in, pick a company if you belong to more than one, and choose Read and write or Read only. The app then acts as you, with your permissions in that company. Any member of the company except Interviewers can connect. Every tool, reads included, needs a live hosted plan. See Authentication for how access and disconnecting work. For claude.ai and ChatGPT, see In Claude or ChatGPT.

​
Connect Cursor

Create .cursor/mcp.json in the project, or ~/.cursor/mcp.json for every project:
Reload MCP servers, enable Hotfix, and click Connect when Cursor asks you to sign in. Confirm the client lists Hotfix tools.

​
Connect Claude Code

Run this in the terminal:
--scope local is the default (this project, you only). --scope project writes .mcp.json for the team. Each person still signs in as themselves. --scope user is every project for you. Run /mcp in Claude Code, pick Hotfix, and choose Authenticate.

​
Connect Codex

Run this in the terminal:
The login command opens the browser. Run /mcp in Codex and confirm Hotfix is listed.

​
Connect VS Code

Create .vscode/mcp.json in the workspace:
Open the Command Palette and run MCP: List Servers. Start Hotfix and allow the sign-in. For every workspace, use MCP: Open User Configuration instead.

​
Connect another client

Add Hotfix as a remote MCP server.
  • Transport: Streamable HTTP
  • URL: https://mcp.hotfix.jobs/hiring
  • Auth: OAuth. Do not set an Authorization header.
The client finds the sign-in server on its own from the 401 response. It can register itself or use a client ID metadata document. If the client only speaks local stdio, bridge with mcp-remote and the same URL. Do not run an unofficial hiring server.

​
Troubleshooting

A request without a valid sign-in returns 401 before a tool runs. The client should start the sign-in flow.
A hf_ key on MCP returns 401 too. Keys are for the HTTP API. Remove the header and sign in. A Read only connection does not list tools that change data. Calling one returns an error. Disconnect the app and connect again with Read and write. If you leave the company, or someone disconnects the app in Settings > Connections > AI apps, the next call returns 401. Sign in again. A sign-in that wasn’t granted access to hiring returns 403 with insufficient_scope. Disconnect the app and connect again, choosing Read only or Read and write.
Too many calls in a short time return 429 with rate_limited. Wait a moment and retry.
Without a live hosted plan, every tool returns an error, reads included. A company that never started a plan is told to start one in Hotfix under Settings > Billing; one whose plan ended is told to reactivate it there. Use https://mcp.hotfix.jobs/hiring as the server URL. Next: Supported tools.