Reqbeat Hiring Signals

Official15 tools

by reqbeat

Find companies hiring for a role and geo, qualify them, and watch them for changes.

MCP Server: com.reqbeat/hiring-signals

The com.reqbeat/hiring-signals MCP server helps users find companies hiring for a specific role and geographic area. It supports qualifying those companies and watching for changes over time. The server exposes 10 tools to support these workflows.

🛠️ Key Features

Find companies hiring for a role and geo
Qualify hiring targets
Watch for changes
10 available tools

🚀 Use Cases

Research employers hiring for a given role in a given location
Screen and qualify hiring companies based on criteria
Monitor hiring signals for updates

⚡ Developer Benefits

Tool-based access (10 tools) for the end-to-end process: find → qualify → watch

⚠️ Limitations

Description does not specify authentication, integrations, output formats, or data sources.

Topics

claudecursorgtm-engineeringhiring-signalsjob-postingslead-generationmcpmcp-servermodel-context-protocolgemini-cli-extension

Captured live from the server via tools/list.

is_hiring

WHEN an agent already holds a company and needs to qualify it -- the cheap gate before spending a richer call. LinkedIn-excluded (ATS tenants plus public job boards and aggregators) and freshness-floored. Takes the integer `company_id` from an earlier result, not a company name or domain. company_id=1234 -> is_hiring true, open_req_count 7, coverage_status "ats_direct_hit". company_id=5678 -> is_hiring false with coverage_status "no_ats_signal" -- that company has no ATS coverage yet, which is not evidence it is quiet, so do not score it as a negative. No key yet? Pass `plane_api_key` as an empty string and the call answers with a signup link instead of an auth error. To find companies in the first place, use `who_is_hiring_for`.

Parameters3

company_id	integer	required
idempotency_key	any	optional
plane_api_key	any	optional	Deprecated: pass the key in the `X-API-Key` header, or omit the header for demo mode. Removed in 1.2.

Raw schema

{
  "type": "object",
  "properties": {
    "company_id": {
      "title": "Company Id",
      "type": "integer"
    },
    "idempotency_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Idempotency Key"
    },
    "plane_api_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Deprecated: pass the key in the `X-API-Key` header, or omit the header for demo mode. Removed in 1.2.",
      "title": "Plane Api Key"
    }
  },
  "required": [
    "company_id"
  ],
  "title": "is_hiringArguments"
}

get_open_reqs

The company's current active reqs, deduped across boards -- LinkedIn-excluded: ATS tenants plus public job boards and aggregators; each row's `boards` names its source. Freshness-floored. Each row's `first_seen` is our first observation of the req, not the employer's posting date; `source_posted_at` is the date the source itself published, null when it gave none. `function` is a function name (a prior result's `function_name`, like 'Software & IT') or a function id (its `function`); anything else, like 'engineering', is rejected with an explicit error that lists the names, rather than an empty result. `limit` is bounded: an oversized page is rejected rather than truncated.

Parameters6

company_id	integer	required
function	any	optional
country	any	optional
limit	integer	optional
idempotency_key	any	optional
plane_api_key	any	optional	Deprecated: pass the key in the `X-API-Key` header, or omit the header for demo mode. Removed in 1.2.

Raw schema

{
  "type": "object",
  "properties": {
    "company_id": {
      "title": "Company Id",
      "type": "integer"
    },
    "function": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Function"
    },
    "country": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Country"
    },
    "limit": {
      "default": 50,
      "title": "Limit",
      "type": "integer"
    },
    "idempotency_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Idempotency Key"
    },
    "plane_api_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Deprecated: pass the key in the `X-API-Key` header, or omit the header for demo mode. Removed in 1.2.",
      "title": "Plane Api Key"
    }
  },
  "required": [
    "company_id"
  ],
  "title": "get_open_reqsArguments"
}

hiring_pulse

One number set for one company: how many reqs it opened in the last 30 days, a `velocity` ratio of that against the 30 days before it, a `direction` of up / flat / down between the two, a surge flag, and `momentum` -- postings published per week, a flow rather than a stock. Use it to rank or score a company you already hold a `company_id` for. Freshness is controlled by `max_age` (seconds); a company with no ATS/board data yet returns `{job_id, status: "crawling"}` instead of a body -- poll again later, do not read it as "not hiring". For the whole picture in one round-trip use `pre_action_brief`; for a cheap yes/no use `is_hiring`.

