Headcount Labs

com.headcountlabs/jobsVersion 1.2.0

Job postings search: find, count and read open jobs from employer career sites, with pay and links.

Status

Responds164 msNov 14, 2026, 14:01 UTCAnswered our handshake without sign-in.

Registry data may be out of date

We could not refresh it, so this page shows the last copy.

Last checked: Nov 14, 2026, 14:01 UTC
Latency: 164 ms
Remotes responding: 2 of 2
Sign-in: OAuth sign-in, No sign-in
Hosting: Hosted outside the EU (detected)
Registry data as of: Nov 14, 2026, 22:14 UTC

Data from the official MCP Registry, checked by run.zero. How we check

Connect

Streamable HTTP

https://api.headcountlabs.com/mcpSign-in required192 msNov 14, 2026, 14:00 UTC

OAuth sign-in

Claude Code

This server asks for sign-in. Your client opens the sign-in when it connects.

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

Claude Desktop and claude.ai

1
2
3

Settings > Connectors > Add custom connector
Name: jobs
Remote MCP server URL: https://api.headcountlabs.com/mcp

Cursor

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

VS Code

code --add-mcp '{"name":"jobs","type":"http","url":"https://api.headcountlabs.com/mcp"}'

Streamable HTTP

https://api.headcountlabs.com/mcp/publicResponds164 msNov 14, 2026, 14:01 UTC

No sign-in

Claude Code

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

Claude Desktop and claude.ai

1
2
3

Settings > Connectors > Add custom connector
Name: jobs
Remote MCP server URL: https://api.headcountlabs.com/mcp/public

Cursor

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

VS Code

code --add-mcp '{"name":"jobs","type":"http","url":"https://api.headcountlabs.com/mcp/public"}'

Built your own server? run.zero hosts MCP servers on European infrastructure.

Host your own MCP server on run.zero

Tools

9 tools

Tools of Headcount Labs
	Description		Read-only	Idempotent	Open world
