Headcount Labs — Claude Code MCP server: what it does, how to install
Searches and analyzes active job postings from employer career pages. Useful when an agent needs compensation figures, hiring numbers, or direct apply links.
claude mcp add --transport http jobs https://api.headcountlabs.com/mcp/publicWhat Headcount Labs does
Headcount Labs links your AI agent to an index of active job listings gathered directly from employer career portals and ATS platforms like Workday, Lever, and Greenhouse. The system consolidates duplicate postings into a single record while preserving source links to original application pages.
You do not need to compile or run local code. The service operates as a hosted remote endpoint using Streamable HTTP transport. The unauthenticated public endpoint provides 6 read-only tools returning up to 250 matches per query, while the authenticated version exposes 26 tools with file exports and change tracking.
Every tool operates strictly in read-only mode, so the server can query market openings but cannot submit job applications or message recruiters.
What it helps with
- filter job openings by compensation, location, and remote arrangement
- aggregate hiring volumes across specific companies
- retrieve clean job records with verified links to original career boards
- pull compensation baselines and market distribution stats
Example prompts for the agent
- Find remote backend engineering roles that list a salary range.
- Count all active software engineering positions across companies using Greenhouse.
- Inspect the full posting details and apply link for job ID 12345.
How to install Headcount Labs
Platform CLI: remote server
claude mcp add --transport http jobs https://api.headcountlabs.com/mcp/publicPlatform CLI: remote server
codex mcp add headcount-labs --url https://api.headcountlabs.com/mcp/publicConfig file
{
"mcpServers": {
"headcount-labs": {
"url": "https://api.headcountlabs.com/mcp/public"
}
}
}Config file
{
"servers": {
"headcount-labs": {
"type": "http",
"url": "https://api.headcountlabs.com/mcp/public"
}
}
}Platform CLI: remote server
gemini mcp add -t http headcount-labs https://api.headcountlabs.com/mcp/publicStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Headcount Labs
How to install Headcount Labs in Claude Code?
Run claude mcp add --transport http headcount-labs https://api.headcountlabs.com/mcp/public in your terminal. This immediately registers the public endpoint without requiring an account.
What does Headcount Labs do?
It gives your AI assistant search access to open job postings collected from company career sites. The agent can filter listings, count openings by employer, and examine salary ranges.
Can Headcount Labs apply to jobs automatically?
No. The MCP server provides read-only search tools and cannot submit resumes or contact hiring teams on your behalf.