Parameters4

company_id	integer	required
max_age	any	optional
idempotency_key	any	optional
plane_api_key	any	optional	Deprecated: pass the key in the `X-API-Key` header, or omit the header for demo mode. Removed in 1.2.

Raw schema

{
  "type": "object",
  "properties": {
    "company_id": {
      "title": "Company Id",
      "type": "integer"
    },
    "max_age": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Max Age"
    },
    "idempotency_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Idempotency Key"
    },
    "plane_api_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Deprecated: pass the key in the `X-API-Key` header, or omit the header for demo mode. Removed in 1.2.",
      "title": "Plane Api Key"
    }
  },
  "required": [
    "company_id"
  ],
  "title": "hiring_pulseArguments"
}

who_is_hiring_for

WHEN an agent needs to FIND the companies worth working -- the sourcing step, before it knows which companies exist. Reverse who's-hiring-for {title, geo} search: companies with active reqs matching `q`/`geo`/`since`, deduped by company, keyset-paginated via `cursor`. `q` is free text matched against the posting title, not an id; plurals and other inflections match, so "backend engineers" is the same search. `geo` is resolved to a stored country before matching; an unresolvable one is an explicit error, never a quietly partial page. `limit` is bounded -- page through the full set with `cursor` instead of raising it. Billed per company returned (~0.10 USD each) -- an empty result bills nothing. q="backend engineer", geo="USA" -> the companies with matching active reqs, each with its pulse and its matched reqs. geo="Atlantis" -> an explicit unresolvable-country error rather than an empty page. No key yet? On the hosted HTTP endpoint the first calls are free: pass `plane_api_key` as an empty string and the search runs on a shared demo credential -- a smaller page, billed to nobody -- until a per-IP limit is reached, after which the answer becomes a signup link whose minted key finishes this exact search. On any other transport a blank key answers with that signup link straight away. Already holding a company_id and only need a yes/no? Use `is_hiring`.

Parameters9

q	any	optional
geo	any	optional
since	any	optional
source_type	any	optional
exclude_agencies	boolean	optional
cursor	any	optional
limit	integer	optional
idempotency_key	any	optional
plane_api_key	any	optional	Deprecated: pass the key in the `X-API-Key` header, or omit the header for demo mode. Removed in 1.2.

Raw schema

{
  "type": "object",
  "properties": {
    "q": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Q"
    },
    "geo": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Geo"
    },
    "since": {
      "anyOf": [
        {
          "format": "date-time",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Since"
    },
    "source_type": {
      "anyOf": [
        {
          "enum": [
            "ats_tenant",
            "board"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Source Type"
    },
    "exclude_agencies": {
      "default": false,
      "title": "Exclude Agencies",
      "type": "boolean"
    },
    "cursor": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Cursor"
    },
    "limit": {
      "default": 20,
      "title": "Limit",
      "type": "integer"
    },
    "idempotency_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Idempotency Key"
    },
    "plane_api_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Deprecated: pass the key in the `X-API-Key` header, or omit the header for demo mode. Removed in 1.2.",
      "title": "Plane Api Key"
    }
  },
  "title": "who_is_hiring_forArguments"
}

search_jobs

