Homerun MCP by usefulapi
RemoteAbout Homerun MCP by usefulapi
Homerun MCP by usefulapi is a hosted server for recruiting teams using Homerun. It lets MCP clients inspect vacancies and candidate applications, and make selected updates without a local installation.
Key features
- 01List and retrieve vacancies
- 02List and retrieve applications
- 03Read application notes and tags
- 04Move applications between stages
- 05Add notes to applications
Use cases
- 01Review open vacancies and candidate applications
- 02Check an application’s notes and tags
- 03Move a candidate to another stage
- 04Record a note on an application
MCP support
Exposes Homerun vacancy, application, note, and tag operations as tools for MCP clients. Connect to its hosted endpoint and authenticate with Homerun credentials.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://homerun.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-homerun https://homerun.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-homerun":{"type":"http","url":"https://homerun.usefulapi.io/mcp"}}}Open in Cursor{"servers":{"io-usefulapi-homerun":{"type":"http","url":"https://homerun.usefulapi.io/mcp"}}}Open in VS Code{"mcpServers":{"io-usefulapi-homerun":{"type":"http","url":"https://homerun.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-homerun":{"serverUrl":"https://homerun.usefulapi.io/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
9| Parameter | Type | Required | Description |
|---|---|---|---|
| page | integer | No | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| status | array | No | Only vacancies in these statuses, e.g. ["public","private"] or ["draft"]. |
| include | array | No | Extra data to include. Use stages to see the hiring stage ids. |
| perPage | integer | No | Results per page, 1-100 (default 15). |
Details
From the project READMEHomerun MCP by usefulapi
Use Homerun from Claude, Cursor, or any MCP client — vacancies, job applications, notes and tags, plus single-application stage moves and notes. Hosted, no local install: connect with your own Homerun credentials.
Live endpoint: https://homerun.usefulapi.io/mcp · Homepage: https://usefulapi.io/homerun
Connect
- Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste
https://homerun.usefulapi.io/mcp. - Claude Code:
claude mcp add --transport http homerun https://homerun.usefulapi.io/mcp, then run/mcpto log in. - VS Code: Add to VS Code.
- Cursor and other clients: add the URL as a remote MCP server:
{
"mcpServers": {
"homerun": {
"url": "https://homerun.usefulapi.io/mcp"
}
}
}
Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Homerun credentials.
Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/homerun/
Tools
| Tool | Type | What it does |
|---|---|---|
homerun_list_vacancies | read | List vacancies |
homerun_get_vacancy | read | Get vacancy |
homerun_list_applications | read | List applications (candidates) |
homerun_get_application | read | Get application (candidate) |
homerun_list_notes | read | List application notes |
homerun_list_tags | read | List tags |
homerun_list_application_tags | read | List an application's tags |
homerun_move_application_to_stage | write | Move application to a stage |
homerun_add_note | write | Add a note to an application |
homerun_usage_status | meta | Usage status (free-tier meter) |
homerun_request_feature | meta | Request a missing feature |
homerun_upgrade | meta | Upgrade to Pro (unlimited*) |
homerun_cancel_subscription | meta | Cancel the Pro subscription |
read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.
Pricing
| Plan | Price | Limit |
|---|---|---|
| Free | $0 | 50 tool calls / month |
| Pro (per user) | $9/mo or $90/yr (2 months free) | Unlimited* |
*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].
Pro covers this server only. Subscribe with homerun_upgrade (it returns a Stripe Checkout link). Cancel any time with homerun_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running homerun_upgrade before then undoes the cancel. Or write to [email protected].
License
MIT © usefulapi. Not affiliated with or endorsed by Homerun.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.