Skip to main content
Developers / MCP

Connect to the RecruitHorizon MCP server

HTTP transport at https://recruithorizon.ai/api/mcp. Bearer-token auth. Spec-compliant with MCP 2025-06-18.

1

Get a key (60 seconds)

Programmatic signup. One call, returns the key in the response. Save it — it's shown once.

bash
curl -X POST https://recruithorizon.ai/api/v1/auth/signup \
  -H "Content-Type: application/json" \
  -d '{
    "email": "you@startup.com",
    "companyName": "Acme AI",
    "agreedToTerms": true
  }'

Or: log into the dashboard and create a key from Settings → API Keys.

2

Add the server to your MCP client

For Claude Desktop, edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

json
{
  "mcpServers": {
    "recruithorizon": {
      "url": "https://recruithorizon.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer rh_live_YOUR_KEY_HERE"
      }
    }
  }
}

Restart Claude Desktop. The RecruitHorizon tools will appear in the tool picker.

3

Verify with the MCP Inspector

Anthropic's official inspector is the fastest way to poke at the tool list and try a call:

bash
npx @modelcontextprotocol/inspector https://recruithorizon.ai/api/mcp \
  --header "Authorization: Bearer rh_live_YOUR_KEY_HERE"
4

Available tools

Every tool the server exposes, and what it does once you're connected.

create_job

Create a draft job (title, description, location, salary). Returns the job id.

publish_job

Publish a draft, automatically triggering Magic Pipeline candidate sourcing.

get_job

Get a single job's status, including magicPipelineStatus.

list_candidates

List candidates in your pipeline. Filter by jobId.

get_audit_log

Read the receipts trail of every action — yours, your team's, your agents'.

Ready to build?

One curl call gets you started. Free tier covers prototyping — no card required.