Skip to main content
Glama
Grey Ridge Jobs MCP

Grey Ridge Jobs MCP

by rezearcher

Greenhouse Jobs MCP Server

smoke MCP deps

A Model Context Protocol server that gives any MCP client — Claude Desktop, Cursor, Cline, Continue, or your own agent — live, normalized job postings straight from a company's Greenhouse board (the most-requested ATS feed), plus seven more applicant-tracking systems in one clean schema.

One tool call, Greenhouse + seven more ATS platforms, one clean schema:

Greenhouse · Lever · Ashby · SmartRecruiters · Workday · Recruitee · Workable · BambooHR

Give it a bare company name (stripe), a domain (stripe.com), or an explicit board (greenhouse:stripe, workday:nvidia.wd5:NVIDIAExternalCareerSite) — the server detects the ATS and board token for you and returns postings with stable field names across every platform.

  • Zero dependencies. No MCP SDK, no transitive package tree — the server is one file plus a vendored adapter core. It installs and boots instantly under npx, and drags nothing into your agent's trust boundary. (For an agent tool, the supply chain is the attack surface.)

  • Zero keys, zero account. Every source is a public ATS JSON endpoint.

  • Normalized schema. title · company · location · remote · employment_type · department · posted_at (ISO) · salary · url · source_platform — same shape whoever the employer uses.

  • Auto-detect. Pass a slug or domain; the ATS and token are resolved for you.

  • Plus Hacker News "Who is hiring?" The search_hn_hiring tool reads the current month's thread into the same schema, and finds next month's thread by itself when it is posted.

Install

Requires Node.js ≥ 18.

Claude Desktop

Add to claude_desktop_config.json (Settings → Developer → Edit Config):

{
  "mcpServers": {
    "jobs": {
      "command": "npx",
      "args": ["-y", "github:rezearcher/jobs-mcp-server"]
    }
  }
}

Cursor / Cline / Continue

Point the client at the same command (npx -y github:rezearcher/jobs-mcp-server) as a stdio server. In Cursor: Settings → MCP → Add new server → type command.

From source

git clone https://github.com/rezearcher/jobs-mcp-server
cd jobs-mcp-server
node server.mjs          # speaks MCP over stdio
npm test                 # real client handshake + live-data roundtrip

Related MCP server: jobwise

Tools

Tool

What it does

search_jobs

Live normalized postings for one or more companies. Args: companies (string[]), maxPerCompany (default 25, max 200), includeDescription (default false).

detect_ats

Resolve a company slug/domain to {platform, token} without pulling the full list.

list_platforms

The 8 supported platforms and how to address each. No network call.

search_hn_hiring

Live postings from the current month's Hacker News "Ask HN: Who is hiring?" thread, parsed into the same schema. Args: query (keyword filter), remoteOnly (default false), maxResults (default 50, max 200), includeDescription. The monthly thread id is auto-discovered — it rotates on the 1st of every month, so you never re-point it.

get_premium_access