Flat, role-granular job search -- the individual open roles across companies matching `function` / `geo` (country) / `since`, one row per logical req (each with its own `company_id` + `req_key`), LinkedIn-excluded (ATS tenants plus public job boards and aggregators; each row's `board` names its source) + freshness-floored. `since` filters on `first_seen`, our first observation of the req (not the employer's posting date); each row's `source_posted_at` is the date the source itself published, null when it gave none. Keyset-paginated via the opaque `cursor` (a prior call's `next_cursor`). Use `who_is_hiring_for` for the company-granular reverse view. `function` is a function name (a prior result's `function_name`, like 'Software & IT') or a function id (its `function`); anything else, like 'engineering', is rejected with an explicit error that lists the names, rather than an empty result -- pass plain language as `q` instead, which searches the posting's own title, expanded semantically to nearby titles, and reports each row's `relevance` (0-1). `q` is independent of `function`: pass both to search titles within one function. `sort` is 'relevance' (the default with a `q`) or 'recency'; omit both and the page keeps its stable default order. `limit` is bounded: an oversized page is rejected rather than truncated, so page through the full set with `cursor` instead of raising `limit`. No key yet? On the hosted HTTP endpoint the first calls are free: send no `X-API-Key` header and the search runs on a shared demo credential -- a smaller page, billed to nobody, and the result says so -- until a per-IP limit is reached, after which the answer becomes a signup link whose minted key finishes this exact search. On any other transport a blank key answers with that signup link straight away.

Parameters11

function	any	optional
geo	any	optional
since	any	optional
q	any	optional
sort	any	optional
source_type	any	optional
exclude_agencies	boolean	optional
cursor	any	optional
limit	integer	optional
idempotency_key	any	optional
plane_api_key	any	optional	Deprecated: pass the key in the `X-API-Key` header, or omit the header for demo mode. Removed in 1.2.

Raw schema

{
  "type": "object",
  "properties": {
    "function": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Function"
    },
    "geo": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Geo"
    },
    "since": {
      "anyOf": [
        {
          "format": "date-time",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Since"
    },
    "q": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Q"
    },
    "sort": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Sort"
    },
    "source_type": {
      "anyOf": [
        {
          "enum": [
            "ats_tenant",
            "board"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Source Type"
    },
    "exclude_agencies": {
      "default": false,
      "title": "Exclude Agencies",
      "type": "boolean"
    },
    "cursor": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Cursor"
    },
    "limit": {
      "default": 20,
      "title": "Limit",
      "type": "integer"
    },
    "idempotency_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Idempotency Key"
    },
    "plane_api_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Deprecated: pass the key in the `X-API-Key` header, or omit the header for demo mode. Removed in 1.2.",
      "title": "Plane Api Key"
    }
  },
  "title": "search_jobsArguments"
}

get_role

One open role's detail, addressed by the `company_id` + `req_key` pair every `search_jobs` row already carries -- the follow-up call for a role you hold an identifier for, instead of re-pulling the whole company with `get_open_reqs`. Scoped exactly as `search_jobs` is: LinkedIn-excluded (ATS tenants plus public job boards and aggregators) and freshness-floored. The body adds `raw_title` (the posting's own title) and `boards`, the full deduped list of boards reporting this req. A role that does not exist, is closed, or has not reached the freshness floor is an explicit error, never an empty success -- and it is not billed. No key yet? On the hosted HTTP endpoint the first calls are free: send no `X-API-Key` header and the lookup runs on a shared demo credential, billed to nobody and marked as such, until a per-IP limit is reached.

Parameters4

company_id	integer	required
req_key	string	required
idempotency_key	any	optional
plane_api_key	any	optional	Deprecated: pass the key in the `X-API-Key` header, or omit the header for demo mode. Removed in 1.2.

Raw schema

{
  "type": "object",
  "properties": {
    "company_id": {
      "title": "Company Id",
      "type": "integer"
    },
    "req_key": {
      "title": "Req Key",
      "type": "string"
    },
    "idempotency_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Idempotency Key"
    },
    "plane_api_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Deprecated: pass the key in the `X-API-Key` header, or omit the header for demo mode. Removed in 1.2.",
      "title": "Plane Api Key"
    }
  },
  "required": [
    "company_id",
    "req_key"
  ],
  "title": "get_roleArguments"
}

find_qualified_reqs

WHEN an agent already knows its ideal customer profile and wants the matching open roles as rows it can act on: several countries, an industry, a headcount band and title keywords in ONE call, instead of a search followed by a lookup per company. `criteria` takes up to three groups -- `company` (country, industry, industry_terms, headcount_band, company_kind), `req` (q, q_excludes, seniority_level, function, skills, remote_type, location) and `event` (company_id, board, source_type, ats_vendor, country) -- AND across fields, OR within one. A field outside that list is an explicit error, never quietly dropped. criteria={"company": {"country": ["United States", "Germany"]}, "req": {"q": ["backend engineer"]}} -> live backend roles in both countries, each row naming the company and carrying the posting URL, seniority, skills and declared or estimated yearly pay. `salary_min_usd` / `salary_max_usd` bracket that pay. Agencies and expired postings are excluded by default. Page with `cursor` (the previous `next_cursor`); `limit` is bounded. Billed per row returned, and an empty page bills nothing. Needs an API key: without one the answer is a signup link. For a first look at who is hiring before you have a key, use `who_is_hiring_for`.

Parameters10

