HireBase

HireBase MCP Server provides a focused set of tools to interact with the HireBase Job API through a lightweight MCP interface. It exposes job search capabilities and a prompt builder to help you navigate and explore job data efficiently, all wired to a local or remote MCP client.

How to use

You connect an MCP client to the HireBase MCP Server to perform two core actions: search for jobs and retrieve detailed job information, plus generate candidate prompts to guide your search. Use a client like Claude Desktop or Cursor to run a small wrapper around the MCP server, and supply your HireBase API key if you want authenticated access to HireBase data.

How to install

Prerequisites you need before installing:

• A working Node/Python environment depending on how you run the server
• A running MCP client like Claude Desktop or Cursor
• Access to the HireBase API key if you plan to query real data (optional but recommended)

{
  "mcpServers": {
    "hirebase": {
      "command": "uvx",
      "args": [
        "hirebase-mcp"
      ],
      "env": {
        "HIREBASE_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

If you prefer running the MCP server from source via Python, you can use the following configuration snippet in your MCP client to start the server module directly:

{
  "mcpServers": {
    "hirebase": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "--with",
        "requests",
        "mcp",
        "run",
        "PATH_TO_REPO/src/hirebase_mcp/server.py"
      ]
    }
  }
}

Additional content

Environment variable: The server requires your HireBase API key for authenticated access. Set HIREBASE_API_KEY in your environment when starting the MCP client so the server can make requests to HireBase. If you do not have an API key, you can start without it, but some data may be unavailable.

Tools and prompts overview

The HireBase MCP Server exposes the following interactions:

• search_jobs: Find jobs using keywords, location, salary, and other criteria. Parameters include 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: Get detailed information for a specific job by HireBase ID. Parameter: job_id.
• create_candidate_profile: Generate a structured prompt from candidate details (name, LinkedIn, website, resume text) to guide job searching. Parameters: name, linkedin_url, personal_website, resume_text.

Testing and development

For development and testing, you can run the project’s test suite using Python tooling and pytest. Install test dependencies in your virtual environment, then run the tests to verify core MCP logic, with external API calls mocked in tests.

Available tools

search_jobs

Search for jobs using the HireBase API based on criteria such as keywords, title, location, salary, etc.

get_job

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

create_candidate_profile

Generate a structured prompt from candidate details (name, LinkedIn, website, resume text) to guide job searching.