Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words

freehire

✓ service owner · freehire.me

by strelov1version 0.8.0i★ 17iComputer or cloudOfficial site ↗
Registry nameme.freehire/freehire

How to install

What it does

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

  • Connects Computer or cloud
  • Account or key Cloud: Sign in to the service when you connect (OAuth) · Local: No key needed
  • Category Search & AI memory

Use together with

Skills that teach the AI this kind of work; they work alongside this one

timesfm

TimesFM (Time Series Foundation Model) is a pretrained time-series foundation model developed by Google Research for time-series forecasting.

by google-research★ 35,6381 skills

Skill · How-to guide

Shadowbroker

Open-source intelligence for the global theater. Track everything from the corporate/private jets of the wealthy, and spy satellites, to seismic events in one unified interface. Hook an AI agent up to have it parse through data and find previously unseen correlations. The knowledge is available to…

by BigBodyCobain★ 11,6051 skills

Skill · How-to guide

google-maps-scraper

scrape data from Google Maps. Extracts data such as the name, address, phone number, website URL, rating, reviews number, latitude and longitude, reviews,email and more for each place

by gosom★ 8,2361 skills

Skill · How-to guide

Why it ranks here

This one is in the “Apps that connect to AI” tab, which is ordered without stars, in this order

1. In Claude’s connector directoryNo
2. Tried by our teamNo
3. Works for Thai usersNo
4. Usage without stars20/100Popularity 0 · Freshness 12 · Still answering 8 · Likes from users +0
5. Listed on2026-10-28

Likes from users: 0 · Adds at most 5 points to the order (1 per person). It cannot be bought.

Quality: Passed 6/6 basic checks (shown, not used for ordering)

Install

Pick the AI app you use, then copy the settings.

Let your AI install it with one sentence

Please install freehire. Follow https://mcp.popnx.com/i/me-freehire-freehire.md, show me the commands and wait for my OK before running them.

Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads

Passed 6/6 checks · What you ask goes through the maker’s server (freehire.me) · ✓ Commands checked Nov 14, 2026

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude · about 2 min

No key, nothing to install · Set it up once on claude.ai or the desktop app, then use it in chat · free accounts can add 1 · on Team/Enterprise an Owner adds it

  1. Open Claude’s Connectors page

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Click “Add” → “Custom” → “Web” and fill in these 2 fields

    Copy each value into the field with the same name in Claude, then click Continue

    Name · Namefreehire
    Remote MCP server URL · Addresshttps://freehire.me/api/v1/mcp

    Click Continue past the sign-in settings Claude detected · under Authentication choose what the maker says (Sign in now, Sign in when needed or No sign in), then click Add

  3. Turn it on in a chat

    +Connectorsfreehire

  4. Try it

    Use freehire and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using freehire or shows a freehire tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with ChatGPT, depending on your plan

Full MCP: ChatGPT Business, Enterprise or Edu on the web · Pro: connects with read/fetch permissions, so tools that change data may not work · Plus: not confirmed in OpenAI’s docs; if you see an add-custom-MCP option on the Plugins page you can try these steps · web only

  1. Open ChatGPT’s add-MCP page on the web

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Fill in the name and address

    Enter a name, paste the address under Connection, tick the risk warning and click Create as a plugin

    Name · Namefreehire
    Connection · Addresshttps://freehire.me/api/v1/mcp
  3. Pick freehire in a chat

    Start a new chat and pick freehire from your plugins before typing

  4. Try it

    Use freehire and tell me what you can do for me, then show me one thing

    ✓ If ChatGPT says it is using freehire or shows a freehire tool in the answer, you are connected

Menu names checked against OpenAI’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Claude Code · about 2 min

No key, nothing to install

  1. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: open PowerShell

  2. Paste this command and press Enter

    claude mcp add --transport http --scope user freehire https://freehire.me/api/v1/mcp
  3. Type /mcp in Claude Code

    You should see freehire listed as connected

  4. Try it

    Use freehire and tell me what you can do for me, then show me one thing

    ✓ If Claude Code says it is using freehire or shows a freehire tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor · about 2 min

No key, nothing to install

  1. Click this button to open Cursor

    Open in Cursor

    Cursor asks you to confirm; click Install

  2. Open the AI chat in Cursor in Agent mode

  3. Try it

    Use freehire and tell me what you can do for me, then show me one thing

    ✓ If Cursor says it is using freehire or shows a freehire tool in the answer, you are connected

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code · about 2 min