`count_jobs`Count matching jobs without listing them. This is the live count; prefer it over market_lookup and market_breakdown for "how many" and "which employers are hiring". A count by title_advanced with no company, company_id or job_id is an estimate (count_is_estimate is true); if it is refused as too slow, add one of those three filters or count by title. count_jobs refuses these combinations unless company, company_id or job_id is also set: near together with title, title_advanced or q (use city with state instead; that counts fast); source, exclude_source, source_type, has_location, last_fetch_since, last_fetch_until or application_check_since together with title, title_advanced or q; has_description in any count. A refusal is invalid_request and is not temporary: change the filters as its message says instead of retrying the same call. Counting by description alone returns an estimate: count_is_estimate is true and count_margin gives the 95% range. To answer "which companies are hiring for X" or "how are these jobs split by ...", pass group_by: employer (company works too), work_arrangement (remote, hybrid or in_person), title, state (US), city, country or employment_type. The answer then also has group_by, groups (the top 25 values by number of matching jobs, each with value and jobs), groups_from_jobs (how many matching jobs the breakdown is based on), groups_sampled (true when this is not an exact count of every match) and groups_unknown_jobs (jobs with no known value). The breakdown is exact up to 3,000 matching jobs, estimate from a random sample above. Either way the top 25 values are returned. Above 3,000, groups_are_estimates is true, groups_note states the sample size in plain words, and each jobs number is scaled from that random sample of matching jobs (picked by job id, which is random) up to the total, not a raw sample count. If the breakdown times out, the count is still returned with no groups and groups_note says the breakdown timed out. A job with sev	Count matching jobs without listing them. This is the live count; prefer it over market_lookup and market_breakdown for "how many" and "which employers are hiring". A count by title_advanced with no company, company_id or job_id is an estimate (count_is_estimate is true); if it is refused as too slow, add one of those three filters or count by title. count_jobs refuses these combinations unless company, company_id or job_id is also set: near together with title, title_advanced or q (use city with state instead; that counts fast); source, exclude_source, source_type, has_location, last_fetch_since, last_fetch_until or application_check_since together with title, title_advanced or q; has_description in any count. A refusal is invalid_request and is not temporary: change the filters as its message says instead of retrying the same call. Counting by description alone returns an estimate: count_is_estimate is true and count_margin gives the 95% range. To answer "which companies are hiring for X" or "how are these jobs split by ...", pass group_by: employer (company works too), work_arrangement (remote, hybrid or in_person), title, state (US), city, country or employment_type. The answer then also has group_by, groups (the top 25 values by number of matching jobs, each with value and jobs), groups_from_jobs (how many matching jobs the breakdown is based on), groups_sampled (true when this is not an exact count of every match) and groups_unknown_jobs (jobs with no known value). The breakdown is exact up to 3,000 matching jobs, estimate from a random sample above. Either way the top 25 values are returned. Above 3,000, groups_are_estimates is true, groups_note states the sample size in plain words, and each jobs number is scaled from that random sample of matching jobs (picked by job id, which is random) up to the total, not a raw sample count. If the breakdown times out, the count is still returned with no groups and groups_note says the breakdown timed out. A job with sev	No	Yes	Yes	No
`get_job`Get a job by job_id. Default shape matches search_jobs, plus the full description, currentness, stale, last_checked_at, and linked postings. Pass view: "full" for every REST field, or fields to pick top-level properties (job_id is always included).	Get a job by job_id. Default shape matches search_jobs, plus the full description, currentness, stale, last_checked_at, and linked postings. Pass view: "full" for every REST field, or fields to pick top-level properties (job_id is always included).	No	Yes	Yes	No
`list_fields`Find search_jobs filters and job fields matching keywords, with type and a short description. Pass words such as ["pay", "remote"]; no keywords lists everything. kind is filter, option (sort, a search_jobs argument beside filters) or field (postings[].x is a posting property). A field state object says whether the source published the value (known), Atlas derived it, the source omitted it, or extraction failed.	Find search_jobs filters and job fields matching keywords, with type and a short description. Pass words such as ["pay", "remote"]; no keywords lists everything. kind is filter, option (sort, a search_jobs argument beside filters) or field (postings[].x is a posting property). A field state object says whether the source published the value (known), Atlas derived it, the source omitted it, or extraction failed.	No	Yes	Yes	No
`market_breakdown`Rank one dimension (by: title, state, city, company, seniority, employment_type or remote) by jobs, pay or another figure, optionally inside a filter. Daily snapshot (see as_of). For live counts or who is hiring now, use count_jobs. Cells with fewer than 30 jobs are omitted. No account needed.	Rank one dimension (by: title, state, city, company, seniority, employment_type or remote) by jobs, pay or another figure, optionally inside a filter. Daily snapshot (see as_of). For live counts or who is hiring now, use count_jobs. Cells with fewer than 30 jobs are omitted. No account needed.	No	Yes	Yes	No
`market_dimensions`List dimensions and metrics for market_lookup, market_breakdown and salary_range; pass dimension (and optional q) to list that dimension's values. No account needed.	List dimensions and metrics for market_lookup, market_breakdown and salary_range; pass dimension (and optional q) to list that dimension's values. No account needed.	No	Yes	Yes	No
`market_lookup`Look up job count, pay, pay share, work arrangement, posting age, new postings or top employers for up to two of title, place, company, seniority, employment_type and remote. Omit metric for every figure. Daily snapshot (see as_of). For live counts or who is hiring now, use count_jobs. Cells with fewer than 30 jobs are omitted. No account needed.	Look up job count, pay, pay share, work arrangement, posting age, new postings or top employers for up to two of title, place, company, seniority, employment_type and remote. Omit metric for every figure. Daily snapshot (see as_of). For live counts or who is hiring now, use count_jobs. Cells with fewer than 30 jobs are omitted. No account needed.	No	Yes	Yes	No
`salary_range`Posted pay percentiles (25/50/75/90) for a title, place (default US) and optional seniority, with sample size and a short recommendation. Daily snapshot (see as_of). For live counts or who is hiring now, use count_jobs. Cells with fewer than 30 jobs are omitted. No account needed.	Posted pay percentiles (25/50/75/90) for a title, place (default US) and optional seniority, with sample size and a short recommendation. Daily snapshot (see as_of). For live counts or who is hiring now, use count_jobs. Cells with fewer than 30 jobs are omitted. No account needed.	No	Yes	Yes	No
`search_docs`Search Headcount Labs docs (filters, limits, MCP setup, errors) and return matching sections with URLs. Works without an account.	Search Headcount Labs docs (filters, limits, MCP setup, errors) and return matching sections with URLs. Works without an account.	No	Yes	Yes	No
`search_jobs`Search current job postings by keyword, title, company, place, pay and date. Call list_fields for filter names. Country and employment_type accept comma-separated values or arrays. Pages return up to 50 jobs (limit, default 10), or 10 when descriptions is "full". Pass next_cursor as cursor for the next page. One search shows up to 250 jobs; narrow filters or use count_jobs for how many match. Default results are compact summaries (employer, title, locations, pay, dates, urls, snippet). Pass view: "full", fields, or get_job for more. descriptions: "snippet" (default) previews text; "full" returns whole descriptions. title matches one phrase in order. title_advanced and description_advanced are Boolean: an operator between every two words or groups, for example title_advanced: "(engineer OR developer) AND NOT manager" (write AND NOT, never a bare NOT after a word; keep at least one word that is not negated). sort: relevance needs q, title or description; with only title_advanced or description_advanced use updated.	Search current job postings by keyword, title, company, place, pay and date. Call list_fields for filter names. Country and employment_type accept comma-separated values or arrays. Pages return up to 50 jobs (limit, default 10), or 10 when descriptions is "full". Pass next_cursor as cursor for the next page. One search shows up to 250 jobs; narrow filters or use count_jobs for how many match. Default results are compact summaries (employer, title, locations, pay, dates, urls, snippet). Pass view: "full", fields, or get_job for more. descriptions: "snippet" (default) previews text; "full" returns whole descriptions. title matches one phrase in order. title_advanced and description_advanced are Boolean: an operator between every two words or groups, for example title_advanced: "(engineer OR developer) AND NOT manager" (write AND NOT, never a bare NOT after a word; keep at least one word that is not negated). sort: relevance needs q, title or description; with only title_advanced or description_advanced use updated.	No	Yes	Yes	No

Details

Registry status: Active
Published: Oct 18, 2026
Updated: Oct 18, 2026
Website: https://headcountlabs.com/mcp/⁠ (opens in a new tab)
Repository: https://github.com/HeadcountLabs/headcountlabs-mcp⁠ (opens in a new tab)
Categories (suggested): Knowledge and notesSuggested categories are assigned automatically from the registry text and may be wrong. Verified operators can correct them.
GDPR: Not declared

Are you the operator? Claim this listing