# freehire

> Search open IT jobs crawled from company career boards, read postings, check salaries and track your applications from your agent.

freehire's own MCP server for its job catalogue: IT job postings crawled from company career boards, de-duplicated and tagged by stack, seniority, region and work mode. Your agent can search and read postings and compare salaries, and once you sign in, keep your applications on your freehire board.

What you can do with it
- Search open IT jobs by technology, role, seniority, region or remote work, or describe the job you want in plain words
- Read a posting in full, with the employer and the board it came from, and check whether it's still open
- Find postings similar to one you like
- See salary ranges and market breakdowns for a role, seniority and region
- Look up employers and the jobs they have open
- Signed in: read your saved profile, check your skills against the market, save jobs, mark them applied and move them along your board
- With the local server: also add notes and tailor a CV to a vacancy from your experience bank

How it connects
- Hosted, anonymous and read-only: https://freehire.me/api/v1/mcp. There's no sign-in, and it can search and read but can't save or change anything.
- Hosted, with your account: https://freehire.me/api/v1/mcp/account. Your agent asks you to sign in with freehire.
- Local: npx -y freehire-mcp. It reads the freehire CLI's sign-in from ~/.freehire/creds.json, or a personal API key in FREEHIRE_TOKEN.

Good to know
- You still apply on the employer's site; freehire records that you did.
- The local server's CV tools only cite achievements you stated yourself, never ones the agent inferred.
- freehire, its CLI and its MCP server are free and open source (MIT).

- Type: Plugin
- Made by: Freehire
- Category: HR & recruiting
- Formats: Remote MCP, Local MCP
- Version: 0.6.0
- Website: https://freehire.me/cli
- Source: https://github.com/strelov1/freehire-mcp
- Page: https://pluginboard.ai/plugins/freehire

## Works with

- ChatGPT
- Claude
- Muse
- Grok Bot
- Gemini
- Grok
- GitHub Copilot
- Cursor
- Claude Code
- Codex
- Antigravity
- Gemini CLI
- Replit
- OpenClaw
- OpenCode
- Hermes Agent

## Install

### ChatGPT

In ChatGPT on the web: Plugins → + → Add custom MCP server, then paste https://freehire.me/api/v1/mcp under Connection. Business and Enterprise plans; Pro can add read-only servers.

### Claude

In Claude (web or desktop): Customize → Connectors → Add custom connector, then paste https://freehire.me/api/v1/mcp

### Muse

In Muse: In a Muse chat, ask it to create a custom connector for the MCP server at https://freehire.me/api/v1/mcp. Then tap Connect on the card it shows and sign in, or add your key.

### Grok Bot

In Grok Bot: In a chat with your Bot, say "Add this MCP server: https://freehire.me/api/v1/mcp". It confirms the details with you and sets it up, and the tools are ready from your next message.

### Gemini

In Gemini: At gemini.google.com: Settings → Connected Apps → Add a custom app, then paste https://freehire.me/api/v1/mcp

### Grok

In Grok on the web: At grok.com/connectors: New Connector → Custom, then enter https://freehire.me/api/v1/mcp and sign in if it asks.

### GitHub Copilot

Add to VS Code: vscode:mcp/install?%7B%22name%22%3A%22freehire%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Ffreehire.me%2Fapi%2Fv1%2Fmcp%22%7D

Copilot CLI:

```shell
copilot mcp add --transport http freehire https://freehire.me/api/v1/mcp
```

### Cursor

Add to Cursor: cursor://anysphere.cursor-deeplink/mcp/install?name=freehire&config=eyJ1cmwiOiJodHRwczovL2ZyZWVoaXJlLm1lL2FwaS92MS9tY3AifQ%3D%3D

Add to .cursor/mcp.json:

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

### Claude Code

Run in your terminal:

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

### Codex

Run in your terminal:

```shell
codex mcp add freehire --url https://freehire.me/api/v1/mcp
```

### Antigravity

Add to ~/.gemini/config/mcp_config.json:

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

### Gemini CLI

Run in your terminal:

```shell
gemini mcp add --transport http freehire https://freehire.me/api/v1/mcp
```

### Replit

In Replit: At replit.com/integrations, open MCP Servers → + Add MCP server, paste https://freehire.me/api/v1/mcp (add any headers under Advanced settings), then click Test & save.

### OpenClaw

Run in your terminal:

```shell
openclaw mcp add freehire --url https://freehire.me/api/v1/mcp --transport streamable-http
```

If it needs a key or sign-in: For https://freehire.me/api/v1/mcp, add --header NAME=value for each header it needs, or --auth oauth and then run openclaw mcp login freehire.

### OpenCode

Run in your terminal:

```shell
opencode mcp add freehire --url https://freehire.me/api/v1/mcp
```

If it needs a key: For https://freehire.me/api/v1/mcp, add --header 'NAME=value' for each header it needs. Add --global to use it in every project.

### Hermes Agent

Run in your terminal:

```shell
hermes mcp add freehire --url https://freehire.me/api/v1/mcp
```

Add to ~/.hermes/config.yaml:

```json
{
  "mcp_servers": {
    "freehire": {
      "url": "https://freehire.me/api/v1/mcp"
    }
  }
}
```

If it signs in with OAuth: If https://freehire.me/api/v1/mcp asks you to sign in, add --auth oauth to the command, or auth: oauth to its entry.

---
From Pluginboard (https://pluginboard.ai).