Skip to main content

get_agencies

Retrieve recruitment agency data for detecting agencies in job listings. Includes agency names, keyword patterns, and detection rules. Credits: 0.125 per call (cached results cost 25%)

Tools

get_agencies_info

Check data freshness before fetching the full agency list. Credits: 0.01
ParameterTypeRequiredDescription
countrystringNoCountry code: GB (default) or FR
curl -X POST https://mcp.debytes.io/mcp \
  -H "Authorization: Bearer deb_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "get_agencies_info",
      "arguments": {"country": "GB"}
    }
  }'
Response:
{
  "agency_count": 215,
  "last_update_timestamp": "2026-03-10T08:00:00Z"
}

get_agencies

Fetch the full agency list with pagination.
ParameterTypeRequiredDescription
countrystringNoCountry code: GB (default) or FR
offsetnumberNoPagination offset (default: 0)
limitnumberNoBatch size, max 100 (default: 100)
curl -X POST https://mcp.debytes.io/mcp \
  -H "Authorization: Bearer deb_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "get_agencies",
      "arguments": {
        "country": "GB",
        "offset": 0,
        "limit": 100
      }
    }
  }'

Response

{
  "agencies": [
    {
      "name": "Hays",
      "keywords": ["hays"],
      "exceptions": []
    }
  ],
  "global_keywords": ["recruitment", "staffing", "agency"],
  "global_exceptions": ["in-house recruitment"]
}

Notes

  • Global keywords and exceptions are included only in the first batch (offset=0)
  • Use get_agencies_info first to check if your local cache is still current
  • Results may be cached for faster response and lower credit cost