freehire MCP server
online · 100% uptimeme.freehire/freehire·v0.8.0·16 starsfreehire.me: search 3.3M+ IT jobs from 294K company boards, track applications, tailor CVs.
16 stars486 downloads/wk
Reviews
Write oneNobody has reviewed freehire yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
freehire tools (11)
write = sends, deletes, buys or postscheck_jobs_openFreeCheck whether postings are still open, by the slugs search results carry — up to 50 per call. Use before acting on a saved shortlist: each posting answers open, closed or not_found, with when it closed or was last seen live.
fetchFreeRead one posting in full by an id search returned: its full text, the employer, the board it came from and whether it still looks live.
get_companyFreeRead what freehire holds about one employer by the slug a result carries: what they do, which industries they are in, where they are based, and how many postings they have open.
get_jobFreeRead one posting in full by the slug a search result carries: the whole description, the stated requirements, which applicant tracking system handles applications, and whether the posting still looks live — when it was last seen open, a reality class, and any observed signs that it is not being filled.
job_market_statsFreeHow many open postings match a set of filters, and their most common role families, seniorities, skills, work modes, countries and regions. Takes the same filters as a job search.
list_filter_valuesFreeThe values one job-search filter accepts — skills, categories, seniorities, sources, countries and the rest — each with how many open postings carry it, most common first. A value not listed matches no posting. Use it before filtering on a value you are not sure of.
salary_statsFreeSalary percentiles (25th, median, 75th) from open postings that state pay, scoped by role family, seniority and country, with the sample size behind each figure. Currencies and pay periods are reported separately, never converted.
searchFreeSearch freehire's IT job postings by free text. Returns matching postings as {id, title, url}.
search_companiesFreeFind employers in freehire's catalogue by name or by where they hire, with how many postings each has open. Use when the question is about a company rather than about a role.
search_jobsFreeSearch freehire's catalogue of IT job postings. Use for any question about which jobs are open — by technology, seniority, location, pay or employer. Returns a short preview of each posting. A role has several names: join two or three in one query with OR, e.g. title:SRE OR title:"site reliability". Location, work mode, seniority and skills go in their filters, never in the query. If suspiciously few results come back, loosen one constraint at a time and say which. Present results as a table of title, company, location, posted date and link (the employer's posting and ours), naming the source. Set semantic for a need described in words ("keep our payment systems secure"), not for a job title or a non-technical role, where plain keywords answer better.
similar_jobsFreePostings most similar to one posting, by its slug, nearest first — for "show me more like this". Empty for the newest postings, whose neighbours are not computed yet.
Public scan report
scanner v0.1.10 · 2026-11-03 · same rubric, same numbers if you re-run it
- Code scan7 source files scanned25/25
- Live reliabilityremote reachable in 1205ms20/20
- Tool poisoning11 tool descriptions checked15/15
- Auth qualityopen endpoint, read-only tools10/15
- Maintenancelast push 6 days ago15/15
- Maintainer identityendpoint served from the registry-verified namespace domain8/10
How freehire compares
Against every graded Web search MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 93/100
- higher than 95% of 3,470 Web search servers
- Tools
- 11
- the typical Web search server has 5
- Tools that change things
- 0%
- typical: 0%. Fewer write tools means less an agent can break
- Uptime
- 100%
- of our recent checks; the typical remote Web search server answers 100%
- Response time
- 372 ms
- faster than 42% of 2,238 Web search servers
- GitHub stars
- 16
- more than 88% of 1,786 Web search servers
- Downloads a week
- 486
- more than 85% of 827 Web search servers with a package
What its tools let an agent do: 11 read
Release history: 3 versions in the registry since 2026-08-16, latest 2026-10-28, typically one every 59 days.
Install freehire in Claude Code, Cursor or VS Code
claude mcp add --transport http freehire https://freehire.me/api/v1/mcp
What the publisher says
From the freehire repository's README, as published. We do not edit it. Read it on GitHub
freehire MCP server
An MCP server over the freehire job API. It lets any MCP host — Claude Desktop, Claude Code, or a compatible agent — search, filter, and apply to IT jobs without a browser, authenticating with a personal API key. Postings are crawled straight from company career boards — 3.3M+ open roles across 294K companies, normalized into one schema and tagged with stack, seniority, region and work mode (live figures).
It mirrors the freehire CLI: same API, same credentials, exposed as MCP tools instead of shell commands.
Install
No global install needed — the host runs it via npx. Add it to your host's MCP configuration (Claude Desktop → Settings → Developer → Edit config, or ~/.claude.json for Claude Code):
{
"mcpServers": {
"freehire": {
"command": "npx",
"args": ["-y", "freehire-mcp"],
"env": { "FREEHIRE_TOKEN": "fhk_xxxxxxxx" }
}
}
}Create the fhk… key in the web app (freehire.me → account menu → API keys). If you already use the freehire CLI (freehire auth login), you can omit env** — the server reads the same ~/.freehire/creds.json.
Authentication
The token and API base URL resolve with precedence env → ~/.freehire/creds.json → default https://freehire.me:
The server only reads the credentials file (it never writes it — logging in stays the CLI's job). If no token is configured, tools return a clear "not authenticated" error rather than the server failing to start.
Tools
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Grade history
- 2026-11-03restoreB → Ascore 93
freehire: common questions
- Is freehire MCP server safe?
- Yes, by our scan: it is graded A (93/100). Read the freehire safety report
- How do I install freehire?
- It runs remotely at freehire.me. Add it to Claude Code, Cursor, VS Code or Claude Desktop with the snippets above, or call it through the mcp.market gateway without installing anything.
- Does freehire need an API key?
- Yes. The registry entry asks for
FREEHIRE_TOKEN. - Is freehire maintained?
- The last commit was 6 days ago (2026-10-28). The latest release is v0.8.0.
- Is freehire up?
- 100% of our last 28 checks got an answer. We check remote servers about four times a day.
- What can I use instead of freehire?
- Servers from other publishers that do the same job: Workopia — Job Search MCP server, The Company Atlas MCP server and Kody MCP server.
- How does freehire compare with other Web search MCP servers?
- safety score 93/100 (higher than 95% of 3,470 Web search servers); tools 11 (the typical Web search server has 5); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to freehire
Same job from other publishers: the closest match first, then the best rated.
- Workopia — Job SearchSearch 6.3M+ live jobs from companies' own career pages, plus resume tailoring & cover letters.not reviewedGrowingB
- The Company AtlasGlobal customs trade data and company registry. Search shipments, and look up legal entities.5.0(1)NewB
KodyYour agents' cloud for individuals and teams. Search, execute, packages, jobs, and credentials.not reviewedEstablishedA- GEO Tracker by DigestSEOTrack brand citations across seven AI search surfaces. Free OSS; optional EUR 99 client-ready audit.not reviewedEstablishedB
- JobseekSearch jobs and companies on Job Seek (jseek.co)not reviewedEstablishedA