check_availability MCP tool

What the check_availability MCP tool does

• Use it for: "Can these 2 engineers start on 15 November?" or "How soon can I get a Lead DevSecOps engineer?"

Input

Output

• windows[]: one per profile or role, with earliest_start, start_commitment_working_days (always 4; for clearance roles counted from the client's clearance date), state (now, from_date, soft_held or booked), matching_count (roles only), confidence (high, medium or low).
• hold_options: free_hold_hours (72) and deposit_hold_days (7), with reserve_url.
• notes[]: plain-language caveats, e.g. "1 profile is soft-held by another client until 11 Nov."

Example

The assistant calls check_availability with profile_ids anon_8F2KQ and anon_3LZ7M, start_by 2026-11-15 and residency "uae". The first window shows earliest_start 2026-11-09, state "now", a 4-working-day commitment and high confidence. The second shows state "soft_held", earliest_start 2026-11-12 and medium confidence, with a note that another client's hold ends on 11 Nov. hold_options offer a free 72-hour hold or a 7-day hold with a refundable deposit, and reserve_url opens the reservation page.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "check_availability",
    "arguments": {
      "profile_ids": [
        "anon_8F2KQ",
        "anon_3LZ7M"
      ],
      "start_by": "2026-11-15",
      "residency": "uae"
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "anon_8F2KQ can start 2026-11-09; anon_3LZ7M is soft-held until 7 Nov."
      }
    ],
    "structuredContent": {
      "windows": [
        {
          "profile_id": "anon_8F2KQ",
          "earliest_start": "2026-11-09",
          "start_commitment_working_days": 4,
          "state": "now",
          "confidence": "high"
        },
        {
          "profile_id": "anon_3LZ7M",
          "earliest_start": "2026-11-12",
          "start_commitment_working_days": 4,
          "state": "soft_held",
          "confidence": "medium"
        }
      ],
      "hold_options": {
        "free_hold_hours": 72,
        "deposit_hold_days": 7,
        "reserve_url": "https://remote-pro.ai/en/squads/book/quote"
      },
      "notes": [
        "1 profile is soft-held by another client until 7 Nov."
      ]
    }
  }
}

Errors

• invalid_argument: Provide profile_ids or roles, not both.
• invalid_argument: profile_ids accepts up to 10 items.
• not_found: Profile anon_XXXX isn't on the bench any more. Run search_talent again.
• rate_limited · unavailable

Limits and access

• Public. No token needed.
• Same limits as all tools: 30 per minute anonymous, 120 per minute authenticated.
• With OAuth, windows include profiles your organisation is already holding.