criteria	object	required
exclude_agencies	boolean	optional
live_only	boolean	optional
salary_min_usd	any	optional
salary_max_usd	any	optional
since	any	optional
cursor	any	optional
limit	integer	optional
idempotency_key	any	optional
plane_api_key	any	optional	Deprecated: pass the key in the `X-API-Key` header, or omit the header for demo mode. Removed in 1.2.

Raw schema

{
  "type": "object",
  "properties": {
    "criteria": {
      "additionalProperties": true,
      "title": "Criteria",
      "type": "object"
    },
    "exclude_agencies": {
      "default": true,
      "title": "Exclude Agencies",
      "type": "boolean"
    },
    "live_only": {
      "default": true,
      "title": "Live Only",
      "type": "boolean"
    },
    "salary_min_usd": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Salary Min Usd"
    },
    "salary_max_usd": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Salary Max Usd"
    },
    "since": {
      "anyOf": [
        {
          "format": "date-time",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Since"
    },
    "cursor": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Cursor"
    },
    "limit": {
      "default": 25,
      "title": "Limit",
      "type": "integer"
    },
    "idempotency_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Idempotency Key"
    },
    "plane_api_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Deprecated: pass the key in the `X-API-Key` header, or omit the header for demo mode. Removed in 1.2.",
      "title": "Plane Api Key"
    }
  },
  "required": [
    "criteria"
  ],
  "title": "find_qualified_reqsArguments"
}

pre_action_brief

Everything an agent needs before acting on one company, in one bounded round-trip instead of five: the hiring pulse, its top open reqs deduped across boards, first-hire-by-function events, hardest-to-fill (reposted) reqs and ATS-vendor migrations, pre-joined and each section capped so the payload stays compact. Use it right before writing outreach or a qualification note for a `company_id` you already hold. Honors `max_age` (seconds); a company with no ATS/board data returns `{job_id, status: "crawling"}`. If you only need the velocity number, `hiring_pulse` is cheaper.

Parameters4

company_id	integer	required
max_age	any	optional
idempotency_key	any	optional
plane_api_key	any	optional	Deprecated: pass the key in the `X-API-Key` header, or omit the header for demo mode. Removed in 1.2.

Raw schema

{
  "type": "object",
  "properties": {
    "company_id": {
      "title": "Company Id",
      "type": "integer"
    },
    "max_age": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Max Age"
    },
    "idempotency_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Idempotency Key"
    },
    "plane_api_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Deprecated: pass the key in the `X-API-Key` header, or omit the header for demo mode. Removed in 1.2.",
      "title": "Plane Api Key"
    }
  },
  "required": [
    "company_id"
  ],
  "title": "pre_action_briefArguments"
}

get_changes

The change feed, not a search: ledger events -- a req opened, re-observed, reposted or closed -- with `event_seq > since`, ascending, plus `next_cursor`. Replay with `next_cursor` instead of polling or re-searching; an empty page bills nothing and one `change` unit is metered per event returned. Filter by `company_id`, or by one exact `event_type`. `limit` is bounded -- page with the cursor rather than raising it. Free-tier callers see events at the same freshness floor as every other free read. This is the pull-based twin of `watch_company` (push via webhook).

Parameters6

since	integer	required
company_id	any	optional
event_type	any	optional
limit	integer	optional
idempotency_key	any	optional
plane_api_key	any	optional	Deprecated: pass the key in the `X-API-Key` header, or omit the header for demo mode. Removed in 1.2.

Raw schema

{
  "type": "object",
  "properties": {
    "since": {
      "title": "Since",
      "type": "integer"
    },
    "company_id": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Company Id"
    },
    "event_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Event Type"
    },
    "limit": {
      "default": 100,
      "title": "Limit",
      "type": "integer"
    },
    "idempotency_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Idempotency Key"
    },
    "plane_api_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Deprecated: pass the key in the `X-API-Key` header, or omit the header for demo mode. Removed in 1.2.",
      "title": "Plane Api Key"
    }
  },
  "required": [
    "since"
  ],
  "title": "get_changesArguments"
}

find_company

