Interact with the HireBase Job API to manage job listings and applications.
A Model Context Protocol (MCP) server providing tools to interact with the HireBase Job API.
This server exposes the following MCP interactions:
search_jobs
: Search for jobs using the HireBase API based on various criteria (keywords, title, location, salary, etc.).
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.
job_id
.create_candidate_profile
: Generates a structured prompt based on candidate details (name, LinkedIn, website, resume text) to help guide job searching.
name
, linkedin_url
, personal_website
, resume_text
.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.
Ensure uv
is installed: curl -LsSf https://astral.sh/uv/install.sh | sh
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.
Configure your client:
Using uvx
:
claude_desktop_config.json
:
{
"mcpServers": {
"hirebase": {
"command": "uvx",
"args": [
"hirebase-mcp"
],
"env": {
"HIREBASE_API_KEY": ""
}
}
}
}
uvx hirebase-mcp
(Adjust package name if needed)cmd
/c
, uvx
, hirebase-mcp
(Adjust package name if needed)HIREBASE_API_KEY
environment variable in the appropriate section.Running from source via Python (Alternative):
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"
]
}
}
}
This project uses:
uv
for dependency management and virtual environmentsruff
for linting and formattinghatch
as the build backend# 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 .
HIREBASE_API_KEY
(required): Your API key for accessing the HireBase API. The server needs this to make authenticated requests for job data.This project uses pytest
for testing the core tool logic. Tests mock external API calls using unittest.mock
.
# Ensure you are in your activated virtual environment (.venv)
uv pip install -e '.[test]'
# Example command
pytest
Contributions are welcome.
This project is licensed under the MIT License - see the LICENSE file for details.
A server for querying Jira issues, requiring a Jira token for authentication.
Talk with your Apple Notes
A server for Taiga project management, enabling advanced sprint and issue tracking.
A server for managing gatherings and sharing expenses.
Provides Taiwan national holidays and compensatory workday information. Data is fetched and cached automatically.
Interact with Google Docs and Google Drive for document creation, editing, and file management.
Enables AI assistants to seamlessly interact with your Twenty CRM data through its API.
A server for time and timezone conversion tools.
Query and search for issues in Linear, a project management tool.
An optimized, read-only MCP server for the Notion API with asynchronous processing.