# Headcount Labs

> Headcount Labs is a freemium MCP server for hiring and recruiting. Search, count and read open jobs from employer career sites over MCP. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, Web
- **Website:** https://headcountlabs.com/mcp/
- **Repository:** https://github.com/headcountlabs/headcountlabs-mcp
- **MCP Registry name:** com.headcountlabs/jobs
- **Categories:** hiring and recruiting, analytics and data
- **Listing updated:** 2026-11-15

## About

The data comes from employers' own career sites and the hiring platforms they use, including Workday, Greenhouse, Lever, iCIMS and SmartRecruiters. Copies of the same opening are merged into one job, and each job keeps a link to the original posting. The site cites more than 7 million open jobs.

There are two doors. A public endpoint needs no sign-in or key and offers nine read-only tools; a search returns at most 250 jobs, 50 per page, and calls are limited to 20 a minute per conversation. The full endpoint uses OAuth 2.1 (PKCE and dynamic client registration) or an API key as a bearer token and adds exports, the company registry and the job change feed. The README and site disagree slightly on tool counts, so check the live tool list.

Billing counts records, meaning each job or company a successful response returns. The first 100,000 each month are free and later records cost $0.01 per 1,000. Counts, field lookups and doc searches cost nothing. Job-ad text is labelled as untrusted data that the assistant shows but should not obey.

## Features

- **Public keyless endpoint:** Read-only tools with no sign-in, capped at 250 jobs per search.
- **OAuth full server:** Adds file exports, company tools, usage and the changes feed.
- **Duplicate merging:** Copies of one opening collapse into a single job with source links.
- **Free counts:** count_jobs, list_fields and doc search do not use records.
- **Confirmation for big searches:** A search above your confirmation level stops so the agent asks first.
- **Job cards in MCP Apps:** Supporting clients show cards with pay, remote and location filters.

## Good for

- Count open roles for a title in one city
- Pull salary ranges for a job family
- Export a set of postings for a job board
- Track new and expired jobs through the changes feed
- Read a single posting with every source link

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http jobs https://api.headcountlabs.com/mcp/public
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.headcountlabs.com/mcp/public
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "jobs": {
      "url": "https://api.headcountlabs.com/mcp/public"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "jobs": {
      "type": "http",
      "url": "https://api.headcountlabs.com/mcp/public"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "jobs": {
      "serverUrl": "https://api.headcountlabs.com/mcp/public"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "jobs": {
      "type": "http",
      "url": "https://api.headcountlabs.com/mcp/public"
    }
  }
}
```

## Tools

- `search_jobs`: Finds jobs by title, keywords, company, location, work arrangement, pay and dates.
- `get_job`: Reads one job with every linked posting and source links.
- `count_jobs`: Counts jobs matching filters, optionally grouped by employer.
- `market_lookup`: Looks up market figures.
- `market_breakdown`: Breaks market figures down.
- `salary_range`: Returns salary ranges.
- `market_dimensions`: Lists market dimensions.
- `list_fields`: Finds the filters and job fields matching your words.
- `search_docs`: Returns the best-matching sections of the docs.
- `read_file`: Pages through a file previously produced for you.
- `set_confirmation_level`: Sets how large a search must be before the agent asks first.

## FAQ

### What does it cost?

The first 100,000 records each UTC month are free, then $0.01 per 1,000. A million records is $9 per the pricing page.

### Do I need an account?

Not for the public endpoint. The full server needs an OAuth sign-in or an API key.

### What counts as a record?

Each job or company a successful response delivers; counts and failed requests are free.

### Which clients work?

The site names Claude, ChatGPT, Grok, Codex, Cursor, VS Code and other MCP clients.

### Is Headcount Labs free?

Headcount Labs has a free plan, with paid plans for more usage or features.

### How do I add Headcount Labs to Claude Code?

Run this command in your terminal: claude mcp add --transport http jobs https://api.headcountlabs.com/mcp/public

### What are the best alternatives to Headcount Labs?

The closest alternatives to Headcount Labs are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and Reactive Resume.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Reactive Resume](https://ai-powered.com/mcp/reactive-resume): Reactive Resume is an open-source MCP server for hiring and recruiting.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [HeyRole](https://ai-powered.com/mcp/heyrole): HeyRole is a free MCP server for hiring and recruiting.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/headcount-labs