WHEN you hold a company's website or name but not the `company_id` every company-scoped tool takes (`is_hiring`, `get_open_reqs`, `hiring_pulse`, `pre_action_brief`, `watch_company`). Pass exactly one of `domain` or `name`; both or neither is an error naming that rule. `domain` takes a bare host or a full URL and matches exactly ({"domain": "https://www.stripe.com/jobs"} -> the companies at `stripe.com`); `name` returns up to five candidates, each with a `match_confidence` -- 1.0 for an exact name, 0.8 for a match once legal suffixes are dropped. Each company carries `company_id`, `company_name`, `company_domain`, `country_code` and `coverage_status`, and no hiring signal: ask `is_hiring` for that. Nothing matching is an empty `companies` list, never an error. Never billed. No key yet? On the hosted HTTP endpoint send no `X-API-Key` header and the lookup runs on a shared demo credential until a per-IP limit is reached.

Parameters3

domain	any	optional
name	any	optional
plane_api_key	any	optional	Deprecated: pass the key in the `X-API-Key` header, or omit the header for demo mode. Removed in 1.2.

Raw schema

{
  "type": "object",
  "properties": {
    "domain": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Domain"
    },
    "name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Name"
    },
    "plane_api_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Deprecated: pass the key in the `X-API-Key` header, or omit the header for demo mode. Removed in 1.2.",
      "title": "Plane Api Key"
    }
  },
  "title": "find_companyArguments"
}

register_webhook

Register the delivery target a watch fires to, and get back the `webhook_endpoint_id` `watch_company` needs -- call this first if you do not already hold one. Idempotent: registering the same `url` twice returns the same id, so retrying is safe and never leaves you with two endpoints. `secret` is optional; supply one to verify the `X-Plane-Signature` on delivered payloads, omit it and one is generated (it is never returned). Registration itself is free -- the `watch_company` call that follows is what bills.

Parameters3

url	string	required
secret	any	optional
plane_api_key	any	optional	Deprecated: pass the key in the `X-API-Key` header, or omit the header for demo mode. Removed in 1.2.

Raw schema

{
  "type": "object",
  "properties": {
    "url": {
      "title": "Url",
      "type": "string"
    },
    "secret": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Secret"
    },
    "plane_api_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Deprecated: pass the key in the `X-API-Key` header, or omit the header for demo mode. Removed in 1.2.",
      "title": "Plane Api Key"
    }
  },
  "required": [
    "url"
  ],
  "title": "register_webhookArguments"
}

watch_company

Subscribe to a company's hiring events on a registered webhook -- `webhook_endpoint_id` must belong to the same customer as the authenticated key. Meters one `watch` unit. `event_types` names which events fire it, at least one of: `opened` (a req seen for the first time), `reobserved` (a known req seen again on a later day), `reposted` (a req that came back after it was gone), `closed` (a req verified gone from its source). Anything else is refused and creates nothing: a watch on a type that never fires would be billed and silent. A free key holds a limited number of watches at once; the one past that is refused with the same 402 the REST route raises, and cancelling a watch returns the slot.

Parameters5

company_id	integer	required
event_types	array	required
webhook_endpoint_id	integer	required
idempotency_key	any	optional
plane_api_key	any	optional	Deprecated: pass the key in the `X-API-Key` header, or omit the header for demo mode. Removed in 1.2.

Raw schema

{
  "type": "object",
  "properties": {
    "company_id": {
      "title": "Company Id",
      "type": "integer"
    },
    "event_types": {
      "items": {
        "enum": [
          "opened",
          "reobserved",
          "reposted",
          "closed"
        ],
        "type": "string"
      },
      "minItems": 1,
      "title": "Event Types",
      "type": "array"
    },
    "webhook_endpoint_id": {
      "title": "Webhook Endpoint Id",
      "type": "integer"
    },
    "idempotency_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Idempotency Key"
    },
    "plane_api_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Deprecated: pass the key in the `X-API-Key` header, or omit the header for demo mode. Removed in 1.2.",
      "title": "Plane Api Key"
    }
  },
  "required": [
    "company_id",
    "event_types",
    "webhook_endpoint_id"
  ],
  "title": "watch_companyArguments"
}

list_watches

WHEN you need to see what you are subscribed to -- before adding a watch, or to find the `id` `cancel_watch` takes. Returns your live watches newest first, cancelled ones excluded: {} -> {"watches": [{"id": ..., "company_id": ..., "event_types": [...], "webhook_endpoint_id": ..., "status": "firing", ...}]}. Each also reports its heartbeat -- `last_fired_at`, `fires_last_7d`, `fires_last_30d`, `fires_last_hour` against `max_fires_per_hour`, `rate_limited`, and a one-word `status` -- so a watch silent because nobody is hiring reads differently from one that can never match or whose endpoint is failing. Never billed. Needs your key: a blank one returns a signup link.

