Server data from the Official MCP Registry
freehire.me: search 3.3M+ IT jobs from 294K company boards, track applications, tailor CVs.
About
freehire.me: search 3.3M+ IT jobs from 294K company boards, track applications, tailor CVs.
Security Report
A well-architected MCP server for job search and application tracking with proper authentication, clear permission scoping, and solid code quality. The server requires API credentials, authenticates all requests, and implements appropriate error handling. Minor code quality observations exist but do not create security vulnerabilities. Supply chain analysis found 3 known vulnerabilities in dependencies (0 critical, 3 high severity). Package verification found 1 issue.
7 files analyzed · 7 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
What You'll Need
Set these up before or after installing:
Environment variable: FREEHIRE_TOKEN
Environment variable: FREEHIRE_API_URL
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"me-freehire-freehire": {
"env": {
"FREEHIRE_TOKEN": "your-freehire-token-here",
"FREEHIRE_API_URL": "your-freehire-api-url-here"
},
"args": [
"-y",
"freehire-mcp"
],
"command": "npx"
}
}
}Documentation
View on GitHubFrom the project's GitHub README.
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:
| What | Sources |
|---|---|
| Token | FREEHIRE_TOKEN → creds file |
| API base URL | FREEHIRE_API_URL → creds file → 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
| Tool | Purpose |
|---|---|
whoami | Authenticated user (verify the key). |
facets | The filter/skill vocabulary: every facet's live values with counts. Call first. |
search | Keyword + facet job search; returns jobs with their full description as markdown and the total match count. |
market_fit | Score a skill list against live market demand (coverage + gaps). |
job | A single job's full content by slug. |
company | A company and its open jobs by slug. |
apply | Mark a job applied. |
save / unsave | Bookmark / remove a bookmark. |
stage | Set the application stage (server-validated). |
note | Attach a free-text note. |
my | The caller's tracked jobs (all/viewed/saved/applied) with stage + note. |
cv_context | The fit analysis a tailored CV should reframe toward (missing_have vs missing_gap). |
cv_get | A tailored CV's full document. |
cv_edit | Apply a batch of path-addressed edits to a tailored CV, atomically (server-validated; uncited claims are refused). |
cv_render | Render a tailored CV to a PDF, returned as a base64 application/pdf resource. |
submit | Submit a vacancy for moderation. |
my_submissions | The caller's submissions with status. |
jobs_add / jobs_edit | Moderator: author / edit a job (403 without the role). |
submissions_pending | Moderator: the review queue. |
submission_approve / submission_reject | Moderator: decide on a submission. |
Filters. search, market_fit, and facets share the same market-filter
parameters: remote, region, country, city, company, category, role,
seniority, employment_type, english_level, salary_min, visa, plus a generic
facets map ({"source": "greenhouse"}) for any other facet in the vocabulary.
Discover valid values with the facets tool — do not invent them. In search, skills
is a filter; in market_fit, skills is the measured set.
Descriptions. search reads the API's agent endpoint, so every hit already carries
the posting's full description rendered as markdown — a host can screen a result set
without a job call per hit. Descriptions are long, so keep limit modest.
Each tool returns the raw API data as JSON text; an API error becomes an isError
result carrying the HTTP status (a 401 adds an auth hint).
Develop
npm install
npm test # vitest: config, client (mock server), facets, tool dispatch
npm run build # tsc → dist/
License
MIT — see LICENSE. The freehire backend and CLI are MIT too.
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Fetch
Freeby Modelcontextprotocol · Developer Tools
Web content fetching and conversion for efficient LLM usage
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
MarkItDown
Freeby Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
FinAgent
Freeby mcp-marketplace · Finance
Free stock data and market news for any MCP-compatible AI assistant.