Skip to content
MCP server

freehire

Search IT jobs, track applications and tailor CVs from Claude, ChatGPT or a terminal

Pricing
Freemium
Platforms
Web, CLI, API
Runs
Locally or Remotely
Version
0.8.0
Listing updated
3 days ago

About freehire

freehire is a freemium MCP server for hiring and recruiting. It can run locally on your machine or as a hosted remote server.

The README describes a catalogue of more than 4.9 million open jobs from 437 sources, with 680,000 company profiles and 178 applicant-tracking platforms, as of a November 5, 2026 snapshot. Jobs can be found by stack, salary, seniority, work mode and location, and a market-fit command shows how much of the live market your skills cover and where the gaps are.

Two ways to connect exist. The hosted endpoint at freehire.me/api/v1/mcp allows public search without an account and OAuth for personal tools such as saved jobs, tracking, alerts and reports. The npm server uses a personal API key and adds CV and experience-bank tools, mirroring a separate Go CLI. Saving or marking a job applied updates your tracking board; actually applying happens on the employer's site unless you enable automatic applications.

The bundled skill sends two kinds of reports without asking: suggest_dictionary_term for skills or industries the catalogue does not recognise, and report_problem for failures, stripped of credentials, CV text and contact details.

Install

Run in a terminal

claude mcp add --transport http freehire https://freehire.me/api/v1/mcp

Add to Settings → Connectors → Add custom connector

https://freehire.me/api/v1/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "freehire": {
      "url": "https://freehire.me/api/v1/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "freehire": {
      "type": "http",
      "url": "https://freehire.me/api/v1/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "freehire": {
      "serverUrl": "https://freehire.me/api/v1/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "freehire": {
      "type": "http",
      "url": "https://freehire.me/api/v1/mcp"
    }
  }
}

Configuration

  • FREEHIRE_TOKENA freehire personal API key (freehire.me -> account menu -> API keys). Optional: if omitted, the server reads the key the freehire CLI stored in ~/.freehire/creds.json.
  • FREEHIRE_API_URLOverride the API base URL. Defaults to https://freehire.me.

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

suggest_dictionary_term
Submits an unrecognised skill, specialization or industry for dictionary review.
report_problem
Sends a minimal report about a failed operation or missing capability.

What it does

Large job catalogue
Searches jobs aggregated from many company boards.
Market-fit check
Shows how much of the live market your skills cover.
Tracking board
Saved, applied and staged jobs, with notes and inbox linking.
CV tailoring
Reframes your CV toward a job and exports an ATS-ready PDF.
Hosted and local servers
OAuth hosted endpoint or an API-key npm server.
Ghost-job warnings
Flags suspicious postings, per the pricing page.

Good for

  • Find senior remote Go roles in Europe
  • See which skills to learn for a target market
  • Track applications from saved to offer
  • Tailor a CV to one posting
  • Set alerts by email or Telegram

Pricing

Freemium, from $5 a month

Free for job seekers; Pro $5/mo; Jobs API $29/mo and Data $99/mo billed separately

Prices change. Check freehire.me before you buy.

freehire FAQ

Is it free?

Finding and tracking jobs is free, including over MCP and the CLI; Pro at $5 a month adds CV tailoring, an assistant and auto-apply.

Do I need an account to search?

Public search on the hosted endpoint works without one.

Does it apply for me?

Only if you enable the account setting for connected agents; otherwise you apply on the employer's site.

Is there a data API?

Yes, plans at $29 and $99 a month license the data for products.

Is freehire free?

freehire has a free plan, with paid plans for more usage or features. Paid plans start at $5 a month.

How do I add freehire to Claude Code?

Run this command in your terminal: claude mcp add --transport http freehire https://freehire.me/api/v1/mcp

What are the best alternatives to freehire?

The closest alternatives to freehire are Reactive Resume, HeyRole, Nectar Jobs, TeamedUp Intelligence — China & APAC Salary Data and AI Scouts.

Alternatives to freehire

  1. Reactive Resume

    MCP server

    Open-source resume and cover letter builder with job tracking and an MCP endpoint

    • Remote
    • Open source
    • Hiring and recruiting
  2. HeyRole

    MCP server

    Search remote jobs, read postings and get application links, no account needed

    • 3 tools
    • Remote
    • Free
    • Hiring and recruiting
  3. Nectar Jobs

    MCP server

    Search over a million live job postings with salaries, filters and CV matching

    • 7 tools
    • Remote
    • Free
    • Hiring and recruiting
  4. AI Scouts

    MCP server

    Let agents send AI interviewers to your team and get transcripts and cited findings

    Not checked yet
    • Remote
    • Freemium
    • Productivity
  5. Spanish tech salaries by company plus daily job openings your agent can apply to

    • 8 tools
    • Remote
    • Free
    • Hiring and recruiting