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). Its 19 documented tools cluster into other, submissions, whoami, facets.

People connecting API integration tools to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-08-18 · ★ 2 · #53 OF 250 MAINTAINED API INTEGRATION · VERIFIED 2026-08-25

MIT · TypeScript servers · how we verify → /methodology

01 · Install Freehire

before you install - you'll need

FREEHIRE_TOKEN

Environment variables documented in the project's README - it lists which are required and which have defaults.

Claude Code

claude mcp add strelov1-freehire-mcp -- npx -y freehire-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "strelov1-freehire-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "freehire-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

repo age created 2026-07-11 - young repo, little track record yet

license MIT - declared in the repository

npm package freehire-mcp - unscoped; check the name against the project README before installing

registry vendor namespace me.freehire - domain-verified with the official MCP registry

03 · What Freehire can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can set the application stage (server-validated), and start (or reopen) tailoring for a vacancy.

Capability map

Tools grouped from the project's README - what Freehire lets an agent do.

other

4 tools - e.g. The caller's tracked jobs (all/viewed/saved/applied) with stage + note.; The caller's tailored CVs with the vacancy each was written for.; A tailored CV's full document.

my · cv_list · cv_get · cv_edit

Submissions

2 tools - e.g. The caller's submissions with status.; Moderator: the review queue.

my_submissions · submissions_pending

Whoami

1 tool - e.g. Authenticated user (verify the key).

whoami

Facets

1 tool - e.g. The filter/skill vocabulary: every facet's live values with counts. Call first.

facets

read & search

1 tool - e.g. Keyword + facet job search; returns jobs with their full description as markdown and the total match count.

search

Market

1 tool - e.g. Score a skill list against live market demand (coverage + gaps).

market_fit

Job

1 tool - e.g. A single job's full content by slug.

job

Company

1 tool - e.g. A company and its open jobs by slug.

company

04 · Who maintains Freehire

freehire is maintained by strelov1. It's the only MCP server we track from this author; the repo dates to Jul 2026.

05 · Facts

category
API integration - ranked #53 of 250 actively-maintained API integration servers as of 2026-08-25.
registry
me.freehire/freehire (active, first published 2026-08-16)
packages
npm:freehire-mcp

06 · Freehire FAQ

Is Freehire still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-18. We re-verify nightly.

What can Freehire do?

With this server connected, an agent can set the application stage (server-validated), and start (or reopen) tailoring for a vacancy.

How do I install Freehire?

Run `npx -y freehire-mcp`. The README documents one environment variable (FREEHIRE_TOKEN) to set first. You can also paste the ready-made client config above.

Does Freehire run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Freehire

More API integration MCP servers · Rhumb MCP · CAPI Gateway · Clickup · Telnyx

More TypeScript MCP servers · Stripe Agent Toolkit · Advanced GitLab MCP server · Local Memory · StudioMeyer Video · Coolify · see all