Point your own AI at your hiring system.

{
  "mcpServers": {
    "pitchnhire": {
      "command": "npx",
      "args": ["-y", "@pitchnhire/mcp-server"],
      "env": {
        "PNH_API_KEY": "pnh_live_…",
        "PNH_WORKSPACE": "acme-talent"
      }
    }
  }
}

# then, in the assistant:
> "Rank the Bengaluru backend pipeline against
>  the approved scorecard and tell me which two
>  candidates the panel disagreed on."

called pnh.requisitions.list
called pnh.candidates.rank   (812 -> 34)
called pnh.scorecards.get
-> 34 clear the bar. Panel dissent on 2:
   REQ-4471/c_88213 — design depth
   REQ-4471/c_90114 — systems depth
   Reasoning and evidence attached per score.

Add the server once. Your assistant then has every tool your permissions allow.

curl -X POST https://api.pitchnhire.com/v1/requisitions/REQ-4471/rank \
  -H "Authorization: Bearer $PNH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "scorecard_id": "sc_backend_sr",
        "explain": true,
        "limit": 25
      }'

# 200 OK
{
  "requisition": "REQ-4471",
  "ranked": 25,
  "pool": 812,
  "results": [
    {
      "candidate_id": "c_88213",
      "score": 91,
      "evidence": [
        { "criterion": "distributed systems",
          "met": true,
          "source": "resume:p2:l14" },
        { "criterion": "team leadership",
          "met": "partial",
          "source": "interview:i_5521:14:22" }
      ],
      "decision_required_by": "human"
    }
  ]
}

Same objects, same permissions, cursor pagination and idempotency keys throughout.

// Verify the signature, then do whatever you like.
import { verify } from "@pitchnhire/webhooks";

export async function POST(req) {
  const raw = await req.text();
  const event = verify(raw, req.headers.get("pnh-signature"),
                       process.env.PNH_WEBHOOK_SECRET);

  switch (event.type) {
    case "candidate.ranked":
      await ourAgent.review(event.data);       // your model
      break;
    case "interview.completed":
      await slack.post(summarise(event.data)); // your tools
      break;
    case "offer.accepted":
      await payroll.createEmployee(event.data);
      break;
  }
  return new Response("ok");
}

Signed with HMAC-SHA256, retried with backoff, and replayable from the dashboard.