Parameters1

plane_api_key

any

optional

Deprecated: pass the key in the `X-API-Key` header, or omit the header for demo mode. Removed in 1.2.

Raw schema

{
  "type": "object",
  "properties": {
    "plane_api_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Deprecated: pass the key in the `X-API-Key` header, or omit the header for demo mode. Removed in 1.2.",
      "title": "Plane Api Key"
    }
  },
  "title": "list_watchesArguments"
}

cancel_watch

WHEN a watch should stop firing. Takes the `id` `watch_company` returned (or `list_watches` lists): {"watch_id": 42} -> {"id": 42, "canceled": true}. Idempotent -- cancelling a watch you already cancelled succeeds again. An id that is not one of your watches is an error, identical whether it belongs to someone else or does not exist. Frees the slot a free key's watch limit counts. Never billed. Needs your key: a blank one returns a signup link.

Parameters2

watch_id	integer	required
plane_api_key	any	optional	Deprecated: pass the key in the `X-API-Key` header, or omit the header for demo mode. Removed in 1.2.

Raw schema

{
  "type": "object",
  "properties": {
    "watch_id": {
      "title": "Watch Id",
      "type": "integer"
    },
    "plane_api_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Deprecated: pass the key in the `X-API-Key` header, or omit the header for demo mode. Removed in 1.2.",
      "title": "Plane Api Key"
    }
  },
  "required": [
    "watch_id"
  ],
  "title": "cancel_watchArguments"
}

write_outcome

WHEN a company you reached through a signal converts -- a reply, a meeting, a closed deal -- report it back. Takes the `company_id`, a short `outcome` label of your choosing (e.g. "meeting_booked"), the `observed_at` time it happened and, optionally, the `req_key` of the role that prompted the outreach: {"company_id": 1234, "outcome": "meeting_booked", "observed_at": "2026-10-01T09:00:00Z"} -> {"id": 87}. Each call adds one record, visible only to your own account; nothing is overwritten, so report a later stage as a new outcome. Never billed. Needs your key: a blank one returns a signup link.

Parameters5

company_id	integer	required
outcome	string	required
observed_at	string	required
req_key	any	optional
plane_api_key	any	optional	Deprecated: pass the key in the `X-API-Key` header, or omit the header for demo mode. Removed in 1.2.

Raw schema

{
  "type": "object",
  "properties": {
    "company_id": {
      "title": "Company Id",
      "type": "integer"
    },
    "outcome": {
      "title": "Outcome",
      "type": "string"
    },
    "observed_at": {
      "format": "date-time",
      "title": "Observed At",
      "type": "string"
    },
    "req_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Req Key"
    },
    "plane_api_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Deprecated: pass the key in the `X-API-Key` header, or omit the header for demo mode. Removed in 1.2.",
      "title": "Plane Api Key"
    }
  },
  "required": [
    "company_id",
    "outcome",
    "observed_at"
  ],
  "title": "write_outcomeArguments"
}

README.md5 KBView on GitHub

Reqbeat Hiring Signals

https://reqbeat.com/mcp/ · Docs · Pricing · Status

Find companies hiring for a role and geo, qualify them, and watch them for changes.

Remote server, streamable-http. Nothing to run locally, nothing to build — the endpoint below is the whole install.

Try it in 30 seconds (no account)

json

{
  "mcpServers": {
    "com-reqbeat-hiring-signals": {
      "url": "https://mcp.reqbeat.com/mcp"
    }
  }
}

Then ask your agent: "Which companies are hiring backend engineers in the UK right now?"

No header means demo mode: a shared credential, a smaller page and a per-IP limit. When it runs out you get a sign-up link.

Full access (your key)

Get a key at https://reqbeat.com — free tier, no card — and send it as X-API-Key on the same endpoint. There is one server; the header is what picks the tier.

json

{
  "mcpServers": {
    "com-reqbeat-hiring-signals": {
      "url": "https://mcp.reqbeat.com/mcp",
      "headers": {
        "X-API-Key": "YOUR_REQBEAT_API_KEY"
      }
    }
  }
}

Claude Code

bash

claude mcp add --transport http com-reqbeat-hiring-signals https://mcp.reqbeat.com/mcp \
  --header "X-API-Key: YOUR_REQBEAT_API_KEY"

