MCP tool

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.

Connect

Paste this into your client's server config, replacing the placeholder with your own key. Endpoint https://mcp.reqbeat.com/mcp, authenticated with the X-API-Key request header.

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

No key yet? Get an API key — free, no card.

Input schema

{
  "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"
    }
  },
  "required": [
    "company_id",
    "req_key"
  ],
  "title": "get_roleArguments",
  "type": "object"
}