Describe the metered depth endpoints beyond the free reads above — a normalized cross-ATS compensation layer and a per-company hiring-intent signal — served pay-per-call over x402 (USDC on Base, no account, the caller's wallet pays the 402 inline). No network call, no payment.

Free vs. metered

The four search tools above are free and read the live boards directly. Two derived layers are heavier to keep correct — pay-transparency text drifts, cross-ATS comp needs normalizing — so they are served pay-per-call over the x402 rail (USDC on Base, no API key): a few tenths of a cent per call. Call get_premium_access for the exact endpoints, prices, and payment handshake, or hit the free preview first: https://assetfactory-jobs-x402.sigrunner.workers.dev/jobs/preview?companies=stripe.com.

Example

Ask your assistant: "Use the jobs tool to list open engineering roles at Stripe and Palantir." The model calls:

{ "name": "search_jobs",
  "arguments": { "companies": ["greenhouse:stripe", "lever:palantir"], "maxPerCompany": 25 } }

and gets back a jobs[] array plus a resolutions[] log showing how each company was resolved.

Or, to sweep the whole Hacker News hiring thread: "Find remote Rust roles in this month's HN who-is-hiring thread." →

{ "name": "search_hn_hiring",
  "arguments": { "query": "rust", "remoteOnly": true } }

Addressing a company

Form

Example

Notes

bare slug

stripe

auto-detected across platforms

domain

stripe.com

auto-detected

explicit

greenhouse:stripe, lever:palantir, ashby:openai

skips detection

Workday

workday:nvidia.wd5:NVIDIAExternalCareerSite or a *.myworkdayjobs.com URL

explicit only

Why a maintained server (and not a one-off script)

ATS JSON shapes drift and companies migrate between vendors. This server is the public face of a continuously maintained adapter layer: each platform is isolated so a shape change touches one adapter, and a scheduled canary (.github/workflows/smoke.yml) exercises a live board on every push and daily, failing loudly the moment an adapter stops returning rows. That upkeep is the point — it is why the feed keeps working after the day you install it.

License

MIT © Grey Ridge Signals Group LLC. Job content belongs to the respective employers and their ATS providers; this tool only retrieves and normalizes publicly listed postings. Respect each source's terms and rate limits.

Prefer a plain CLI, or a company-level signal instead of an MCP tool?

  • ats-jobs-scraper-cli — the same 8-ATS feed as a zero-dependency command-line tool.

  • unified-jobs-scraper-cli — adds LinkedIn public postings and cross-source dedup.

  • company-enrichment-cli — domain → one clean company record (firmographics, contacts, tech stack) with a rolled-up hiring-intensity signal from the same ATS engine; sales/prospecting buying-intent rather than a raw job feed.

Available Tools

5 tools
detect_atsAInspect

Resolve which applicant-tracking system a company uses and its board token, from a bare slug or domain, without pulling the full posting list. Returns {platform, token} or a not-detected result. Cheap probe — use before search_jobs when you only need to know the ATS.

Inputs: company (required).

get_premium_accessAInspect

Describe the metered depth endpoints available beyond this free server: a normalized cross-ATS compensation layer, a per-company hiring-intent signal, and a hosted high-volume multi-ATS search. These are served pay-per-call over x402 (USDC on Base, no account/API key — the caller's wallet pays the 402 inline). Returns the base URL, each endpoint's path + USD price + what it adds, and the exact payment parameters (network, asset, pay-to, handshake). No network call, no payment.

Inputs: no named parameters.

list_platformsAInspect

List the ATS platforms this server supports and how to address each one (token format, whether auto-detect covers it). No network call.

Inputs: no named parameters.

search_hn_hiringAInspect

Search the CURRENT month's Hacker News "Ask HN: Who is hiring?" thread for live job postings, normalized into the same unified schema as search_jobs (title, company, location, remote, employment_type, salary, url, source_platform). The monthly thread id is auto-discovered (it rotates on the 1st of every month) and each free-text post header is parsed into structured fields. Optionally filter by a keyword and/or remote-only. No company list needed — this is the whole thread. source_platform is "hn"; url is the apply link when present, else the HN permalink.

Inputs: query, maxResults, remoteOnly, includeDescription.

search_jobsAInspect

Fetch live, normalized open job postings for one or more companies across 7 ATS platforms (Greenhouse, Lever, Ashby, SmartRecruiters, Workday, Recruitee, Workable). Each company may be given as a bare slug ("stripe"), a domain ("stripe.com"), or an explicit "platform:token" ("greenhouse:stripe", "lever:palantir", "workday:nvidia.wd5:NVIDIAExternalCareerSite"). The ATS and board token are auto-detected for slugs/domains. Returns a unified schema: title, company, location, remote, employment_type, department, posted_at (ISO), salary, url, source_platform.

Inputs: companies (required), maxPerCompany, includeDescription.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 5 tools

    Disambiguation4/5

    Each tool has a distinct role: detect_ats is a cheap probe, search_jobs fetches company postings, search_hn_hiring pulls a different source, list_platforms is static metadata, and get_premium_access is informational. The only mild overlap is that search_jobs already auto-detects the ATS, which makes detect_ats somewhat redundant unless the caller explicitly wants the probe — but the descriptions call this out clearly.

    Naming Consistency5/5

    All five names follow a clean verb_noun snake_case convention (detect_ats, search_jobs, list_platforms, search_hn_hiring, get_premium_access) with no mixed styles or vague verbs.

    Tool Count5/5

    Five tools is well within the sweet spot and each one earns its place: ATS detection, ATS job search, platform enumeration, HN thread search, and premium-tier discovery. Nothing feels padded or missing at the count level.

    Completeness4/5

    Core discovery workflows are covered — search across 7 ATS platforms plus HN, with a unified schema that includes url, salary, and remote flags. Minor gaps: search_jobs doesn't advertise keyword/location/remote filters (unlike search_hn_hiring), and there's no job-detail or company-listing operation, though agents can work around these via the returned urls.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Enables searching over 1 million enriched job listings from 20,000+ companies directly from MCP-compatible AI tools. Provides tools for job search, company profiles, and AI-powered similar job recommendations with real-time data updates.
      4
      102 npm
      2
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to search, score, and track job applications from ATS boards via MCP, with explainable matching and an append-only application history.
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables searching and retrieving job listings from multiple platforms through MCP.
      2
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables AI assistants to search real-time verified tech job listings, retrieve job details and salary percentiles, match candidate resumes to vacancies, and explore hiring companies through MCP.
      6
      MIT