Cursor

Paste this into your browser's address bar — Cursor takes the config on the link:

code

cursor://anysphere.cursor-deeplink/mcp/install?name=com-reqbeat-hiring-signals&config=eyJ1cmwiOiJodHRwczovL21jcC5yZXFiZWF0LmNvbS9tY3AiLCJoZWFkZXJzIjp7IlgtQVBJLUtleSI6IllPVVJfUkVRQkVBVF9BUElfS0VZIn19

Tools (14)

Tool	What it does
`is_hiring`	WHEN an agent already holds a company and needs to qualify it -- the cheap gate before spending a richer call. ATS/board-only and freshness-floored. Takes the integer `company_id` …
`get_open_reqs`	The company's current active reqs, deduped across boards -- ATS/board-only, freshness-floored. `function` must be a function id (as seen in prior results); a plain role name like …
`hiring_pulse`	One number set for one company: how many reqs it opened in the last 30 days, a `velocity` ratio of that against the 30 days before it, a `direction` of up / flat / down between …
`who_is_hiring_for`	WHEN an agent needs to FIND the companies worth working -- the sourcing step, before it knows which companies exist. Reverse who's-hiring-for {role, geo} search: companies with …
`search_jobs`	Flat, role-granular job search -- the individual open roles across companies matching `role` (function) / `geo` (country) / `since`, one row per logical req (each with its own …
`get_role`	One open role's detail, addressed by the `company_id` + `req_key` pair every `search_jobs` row already carries -- the follow-up call for a role you hold an identifier for, instead …
`pre_action_brief`	Everything an agent needs before acting on one company, in one bounded round-trip instead of five: the hiring pulse, its top open reqs deduped across boards, …
`get_changes`	The change feed, not a search: ledger events -- a req opened, re-observed, reposted or closed -- with `event_seq > since`, ascending, plus `next_cursor`. Replay with `next_cursor` …
`find_company`	WHEN you hold a company's website or name but not the `company_id` every company-scoped tool takes (`is_hiring`, `get_open_reqs`, `hiring_pulse`, `pre_action_brief`, …
`register_webhook`	Register the delivery target a watch fires to, and get back the `webhook_endpoint_id` `watch_company` needs -- call this first if you do not already hold one. Idempotent: …
`watch_company`	Subscribe to a company's hiring events on a registered webhook -- `webhook_endpoint_id` must belong to the same customer as the authenticated key. Meters one `watch` unit. A free …
`list_watches`	WHEN you need to see what you are subscribed to -- before adding a watch, or to find the `id` `cancel_watch` takes. Returns your live watches newest first, cancelled ones …
`cancel_watch`	WHEN a watch should stop firing. Takes the `id` `watch_company` returned (or `list_watches` lists): {"watch_id": 42} -> {"id": 42, "canceled": true}. Idempotent -- cancelling a …
`write_outcome`	Write back a conversion outcome for `company_id` -- the label-flywheel substrate. Appends to `outcome_labels` scoped to the caller's own customer. Plane session only: …

Summaries are trimmed for reading. Your client gets the full descriptions live from tools/list, and this table is re-rendered from the same document.

What it is not

A rolling 30-day window over open requisitions, not multi-year history. No contact data and no people — this plane sells hiring demand, not person records.

Generated, not hand-written

Every file here is rendered from the live server.json at https://mcp.reqbeat.com/server.json, and pushed by static-site/deploy/mcp_server_repo_publish.py in reqbeat.git. Edit the renderer, never these files — a hand-edit is replaced on the next publish, silently.

Install

Tools (15)

is_hiringget_open_reqshiring_pulsewho_is_hiring_forsearch_jobsget_rolefind_qualified_reqspre_action_brief

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp.reqbeat.com/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "hiring-signals": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.reqbeat.com/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

Reqbeat Hiring Signals

MCP Server: com.reqbeat/hiring-signals

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

is_hiring

get_open_reqs

hiring_pulse

who_is_hiring_for

search_jobs

get_role

find_qualified_reqs

pre_action_brief

get_changes

find_company

register_webhook

watch_company

list_watches

cancel_watch

write_outcome

Reqbeat Hiring Signals

Try it in 30 seconds (no account)

Full access (your key)

Claude Code

Cursor

Tools (14)

What it is not

Links

Generated, not hand-written

Install

Remote endpoint

Related servers