HireBase Job Search

by jhgaylor

3 stars
11.2k downloads
Not rated
GitHub

About

Integrates with HireBase Job API to enable job searching with extensive filtering options and detailed job information retrieval for career exploration and job seeking

Details

Author
jhgaylor
Repository
jhgaylor/hirebase-mcp
GitHub stars
3
Downloads
11,245
License
MIT License
Categories
Productivity, API, Other, Developer Tools, Design, File Management, AI, Search, Knowledge Base, Infrastructure
Tags
#integration

Jump to

- Two job‑related tools: search_jobs and get_job
- One prompt: create_candidate_profile
- Flexible job search using keywords, title, location, salary, and more
- Retrieve full details for a specific job by its HireBase ID
- Structured candidate profile generation to guide job searching

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name HireBase Job Search
    Command (node, npx, python, etc.) uvx
    Arguments
    • Argument 1 hirebase-mcp
    Environment
    • HIREBASE_API_KEY

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

To use this server with an MCP client like Claude Desktop or Cursor, you need to configure the client to run the server process and optionally provide the HireBase API key.

1. Ensure uv is installed: curl -LsSf https://astral.sh/uv/install.sh | sh
2. Obtain a HireBase API Key (optional): Request a key from HireBase You can set this as an environment variable (HIREBASE_API_KEY) or just leave it empty.
3. Configure your client:

Using uvx:
 Claude Desktop: Edit your claude_desktop_config.json:

            {

              "mcpServers": {

                "hirebase": {

                  "command": "uvx",

                  "args": [

                    "hirebase-mcp" 

                  ],

                  "env": {

                    "HIREBASE_API_KEY": "" 

                  }

                }

              }

            }

Cursor: Go to Settings > MCP > Add Server:
 Mac/Linux Command: uvx hirebase-mcp (Adjust package name if needed)
Windows Command: cmd
 Windows Args: /c, uvx, hirebase-mcp (Adjust package name if needed)
Set the HIREBASE_API_KEY environment variable in the appropriate section.

Running from source via Python (Alternative):
1. Clone the repo and note where you clone it to
2. Claude Desktop: Edit your claude_desktop_config.json:

        {

            "mcpServers": {

                "hirebase": {

                    "command": "uv",

                    "args": [

                        "run",

                        "--with",

                        "mcp[cli]",

                        "--with",

                        "requests",

                        "mcp",

                        "run",

                        "PATH_TO_REPO/src/hirebase_mcp/server.py"

                    ]

                }

            }

        }

uv venv

uv pip install -e .

uv tool install ruff

- HIREBASE_API_KEY (required): Your API key for accessing the HireBase API. The server needs this to make authenticated requests for job data.

uv pip install -e '.[test]'



2. Run tests:
bash

search_jobs

Search for jobs using the HireBase API based on various criteria. Parameters: query, and_keywords, or_keywords, not_keywords, title, category, country, city, location_type, company, salary_from, salary_to, salary_currency, years_from, years_to, visa, limit.

get_job

Retrieve detailed information about a specific job using its HireBase ID. Parameters: job_id.

search_jobs: Search for jobs using the HireBase API based on various criteria (keywords, title, location, salary, etc.).
 Parameters: query, and_keywords, or_keywords, not_keywords, title, category, country, city, location_type, company, salary_from, salary_to, salary_currency, years_from, years_to, visa, limit.
get_job: Retrieve detailed information about a specific job using its HireBase ID.
 Parameters: job_id.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "hirebase job search": {
            "env": {
                "HIREBASE_API_KEY": ""
            },
            "args": [
                "hirebase-mcp"
            ],
            "command": "uvx"
        }
    }
}

Linux

{
    "env": {
        "HIREBASE_API_KEY": ""
    },
    "args": [
        "hirebase-mcp"
    ],
    "command": "uvx"
}

Macos

{
    "env": {
        "HIREBASE_API_KEY": ""
    },
    "args": [
        "hirebase-mcp"
    ],
    "command": "uvx"
}

Windows

{
    "env": {
        "HIREBASE_API_KEY": ""
    },
    "args": [
        "/c",
        "uvx",
        "hirebase-mcp"
    ],
    "command": "cmd"
}

