freehire

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

freehire.me: search 3.3M+ IT jobs from 294K company boards, track applications, tailor CVs.

Add to your agent

Copy this into your MCP client config:

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

Measured tools (10)

• check_jobs_open read-only

  Check 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.

  Parameters:

  • slugs (required) — ['null', 'array'] — posting identifiers, as carried by search results' slug; up to 50 are checked per call

  Hints: read-only yes · destructive no · idempotent no · open-world yes

• fetch read-only

  Read 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.

  Parameters:

  • id (required) — string — a result id from search

  Hints: read-only yes · destructive no · idempotent no · open-world yes

• get_company read-only

  Read 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.

  Parameters:

  • slug (required) — string — the employer's identifier, as carried by a result's company_slug

  Hints: read-only yes · destructive no · idempotent no · open-world yes

• get_job read-only

  Read 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.

  Parameters:

  • slug (required) — string — the posting's identifier, as carried by a search result's slug

  Hints: read-only yes · destructive no · idempotent no · open-world yes

• job_market_stats read-only

  How 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.

  Parameters:

  • limit — integer — results per page
  • query — string — free text, matched against title, company, description and location. Operators: double quotes require every quoted word in any order (not a phrase); -word excludes; uppercase OR between terms matches any alternative (at most 5), e.g. golang OR rust; title: at the start of an alternative matches it in the title only, e.g. title:"product owner" OR title:produktchef
  • cities — ['null', 'array']
  • offset — integer
  • skills — ['null', 'array'] — technologies, e.g. go, kubernetes, react
  • regions — ['null', 'array'] — any of global, north_america, latam, eu, uk, mena, africa, apac, cis
  • sources — ['null', 'array'] — job boards to restrict to
  • category — ['null', 'array'] — role family, e.g. backend, frontend, devops, data
  • semantic — ['null', 'boolean'] — true: also match postings that describe the query in other words. Use it for a need described in words, e.g. 'keep our payment systems secure' or 'help kids learn to read'; leave it off for a job title or a non-technical role, which keywords answer better. Needs query
  • countries — ['null', 'array'] — ISO 3166-1 alpha-2 codes, e.g. DE, BR
  • seniority — ['null', 'array'] — any of intern, junior, middle, senior, lead, staff, principal, c_level
  • work_mode — ['null', 'array'] — any of remote, hybrid, onsite
  • relocation — ['null', 'array'] — any of supported (the employer helps you move), required (the role needs you to move), not_supported
  • salary_min — integer
  • company_slugs — ['null', 'array'] — employer identifiers, as carried by a result's company_slug
  • english_level — ['null', 'array'] — CEFR levels, e.g. B2, C1
  • exclude_skills — ['null', 'array'] — technologies the posting must not ask for, e.g. php
  • employment_type — ['null', 'array'] — any of full_time, part_time, contract, internship
  • salary_currency — string — ISO 4217 code, e.g. USD
  • visa_sponsorship — ['null', 'boolean']
  • posted_within_days — integer
  • require_all_skills — boolean — true: every listed skill must be present, not just one
  • exclude_company_slugs — ['null', 'array'] — employers to leave out, as carried by a result's company_slug

  Hints: read-only yes · destructive no · idempotent no · open-world yes

• salary_stats read-only

  Salary 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.

  Parameters:

  • country — string — ISO 3166-1 alpha-2 code, e.g. DE
  • category — string — role family, e.g. backend, frontend, devops, data
  • seniority — string — any of intern, junior, middle, senior, lead, staff, principal, c_level

  Hints: read-only yes · destructive no · idempotent no · open-world yes

• search read-only

  Search freehire's IT job postings by free text. Returns matching postings as {id, title, url}.

  Parameters:

  • query (required) — string — free text describing the jobs to find

  Hints: read-only yes · destructive no · idempotent no · open-world yes

• search_companies read-only

  Find 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.

  Parameters:

  • limit — integer
  • query — string — free text, matched against the employer's name
  • offset — integer
  • countries — ['null', 'array'] — ISO 3166-1 alpha-2 codes the employer hires in

  Hints: read-only yes · destructive no · idempotent no · open-world yes

• search_jobs read-only

  Search 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. 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.

  Parameters:

  • limit — integer — results per page
  • query — string — free text, matched against title, company, description and location. Operators: double quotes require every quoted word in any order (not a phrase); -word excludes; uppercase OR between terms matches any alternative (at most 5), e.g. golang OR rust; title: at the start of an alternative matches it in the title only, e.g. title:"product owner" OR title:produktchef
  • cities — ['null', 'array']
  • offset — integer
  • skills — ['null', 'array'] — technologies, e.g. go, kubernetes, react
  • regions — ['null', 'array'] — any of global, north_america, latam, eu, uk, mena, africa, apac, cis
  • sources — ['null', 'array'] — job boards to restrict to
  • category — ['null', 'array'] — role family, e.g. backend, frontend, devops, data
  • semantic — ['null', 'boolean'] — true: also match postings that describe the query in other words. Use it for a need described in words, e.g. 'keep our payment systems secure' or 'help kids learn to read'; leave it off for a job title or a non-technical role, which keywords answer better. Needs query
  • countries — ['null', 'array'] — ISO 3166-1 alpha-2 codes, e.g. DE, BR
  • seniority — ['null', 'array'] — any of intern, junior, middle, senior, lead, staff, principal, c_level
  • work_mode — ['null', 'array'] — any of remote, hybrid, onsite
  • relocation — ['null', 'array'] — any of supported (the employer helps you move), required (the role needs you to move), not_supported
  • salary_min — integer
  • company_slugs — ['null', 'array'] — employer identifiers, as carried by a result's company_slug
  • english_level — ['null', 'array'] — CEFR levels, e.g. B2, C1
  • exclude_skills — ['null', 'array'] — technologies the posting must not ask for, e.g. php
  • employment_type — ['null', 'array'] — any of full_time, part_time, contract, internship
  • salary_currency — string — ISO 4217 code, e.g. USD
  • visa_sponsorship — ['null', 'boolean']
  • posted_within_days — integer
  • require_all_skills — boolean — true: every listed skill must be present, not just one
  • exclude_company_slugs — ['null', 'array'] — employers to leave out, as carried by a result's company_slug

  Hints: read-only yes · destructive no · idempotent no · open-world yes

• similar_jobs read-only

  Postings 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.

  Parameters:

  • slug (required) — string — the posting's identifier, as carried by a search result's slug
  • limit — integer — how many to return, up to 20

  Hints: read-only yes · destructive no · idempotent no · open-world yes

Publisher website Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.