# RecruitMCP MCP

One setup file. Read it, then connect.

1. Connect with OAuth (claude.ai custom connectors and other clients that support it discover it from `https://mcp.recruitmcp.com/mcp`), or with an API key: header `Authorization: Bearer <key>`. Keys start with `rmcp_live_`; older `rapi_live_` keys still work. Signup grants 1,250 credits.
2. Pick toolsets with `?toolsets=`: sourcing and outreach by default, add advanced for raw search and lookups, or use all. Example: `https://mcp.recruitmcp.com/mcp?toolsets=sourcing,advanced`.
3. Call `get_guide` (or read `recruitmcp://guide`) before the first search.
4. Tools that spend or send return a free preview until you call them again with `confirm=true`. A repeated confirmed call with the same arguments replays the first answer.
5. To act inside a customer workspace, send header `RecruitMCP-Customer: cus_…`, or use a key bound to that customer.

Locally this server mounts MCP at `/mcp` and `/api/mcp`.

## Claude Code

claude mcp add --transport http recruitmcp https://mcp.recruitmcp.com/mcp --header "Authorization: Bearer $RECRUITMCP_KEY"

```json
{
  "mcpServers": {
    "recruitmcp": {
      "type": "http",
      "url": "https://mcp.recruitmcp.com/mcp",
      "headers": {
        "Authorization": "Bearer rmcp_live_..."
      }
    }
  }
}
```

## Claude Desktop

```json
{
  "mcpServers": {
    "recruitmcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://mcp.recruitmcp.com/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer rmcp_live_..."
      }
    }
  }
}
```

## claude.ai

Add a custom connector with URL `https://mcp.recruitmcp.com/mcp`. Choose OAuth and register the client automatically. Paste the API key on the consent page, not in a request header. Pick the scopes and an optional daily credit cap, then approve.

## Check

```bash
#!/usr/bin/env bash
set -euo pipefail
DOMAIN="${RECRUITMCP_DOMAIN:-recruitmcp.com}"
BASE="${RECRUITMCP_BASE:-https://api.${DOMAIN}}"
MCP="${RECRUITMCP_MCP:-https://mcp.${DOMAIN}/mcp}"
WS=$(curl -fsS -X POST "$BASE/v1/workspaces" -H 'content-type: application/json' -d '{"name":"Northwind Search","email":"ada@northwind.example"}')
KEY=$(node -e 'process.stdout.write(JSON.parse(process.argv[1]).api_key)' "$WS")
LIST=$(curl -fsS -X POST "$MCP" \
  -H "authorization: Bearer $KEY" \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}')
node -e 'const j=JSON.parse(process.argv[1]); const names=(j.result?.tools||[]).map(t=>t.name); for (const n of ["start_search","get_search_results","save_to_list","enroll_candidates","update_enrollment","send_reply"]) if(!names.includes(n)) { console.error(names); process.exit(1); }' "$LIST"
```

Replace the default hosts with `http://127.0.0.1:43123` and `http://127.0.0.1:43123/mcp` when you are on this machine.