Developers & AI Agents

Query live hiring signals from anywhere

The Honeylead API answers one question in any recruiting niche: which companies are hiring right now? Call it from a script, or drop the MCP server into Claude and just ask.

1 · Get an API key

Every workspace can mint a key. In the app, go to Settings → API, or ask us to mint one for you. Keys look like hl_live_… and are shown once.

2 · Use it in Claude MCP

Honeylead runs a hosted MCP server — no install, no Python, nothing to download. Add one URL with your key, then just ask: “Use honeylead to find law firms hiring paralegals right now.”

Claude Code (one command — recommended)

claude mcp add --transport http honeylead \
  https://mcp.honeylead.io \
  --header "Authorization: Bearer hl_live_your_key"

Claude Desktop / Cursor (Custom Connector)

Add a custom MCP connector with this URL — the key travels in the URL so clients that only accept a URL still work:

https://mcp.honeylead.io?key=hl_live_your_key

One tool is exposed — search_hiring_signals(query, limit) — and it works in any MCP-compatible client (Claude, Cursor, and other LLMs that speak MCP).

Prefer a local (stdio) server instead? →

Grab honeylead_mcp.py, pip install "mcp[cli]", and point your config at it with HONEYLEAD_API_KEY in the env. The hosted URL above is easier for most people.

3 · Or call the REST API

POST/v1/api/search — authenticated with your key. Serves company-level signals from Honeylead's owned data (no credit cost per call).

curl -X POST https://honeylead-pipeline-production.up.railway.app/v1/api/search \
  -H "Authorization: Bearer hl_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"query": "law firms hiring paralegals", "limit": 20}'

Response

{
  "ok": true,
  "query": "law firms hiring paralegals",
  "nicheCount": 38,
  "hiringNowCount": 9,
  "companies": [
    { "name": "…", "domain": "…", "region": "…",
      "hiringSignals": ["jobs", "funding"], "isHiringNow": true }
  ]
}

What this surface does and doesn't do.

✅ Company-level signals across your niche, from owned data — fast, and no credit burn per call.
🔒 Verified decision-maker emails & full contacts stay in the app, gated by your account's unlock credits.
Rate-limited per key. Need higher limits or a live-scan tier? Just ask.

Full machine-readable spec: OpenAPI · interactive: /docs