MCP tool

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.

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": {
    "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"
    }
  },
  "required": [
    "criteria"
  ],
  "title": "find_qualified_reqsArguments",
  "type": "object"
}