HireBase MCP Server

A Model Context Protocol (MCP) server providing tools to interact with the HireBase Job API.

License: MIT

Available MCP Interactions

This server exposes the following MCP interactions:

Tools

search_jobs: Search for jobs using the HireBase API based on various criteria (keywords, title, location, salary, etc.).
 Parameters: query, and_keywords, or_keywords, not_keywords, title, category, country, city, location_type, company, salary_from, salary_to, salary_currency, years_from, years_to, visa, limit.
get_job: Retrieve detailed information about a specific job using its HireBase ID.
 Parameters: job_id.

Prompts

create_candidate_profile: Generates a structured prompt based on candidate details (name, LinkedIn, website, resume text) to help guide job searching.
 Parameters: name, linkedin_url, personal_website, resume_text.

Client Setup (Examples: Claude Desktop, Cursor)

To use this server with an MCP client like Claude Desktop or Cursor, you need to configure the client to run the server process and optionally provide the HireBase API key.

1. Ensure uv is installed: curl -LsSf https://astral.sh/uv/install.sh | sh
2. Obtain a HireBase API Key (optional): Request a key from HireBase You can set this as an environment variable (HIREBASE_API_KEY) or just leave it empty.
3. Configure your client:

Using uvx:
 Claude Desktop: Edit your claude_desktop_config.json:

            {

              "mcpServers": {

                "hirebase": {

                  "command": "uvx",

                  "args": [

                    "hirebase-mcp" 

                  ],

                  "env": {

                    "HIREBASE_API_KEY": "" 

                  }

                }

              }

            }

Cursor: Go to Settings > MCP > Add Server:
 Mac/Linux Command: uvx hirebase-mcp (Adjust package name if needed)
Windows Command: cmd
 Windows Args: /c, uvx, hirebase-mcp (Adjust package name if needed)
Set the HIREBASE_API_KEY environment variable in the appropriate section.

Running from source via Python (Alternative):
1. Clone the repo and note where you clone it to
2. Claude Desktop: Edit your claude_desktop_config.json:

        {

            "mcpServers": {

                "hirebase": {

                    "command": "uv",

                    "args": [

                        "run",

                        "--with",

                        "mcp[cli]",

                        "--with",

                        "requests",

                        "mcp",

                        "run",

                        "PATH_TO_REPO/src/hirebase_mcp/server.py"

                    ]

                }

            }

        }

Development

This project uses:
- uv for dependency management and virtual environments
- ruff for linting and formatting
- hatch as the build backend

Common Tasks

# Setup virtual env
uv venv

Install dependencies

uv pip install -e .

install cli tools

uv tool install ruff

Run linting

ruff check .

Format code

ruff format .

Environment Variables

- HIREBASE_API_KEY (required): Your API key for accessing the HireBase API. The server needs this to make authenticated requests for job data.

Testing

This project uses pytest for testing the core tool logic. Tests mock external API calls using unittest.mock.

1. Install test dependencies:

# Ensure you are in your activated virtual environment (.venv)

uv pip install -e '.[test]'

2. Run tests:

# Example command

pytest

Contributing

Contributions are welcome.

License

This project is licensed under the MIT License - see the LICENSE file for details.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

Install

Add to Claude Desktop or Cursor

{
    "mcpServers": {
        "hirebase job search": {
            "env": {
                "HIREBASE_API_KEY": ""
            },
            "args": [
                "hirebase-mcp"
            ],
            "command": "uvx"
        }
    }
}

More like this

Similar MCP servers you might find useful

Browse category

Sequential Thinking

Sequential Thinking is an MCP server that provides a tool for dynamic and reflective problem-solving through a structured, step-by-step thinking process. It is…

88.2k
Other

Time

A Model Context Protocol server that provides time and timezone conversion capabilities. It enables LLMs to get current time information and perform timezone…

88.2k
Productivity

Filesystem

Filesystem is a Node.js server that implements the Model Context Protocol (MCP) for filesystem operations. It enables AI assistants to read, write, and manage…

88.1k
Other