Connect to the RecruitHorizon MCP server

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

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.

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.

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"

Available tools

Tool	What it does
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.

Full docs →Back to overview