MCP server
Homerun MCP by usefulapi
Read Homerun vacancies, applications, notes and tags; move an application to a stage or…
- Runs
- Remotely
- Version
- 1.27.0
- Listing updated
- 4 days ago
About Homerun MCP by usefulapi
Homerun MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.
Read Homerun vacancies, applications, notes and tags; move an application to a stage or add a note.
Install
Run in a terminal
claude mcp add --transport http homerun https://homerun.usefulapi.io/mcpAdd to Settings → Connectors → Add custom connector
https://homerun.usefulapi.io/mcpInstall in CursorOpens Cursor, which asks you to confirm. Or add it by hand:
Add to ~/.cursor/mcp.json
{
"mcpServers": {
"homerun": {
"url": "https://homerun.usefulapi.io/mcp"
}
}
}Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:
Add to .vscode/mcp.json
{
"servers": {
"homerun": {
"type": "http",
"url": "https://homerun.usefulapi.io/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"homerun": {
"serverUrl": "https://homerun.usefulapi.io/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"homerun": {
"type": "http",
"url": "https://homerun.usefulapi.io/mcp"
}
}
}Tools this server provides (9)
Read directly from the server.
- homerun_list_vacancies
- List job vacancies (draft, private, public, ...) with title, status, type, location type and expiry. Optionally include location, department, hiring stages (their ids are what homerun_move_application_to_stage needs), salary indication and the candidate count. GET /vacancies (scope vacancies:read).
- homerun_get_vacancy
- One vacancy by id with description, location, department, hiring stages (id + name), salary indication, candidate count and the public job and application-form URLs. GET /vacancies/{vacancy_id} (scope vacancies:read).
- homerun_list_applications
- List job applications, newest page first as the API orders them. Each item has name, e-mail, vacancy id, current stage (id + name), rating, created/hired dates and disqualified flag. Personal data: no phone number, date of birth, photo or files are returned here; ask for one application with homerun_get_application. Filter by vacancy, stage name or disqualified state and page through; do not use i
- homerun_get_application
- One job application in full: contact details (name, e-mail, phone, city, country), links, experience/education, current stage, rating, sources and file names (notes: use homerun_list_notes). Date of birth, photo URL and file download links are never returned. Optionally include the answers to the application-form questions. Personal data: fetch only the candidate you need. GET /job-applications/{j
- homerun_list_notes
- List the notes on one application: id, author display name, text, sensitive flag and timestamps. GET /job-applications/{job_application_id}/notes (scope job-application-notes:read).
- homerun_list_tags
- List the company's candidate tags (id + name). GET /tags (scope tags:read).
- homerun_list_application_tags
- The tags attached to one application. GET /job-applications/{job_application_id}/tags (scope job-application-tags:read).
- homerun_move_application_to_stage
- WRITE: move ONE application to another hiring stage of its vacancy (PATCH with only the stage id; nothing else on the application changes). Get stage ids from homerun_get_vacancy. Homerun's own automations for that stage may run (for example automatic e-mails configured in Homerun); this tool sends no e-mail itself and does not reject or delete anyone. PATCH /job-applications/{job_application_id}
- homerun_add_note
- WRITE: add ONE note (1-2000 characters) to one application. It becomes visible to the hiring team in Homerun and cannot be removed with this server. display_name is free text shown as the author. Nothing is sent to the candidate. POST /job-applications/{job_application_id}/notes (scope job-application-notes:write).
Homerun MCP by usefulapi FAQ
How do I add Homerun MCP by usefulapi to Claude Code?
Run this command in your terminal: claude mcp add --transport http homerun https://homerun.usefulapi.io/mcp