No key, nothing to install

  1. Click this button to open VS Code

    Open in VS Code

    VS Code asks you to confirm; click Install

  2. Open the AI chat in VS Code in Agent mode

  3. Try it

    Use freehire and tell me what you can do for me, then show me one thing

    ✓ If VS Code says it is using freehire or shows a freehire tool in the answer, you are connected

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

Address for apps that connect over the web

Addresshttps://freehire.me/api/v1/mcp

JSON settings are under “For developers” below

Stuck? Ask people who use freehire💬 Discussion →
For developers: Terminal commands and JSON settings

Over the web

Claude Code

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

Cursor (~/.cursor/mcp.json)

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

VS Code (mcp.json)

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

Installed on your computer

Claude Code

claude mcp add --scope user freehire -- npx -y freehire-mcp

Claude Desktop (claude_desktop_config.json)

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

Cursor (~/.cursor/mcp.json)

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

VS Code (mcp.json)

{
  "servers": {
    "freehire": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "freehire-mcp"
      ]
    }
  }
}

Values you fill in

  • FREEHIRE_TOKEN secret env
    A 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_URL env
    Override the API base URL. Defaults to https://freehire.me.

Descriptions are as written by the maker.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

Downloads per weeki
160/wk
Verified domain
✓ freehire.me
Connection
Computer or cloud
Transport
stdio, streamable-http
Latest versioni
0.8.0
Published to registryi
Oct 29, 2026
Code last changedi
Nov 5, 2026
Last checked
Nov 19, 2026
Maker
strelov1
Packages
npm: freehire-mcp
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Connect over the internet in

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

Run on your computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

All apps, with pros and cons →

Related guides

What it can do

