# Headcount Labs

Searches and analyzes active job postings from employer career pages. Useful when an agent needs compensation figures, hiring numbers, or direct apply links.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: HeadcountLabs
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/HeadcountLabs/headcountlabs-mcp
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/mcp/headcount-labs

## What it 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.

## Requirements
- Remote server: `https://api.headcountlabs.com/mcp/public`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http jobs https://api.headcountlabs.com/mcp/public
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add headcount-labs --url https://api.headcountlabs.com/mcp/public
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "headcount-labs": {
            "url": "https://api.headcountlabs.com/mcp/public"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "headcount-labs": {
            "type": "http",
            "url": "https://api.headcountlabs.com/mcp/public"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http headcount-labs https://api.headcountlabs.com/mcp/public
```

## When to use it
- 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
- 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.

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89609
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89899
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16730
- [PostHog MCP Server](https://affpapa.org/en/nevibecode/mcp/posthog-mcp-server.md) — MCP server · ★ 40459
- [dbx](https://affpapa.org/en/nevibecode/mcp/dbx.md) — MCP server · ★ 27844
- [Metabase](https://affpapa.org/en/nevibecode/mcp/metabase.md) — MCP server · ★ 49863

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md