freehire — MCP server for Claude Code: IT job search
Searches the company-board catalogue and tracks applications from inside the chat. Handy when opening a browser for another vacancy feels like too much.
claude mcp add --transport http freehire https://freehire.me/api/v1/mcpWhat freehire does
The server wraps the freehire.me API and gives the agent tools for a job hunt. Postings come straight off company career pages: 3.3M+ roles at 294K companies, normalised into one schema and tagged by stack, seniority, region and work mode.
A read-only endpoint needs no install and no key. With an fhk_… key from the account you also get application tracking, notes and stages, plus CV tailoring. The token resolves from FREEHIRE_TOKEN, otherwise the server reads ~/.freehire/creds.json, the same file the CLI uses. It never writes that file: signing in stays with the CLI.
region, country and city behave as a single OR group, so region: ["eu"] plus country: ["IT"] returns Europe and Italy together. A misspelled filter does not fail the query, it widens it, and the key shows up in ignored. Without a token the tools answer with an auth error, while the server itself still starts. Any claim in a CV must point at an evidence_id from experience_list, or cv_edit rejects the edit.
What it helps with
- find roles by stack, seniority and work mode
- score a skill set against live demand
- rewrite a CV for a specific vacancy
- keep stages and notes for each application
- render a tailored CV as a PDF
Example prompts for the agent
- List the skill facets, then find Python roles in Europe.
- Score my stack — Python, PostgreSQL, Kubernetes — where do I have gaps?
- Start tailoring my CV for that vacancy and show the gaps to close.
How to install freehire
1Platform CLI: remote server
claude mcp add --transport http freehire https://freehire.me/api/v1/mcp2Platform CLI
claude mcp add --env FREEHIRE_TOKEN=<FREEHIRE_TOKEN> --env FREEHIRE_API_URL=<FREEHIRE_API_URL> --transport stdio freehire -- npx -y freehire-mcpReplace <…> with your own values
1Platform CLI: remote server
codex mcp add freehire --url https://freehire.me/api/v1/mcp2Platform CLI
codex mcp add freehire --env FREEHIRE_TOKEN=<FREEHIRE_TOKEN> --env FREEHIRE_API_URL=<FREEHIRE_API_URL> -- npx -y freehire-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"freehire": {
"url": "https://freehire.me/api/v1/mcp"
}
}
}{
"mcpServers": {
"freehire": {
"command": "npx",
"args": [
"-y",
"freehire-mcp"
],
"env": {
"FREEHIRE_TOKEN": "<FREEHIRE_TOKEN>",
"FREEHIRE_API_URL": "<FREEHIRE_API_URL>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"freehire": {
"type": "http",
"url": "https://freehire.me/api/v1/mcp"
}
}
}{
"servers": {
"freehire": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"freehire-mcp"
],
"env": {
"FREEHIRE_TOKEN": "<FREEHIRE_TOKEN>",
"FREEHIRE_API_URL": "<FREEHIRE_API_URL>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http freehire https://freehire.me/api/v1/mcp2Platform CLI
gemini mcp add -e FREEHIRE_TOKEN=<FREEHIRE_TOKEN> -e FREEHIRE_API_URL=<FREEHIRE_API_URL> freehire npx -y freehire-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about freehire
How do I install freehire in Claude Code?
For the keyless remote endpoint run claude mcp add --transport http freehire https://freehire.me/api/v1/mcp. For the local server with application tracking run claude mcp add --env FREEHIRE_TOKEN=<FREEHIRE_TOKEN> --env FREEHIRE_API_URL=<FREEHIRE_API_URL> --transport stdio freehire -- npx -y freehire-mcp.
What does freehire do?
It gives the agent job-search tools over the IT posting catalogue. With a token it also tracks applications, keeps an experience bank and tailors a CV to a vacancy, with PDF output.
How is this different from the freehire CLI?
Same API and same credentials, exposed as MCP tools rather than shell commands.