Tool names and descriptions exactly as the server reported them on Nov 19, 2026. The maker wrote them, not us; we show them as plain text.

  • add_cv

    Store the person's own CV, as text, for an account that has no CV yet. Pass the CV they supplied verbatim — text they pasted, or the content of a CV file they gave you. Never compose, summarise or embellish a CV: it is stored as theirs and its work history is recorded as their ow

  • answer_bank_delete

    Delete one of the person's saved screening answers by the id answer_bank_list shows.

  • answer_bank_list

    List the person's saved answers to employers' open-ended screening questions ("Why do you want to work here?", "Desired start date?"). Automatic applications reuse them on every form that asks the same question.

  • answer_bank_save

    Save the person's answer to one screening question an employer's form asks, so automatic applications can send it — use the question's wording from auto_apply_get. The answer is sent to employers in the person's name: pass on what THEY said, never an answer you composed or guesse

  • apply_job

    Mark a vacancy as applied to. This records the user's own application; it does not submit anything to the employer.

  • auto_apply_cancel

    Withdraw an automatic application that has not been submitted. Refused while it is being submitted. Its history is kept.

  • auto_apply_get

    Read where one automatic application stands: its status, the questions it stopped on, the answers still missing before submission, its full history, and what to do next. Call it again to follow progress — history only grows.

  • auto_apply_list

    List the person's automatic applications: every live one with its status and when anything last happened to it, and the ones submitted in the last 30 days. Use auto_apply_get for one attempt's questions and history.

  • auto_apply_retry

    Restart an automatic application that stopped — on an unanswered question, after repeated errors, or because the CV could not be tailored — or refresh one awaiting review so newly saved answers are reflected. Answer the open questions with answer_bank_save or screening_answers_se

  • auto_apply_review

    Record the review of an automatic application whose status is pending_review. "approved" lets freehire submit it to the employer with the tailored CV and the answers auto_apply_get shows; "declined" stops it for good. One decision per attempt.

  • auto_apply_start

    Start applying to a vacancy automatically on the person's behalf. freehire tailors their CV to the vacancy, checks the employer's application form against their saved answers, and waits for a review (auto_apply_review) before submitting. Spends one of today's auto-apply allowance

  • buddy_join

    Join freehire's interview buddy network under a generated anonymous handle, or rejoin under the old one. Members can book and host 60-minute mock interviews with each other. Returns the membership status.

  • buddy_leave

    Leave the interview buddy network. Closes the person's buddy conversations and cancels every upcoming mock interview they host or attend; the other participants are told. Rejoining later restores the same handle.

  • buddy_mock_book

    Book a 60-minute mock interview with a host, the person attending as guest. starts_at must be one of the host's open slots exactly (RFC 3339) and topic one of the topics that host offers. Returns the booked mock with the counterpart's handle and the meeting link. A guest may hold

  • buddy_mock_cancel

    Cancel one of the person's upcoming mock interviews, by id, before it starts. The other participant is told.

  • buddy_mock_hosts

    Members of the buddy network the person could book a 60-minute mock interview with now, soonest available first: each host's handle, a coarse card (category, seniority, country), the topics they offer, their next open slot and their review rating. Never includes a meeting link.

  • buddy_mock_list

    The person's own mock interviews, upcoming and past, as host or guest: id, role, the counterpart's handle, times, topic, status, the meeting link while confirmed, whether it can still be cancelled, and the reviews.

  • buddy_mock_schedule_add_override

    Add one dated override to the person's hosting schedule: on that date they host between start and end (HH:MM) instead of their weekly hours. An equal start and end closes the date. Returns the stored rule with its id.

  • buddy_mock_schedule_delete

    Delete one rule (weekly or dated override) of the person's hosting schedule, by its id.

  • buddy_mock_schedule_get

    The person's own mock-interview hosting setup: settings (time zone, meeting link, topics offered, paused) or null before they were first saved, and the schedule rules — weekly rules by weekday (0 = Sunday) and dated overrides, each with the id needed to delete it.

  • buddy_mock_schedule_set_weekly

    Replace the person's whole recurring weekly hosting schedule with these weekday rules (an empty list clears it). Times are HH:MM in their settings' time zone. Dated overrides are kept and are not accepted here.

  • buddy_mock_settings_set

    Replace the person's mock-interview hosting settings as a whole: the time zone their schedule is in, the meeting link guests receive, the topics they offer, and whether hosting is paused. Returns the saved settings.

  • buddy_mock_slots

    The open 60-minute mock-interview slots of one host, by handle, and the topics that host offers. Each slot's starts_at is the exact RFC 3339 instant to book. Covers the next 30 days unless from/to say otherwise, at most 62 days. Never includes a meeting link.

  • buddy_status

    Whether the person is a member of freehire's interview buddy network, and their anonymous handle there. Members are known to each other only by handle. Membership is needed for every mock-interview action.

  • check_jobs_open

    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.

  • facets

    List the live filter vocabulary. Without `facet`: every filter's name with how many values it has, plus numeric ranges. With `facet`: that filter's values with a vacancy count each, optionally only those containing `contains`. Filter values are the market's own; an invented one m

  • fetch

    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.

  • get_company

    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.

  • get_job

    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

  • get_plan

    Read the signed-in account's plan ("free", "pro" or "ultra") and today's allowance of each metered AI feature: limit, used and remaining, all resetting at resets_at (UTC). paid_until is the end of the current paid period (it may renew; see plan_url). Here the metered feature is "

  • get_profile

    Read the user's saved job-search profile: the roles and skills they want, the skills they want to avoid, where and how they will work, and their CV (headline, years, experience, education — contacts are not included). Call this before asking the user what they are looking for; on

  • get_setup_status

    Report what this account still needs to get value from freehire: a CV (and whether reading it has finished), job-search preferences, an active job alert, and — only needed for applications prepared on the person's behalf — a paid plan and the switch letting connected agents apply

  • job_market_stats

    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.

  • list_filter_values

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

  • list_subscriptions

    List the person's job alerts with every setting: id, name, a readable filter summary AND the search as the structured object the alert tools take (query, filters, salary_min/max; `other` holds website-only filters an update keeps), whether it is paused, and each delivery channel

  • list_unread_mail

    The person's newest unread application mail in their freehire inbox: the sender's display name and address, subject, received time, the label freehire classified it as (interview_invitation, rejection, offer, …) and, when it is attached to a tracked job, that company and job slug

  • market_fit

    Score a skill list against the live open-vacancy market for a filtered role: what share of vacancies list at least one of the skills, which must-have skills are held, and which missing skills unlock the most vacancies. Here `skills` is the MEASURED set, not a filter.

  • my_jobs

    List the vacancies the user is tracking — saved, applied, viewed or the whole board — with each one's stage and note.

  • report_job

    File a report on a vacancy that looks fake, spam, a scam, irrelevant, or that never answers. It goes to freehire's moderators, who review it by hand; it does not hide the job or change the user's own board. Only report when the user asks for it, or after you have told them what y

  • report_problem

    Report a freehire operation you could not complete, a missing capability, or unexpected behavior for the team to triage. Give concise summaries of the user's goal, expected result, and actual failure. Include a tool name and error code when known. Do not include conversations, CV

  • salary_stats

    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.

  • save_job

    Bookmark a vacancy for the user. Idempotent.

  • screening_answers_get

    Read the person's answers to the six screening questions that repeat across application forms: countries they may work in, visa sponsorship, desired salary, notice period, relocation, and being 18 or older — plus privacy_consent, whether they agree to an employer's privacy / pers

  • screening_answers_set

    Record the candidate's own answer to one or more of the six screening questions that repeat across job-application forms: which countries they are authorized to work in, whether they need visa sponsorship, their desired salary, their notice period, whether they are willing to rel

  • search

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

  • search_companies

    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.

  • search_jobs

    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. A role has several names: join two or three in one query with OR, e.g. title:SRE OR title

  • similar_jobs

    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.

  • subscribe

    Create a job alert: a saved search over ANY of the job search's filters whose new postings are delivered to the person on the channels their account has connected (email, Telegram, the mobile app, a webhook) — this conversation is not notified. e.g. remote senior Go roles in the

  • subscription_updates

    List the new postings the person's job alerts have matched — the same matches their alerts are built from, newest first, still-open postings only. Narrow to one alert by id, and to a window by since (RFC 3339) or days (default 7, max 30). An alert only matches postings that appea

  • suggest_dictionary_term

    Request review of a missing specialization, skill or company industry, as on freehire's dictionary page. This records a suggestion, not a new working filter or a vacancy. Existing terms and aliases are refused. Repeated requests share the existing queue entry and increase request

  • track_job

    Set the application stage and/or a free-text note on a vacancy the user is tracking. Omit a field to leave it unchanged. Valid stages: preparing, applied, screening, responded, interview, offer, accepted, rejected, withdrawn, expired.

  • unsave_job

    Remove a vacancy from the user's bookmarks. Idempotent.

  • unsubscribe

    Stop one job alert by its id, on every channel or on the one named. Effect: deletes the alert's delivery on those channels and their record of matches; the saved search itself stays on the account as a bookmarked search.

  • update_profile

    Change the user's saved profile: the preferences (roles, skills, seniority, languages, location) and the headline and summary text shown on their profile page. This changes their account, so say what you are about to change and get the user's agreement first. Call get_profile fir

  • update_subscription

    Change one of the person's job alerts by its id. Every field is optional and only the ones given change: name; the search (query, filters, salary_min, salary_max — each replaces that part, an empty filters object clears the facet filters, a salary bound of 0 clears it; website-on

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 20, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified against the domain freehire.me (the registry checks domain ownership)

  • ✓ Pass

    Still maintained

    Code last changed 15 days ago

  • ✓ Pass

    Has a licence

    Uses MIT

  • ✓ Pass

    Endpoint responds

    Responded in 22 ms (HTTP 401)

  • ✓ Pass

    Sign-in with OAuth

    Declares OAuth sign-in, so your AI app can take you to log in

  • ✓ Pass

    No hidden instructions in tool descriptions

    Read 56 tool descriptions and found no hidden instructions to the AI

