HireBase MCP Server

What is HireBase MCP Server?

HireBase MCP Server is a Model Context Protocol (MCP) server that provides tools to interact with the HireBase Job API. It allows developers to search for jobs and retrieve detailed job information through MCP clients like Claude Desktop or Cursor.

How to use HireBase MCP Server?

Configure your MCP client (e.g., Claude Desktop or Cursor) to run the server using uvx or from source. Set the HIREBASE_API_KEY environment variable to authenticate with the HireBase API (obtain from HireBase). Run commands like uvx hirebase-mcp (on Mac/Linux) or configure Windows appropriately.

Key features of HireBase MCP Server

• 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

Use cases of HireBase MCP Server

• Search for jobs matching specific criteria (keywords, location, salary) via an MCP client
• Get detailed information about a particular job listing
• Generate a structured prompt based on candidate details (name, LinkedIn, resume) for assisted job hunting

FAQ from HireBase MCP Server

Do I need a HireBase API key?

Yes, the HIREBASE_API_KEY environment variable is required for the server to make authenticated requests to the HireBase API. You can obtain a key from HireBase.

How do I install and run the server?

Ensure uv is installed, then configure your MCP client to run uvx hirebase-mcp (or run from source). Set the API key in the client’s environment variables.

What tools does the server expose?

search_jobs – searches jobs based on many parameters (keywords, title, location, salary, etc.). get_job – retrieves detailed information for a specific job ID.

Can I generate a candidate profile?

Yes, the create_candidate_profile prompt generates a structured request based on candidate details like name, LinkedIn URL, personal website, and resume text.

What are the runtime dependencies?

The server requires Python, uv (for package management and running), and the requests library. No additional runtime is needed beyond a standard Python environment.