MCP server

The Helix API is also a Model Context Protocol server. An AI assistant gets the same search, match, parse and market tools as your code, under the same scopes and credits.

Connect

One remote server, authenticated with your normal key. It speaks stateless JSON-RPC 2.0 over HTTPS (Streamable HTTP), so it needs no long-lived connection and works behind corporate proxies. Protocol versions 2025-06-18, 2025-03-26 and 2024-11-05 are negotiated.

Server details

URL:     https://api.helixhumancapital.in/v1/mcp
Header:  Authorization: Bearer $HELIX_KEY

Claude Code

claude mcp add --transport http helix https://api.helixhumancapital.in/v1/mcp \
  --header "Authorization: Bearer $HELIX_KEY"

Cursor and other clients that read mcp.json

mcp.json

{
  "mcpServers": {
    "helix": {
      "url": "https://api.helixhumancapital.in/v1/mcp",
      "headers": { "Authorization": "Bearer ${HELIX_KEY}" }
    }
  }
}

Claude Desktop (via the mcp-remote bridge)

claude_desktop_config.json

{
  "mcpServers": {
    "helix": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.helixhumancapital.in/v1/mcp", "--header", "Authorization: Bearer ${HELIX_KEY}"],
      "env": { "HELIX_KEY": "hlx_live_…" }
    }
  }
}

Tools

Tool	What it does
`search_candidates`	Find ranked candidates for a natural-language query (role, skills, seniority, city).
`get_candidate`	Full record for one candidate id, limited to the field groups this key may see.
`get_candidate_cv`	A 10-minute download link for a candidate's resume.
`match_job_description`	Paste a job description; get the best-fitting candidates scored and banded strong / possible / stretch.
`score_candidate_fit`	How well one candidate fits one job description, with a per-requirement evidence checklist.
`parse_job_description`	Turn a job description into a short checklist of must-have and nice-to-have requirements.
`parse_resume`	Turn a resume file (PDF, DOC or DOCX, up to 5 MB, base64) into structured JSON.
`market_pay_bands`	What the market pays for a role: curated benchmarks plus observed percentiles of self-reported pay (INR lakh per annum) by seniority, with a confidence level.
`market_skills`	Most common skills among people near a role, or across the whole pool when no role is given.
`market_overview`	Shape of the candidate pool: seniority mix, top cities, notice periods, work-mode split.
`list_jobs`	Helix's open roles, with pay bands.
`account_status`	This key's plan, scopes and remaining credits.

Each tool runs the same handler as its REST route: the same scopes decide what is visible, the same credits are spent, and a failed call is refunded. The tool result text is the JSON the REST route would return.

Prompts that work well

“Find five senior backend engineers in Bengaluru with under 30 days notice, summaries only.” (1 credit)
“Here is a job description. Which of our pool fit best, and what are the must-have gaps?” (match, 10 credits)
“What does a sales manager in Pune typically earn, and how confident is that number?” (free)
“Show me open roles at Helix for remote product designers.” (free)

Inspect the server without a client: curl https://api.helixhumancapital.in/v1/mcp -H "Authorization: Bearer $HELIX_KEY" -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

← PreviousWebhooks Next →Guides and recipes