The cloud address answered 5 of the last 5 checks · latest 22 ms · checked Nov 19, 2026

Published vulnerabilities (OSV.dev)

No entries on OSV.dev for freehire-mcp@0.8.0

Checks only this package version, not every dependency · checked Nov 15, 2026

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/me-freehire-freehire.svg)](https://mcp.popnx.com/en/servers/me-freehire-freehire)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Search & AI memoryi

  • More stars than 94% of the other 6447 servers in this category
  • Published to the registry more recently than 64% of the other 6447 servers in this category
  • Basic checks equal to or better than 99% of the other 6447 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is freehire safe?

It passed 6 of 6 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

Either way works: install it on your computer or connect to the cloud version.

Is it still maintained?

The GitHub repo last changed 15 days ago, and the latest version (0.8.0) reached the registry 22 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT on the web (full MCP on Business and above; Pro read-only).

What can I use instead?

In the same category: OpenSEO, Exa, Microsoft Learn MCP, Docs, COTAL actions (cotal.ai)

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

OpenSEO

Keyword research, site audits, rank tracking and AI visibility for your AI agent.

by every-appWidely used★ 28.3KUpdated 6 days ago

Runs in the cloud✓ everyapp.com

Exa

Connect AI agents to Exa for web search, content fetching, and multi-step research.

by exa-labsWidely used★ 5.2KUpdated 2 months ago

Runs in the cloud✓ service owner · exa.aiTried by the PopNx team

Microsoft Learn MCP

Official Microsoft Learn MCP Server – real-time, trusted docs & code samples for AI and LLMs.

by MicrosoftDocsWidely used★ 2KUpdated 12 months ago

Runs in the cloud✓ service owner · microsoft.comTried by the PopNx team

Docs

Search and read Empryo's documentation. Read-only, no auth, no local access.

by proxysoulGrowing★ 1.6KUpdated 2 months ago

Runs in the cloud✓ empryo.com
Compared with similar ones
This one
freehire
OpenSEOExaMicrosoft Learn MCPDocsCOTAL actions (cotal.ai)
Runs whereCloud or install on your computerRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to install
Needs a keyNoNoNoNoNoNo
Add with + in ClaudeNoYesYesYesNoNo
Basic checks6/65/52/44/44/44/4
LicenseMITMITMITCC-BY-4.0NOASSERTIONApache-2.0
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

freehire MCP server

Search 4.9M+ unique open jobs from 437 sources inside Claude, ChatGPT or your coding assistant. Find roles by stack, salary, seniority, work mode and location, inspect employers, and keep your shortlist and application progress in one place. The catalogue includes 680K+ company profiles and 178 ATS platforms. Figures are from the exact catalogue snapshot on 5 November 2026 (live figures).

The hosted MCP connection offers public search without an account and personal tools through OAuth at one address. The local npm server uses a personal API key and also provides CV and experience-bank tools. Saving or marking a job applied updates tracking; employer submission is a separate OAuth workflow that requires explicit permission and review.

The local server mirrors the freehire CLI: same API, same credentials, exposed as MCP tools instead of shell commands.

Install

Hosted connection (public search and OAuth)

The plugin connects to https://freehire.me/api/v1/mcp over Streamable HTTP. Public catalogue tools work without sign-in. Connect your account with OAuth for personal tools. It includes job search and market research, plus your profile, saved jobs, application tracking, reports, alerts and account-enabled automatic applications. In Claude Code, install it as a plugin:

/plugin install freehire --marketplace strelov1/freehire-mcp

In other OAuth-capable hosts, add the canonical URL as a custom remote connector and complete the sign-in flow. In Claude Code, use /mcp to select Freehire and authenticate before personal calls; for a custom server named freehire, use claude mcp login freehire. Do not assume every host opens sign-in automatically from a tool-level challenge. The included skill automatically submits the user's original unrecognized skill, specialization or company industry for dictionary review through suggest_dictionary_term. It also sends a minimal report_problem for a failed operation or missing capability, excluding credentials, CV content, conversations and personal contact details. These two workflow reports require no separate confirmation; empty search results alone trigger neither. The agent confirms submission only after success and continues the original task. Other account changes and application sending require your confirmation; automatic applications also require the account setting that permits connected agents to apply.

The ChatGPT package is freehire (display name Freehire), with a freehire MCP connection to the original URL and mixed public/OAuth authentication. Upload updates to the existing Freehire plugin. The separate Freehire Account plugin and its /api/v1/mcp/account endpoint remain available during client migration.

ChatGPT plugin and claude.ai skill downloads

Every push to main, pull request, and manual run of the CI workflow builds two ZIP files after the checks pass. Open a successful run and download the freehire-plugins- artifact:

  • freehire-chatgpt- .zip: upload this ZIP as the ChatGPT plugin package. It includes the portable plugin manifest, hosted MCP connection, icon, and the current find-tech-jobs skill.
  • freehire-claude-skill- .zip: upload this ZIP in claude.ai under Customize → Skills. Add https://freehire.me/api/v1/mcp as a remote connector separately and complete OAuth sign-in; uploading a skill does not configure an MCP connection.

Run npm run build:plugins locally to write both archives to dist/plugins/. Packaging uses Python 3.9+ and its standard library; it needs no API credentials, live server access, or sibling checkout. The version comes from package.json, and all packaged metadata, assets and skills come from the checked-out commit. Both archives include the same skills/find-tech-jobs/SKILL.md source and its dictionary and problem-reporting workflow. The hosted MCP connection discovers the live server's tools rather than bundling a fixed tool list; existing account tools remain available. The project-local .agents/skills/verify-freehire-mcp skill verifies the archives, local stdio discovery, hosted public access and OAuth using real transports and the official MCP Inspector CLI. CI runs the archive/local checks and uploads the freehire-verification- proof artifact. Hosted checks additionally need the deployed unified backend and a dedicated reviewer OAuth grant.

This workflow builds download artifacts; directory submission and publication remain separate steps.

Claude directory plugin bundle

For the public Claude directory, submit this repository with Plugin path set to plugins/claude and track main. Pair the bundle with the existing Freehire MCP connector in the same Claude organization. The bundle includes the skill and the same hosted MCP URL, so it does not install the local npm server or its dependencies. The existing connector remains the source of authentication and tool health information.

npm run build:plugins also refreshes the committed plugins/claude folder from the current skill, Claude manifest, connection configuration, README template and license. Commit that folder with changes to those sources. CI checks it before building the ZIPs and fails if the directory bundle is stale. After the initial directory review, Claude can scan new commits on the tracked branch; publishing still follows the listing's review settings.

The hosted tools use names such as search_jobs, get_job, get_profile, save_job, track_job and my_jobs; discover their current schemas in your host. The unified hosted search uses top-level public filter fields; discover its live schema. Personal tools may use nested filters, so inspect each tool separately. CV tailoring and experience bank tools in the local server below are not part of this account connection.

Local server (npm)

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.

Local server authentication

The token and API base URL resolve with precedence env → `~/.freehire/creds.json` → default `https://freehire.me`:

WhatSources
TokenFREEHIRE_TOKEN → creds file
API base URLFREEHIRE_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.

Local server tools

ToolPurpose
whoamiAuthenticated user (verify the key).
profileThe candidate's saved job-search profile (skills, preferences, contact-free CV).
facetsThe filter/skill vocabulary: every facet's live values with counts. Call first.
searchKeyword + facet job search; returns jobs with their full description as markdown and the total match count.
market_fitScore a skill list against live market demand (coverage + gaps).
jobA single job's full content by slug.
check_jobs_openWhether postings are still open (up to 50 slugs). Run it on a shortlist before presenting it.
similar_jobsPostings most similar to one posting.
salary_statsSalary percentiles by role family, seniority and country, with sample sizes.
job_market_statsHow many open postings match a set of filters, and what they ask for.
list_filter_valuesThe values one filter accepts, with counts (golang finds go).
companyA company and its open jobs by slug.
applyMark a job applied.
save / unsaveBookmark / remove a bookmark.
stageSet the application stage (server-validated).
noteAttach a free-text note.
myThe caller's tracked jobs (all/viewed/saved/applied) with stage + note.
subscribeCreate a job alert: a saved search delivered by email, Telegram, the app or a webhook.
list_subscriptionsThe caller's job alerts with every setting.
update_subscriptionChange an alert's name, search, channels, or pause it.
unsubscribeStop an alert on every channel or one.
subscription_updatesThe new postings the caller's alerts have matched.
cv_tailorStart (or reopen) tailoring for a vacancy; returns the CV id the other cv_* tools take.
cv_listThe caller's tailored CVs with the vacancy each was written for.
cv_contextThe fit analysis a tailored CV should reframe toward (missing_have vs missing_gap).
cv_getA tailored CV's full document.
cv_editApply a batch of path-addressed edits to a tailored CV, atomically (server-validated; uncited claims are refused).
cv_renderRender a tailored CV to a PDF, returned as a base64 application/pdf resource.
experience_listThe candidate's experience bank, with each achievement's provenance. cv_edit's evidence_id comes from here.
experience_add_employment / experience_add_achievementRecord a place, or one piece of evidence.
experience_update_employment / experience_update_achievementCorrect one. Field-level: what you do not name is kept.
experience_remove_employment / experience_remove_achievementDelete one. No undo; a place must be empty first.
submitSubmit a vacancy for moderation.
my_submissionsThe caller's submissions with status.
contributeHand over a vacancy or company career board link to the catalogue intake.
my_contributionsThe caller's contributed links and boards with ingestion status.
jobs_add / jobs_editModerator: author / edit a job (403 without the role).
submissions_pendingModerator: the review queue.
submission_approve / submission_rejectModerator: 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, exclude_skill, 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.

Geography widens. region, country and city are ONE OR-group: region: ["eu"] with country: ["IT"] means "in Europe or in Italy" and returns everything the region alone would. To search a single country, pass country and omit region. The three name a single concept — *where* — so picking two places reads as "either", which is what makes region: ["eu"] with country: ["BR"] ("Europe or Brazil") useful. There is no AND to switch on: _mode=and does not apply to geography.

Unknown values are named, not guessed. A filter value the API does not recognise (a misspelt skill such as golangg) is reported in ignored_values, e.g. {"skills": ["golangg"]}, beside total in search and in the {data, ignored_values} wrapper of facets and market_fit. Unlike an unread param it still narrows — to nothing — so

Only the beginning is shown; read the rest in the repo