estimate_squad_cost MCP tool

What the estimate_squad_cost MCP tool does

• Use it for: "What would 2 Senior and 1 Lead cloud engineers cost per month in SAR?" → the assistant requests the quote and tells the user to expect it by e-mail.

Input

Output

• reference (e.g. q_7HD29K) and valid_until (30 days from issue)
• delivery: "email" — the itemised proposal goes to the user's work e-mail; eta_minutes: 2
• currency and lines[] (role, seniority, count) as understood by the engine, without amounts
• lane: self_serve (for smaller squads), reservation (for mid-sized squads) or enterprise (for larger squads), with lane_note; the thresholds are stated in the proposal
• assumptions[]: e.g. full-time hours, remote delivery, minimum term
• vat_note: e.g. Prices exclude VAT. Saudi buyers: 15% VAT. UAE buyers: 5% VAT. EU business buyers: reverse charge.
• quote_url: the proposal page (document link and next steps) once the e-mail is sent

Example

The assistant calls estimate_squad_cost with 2 Senior cloud engineers and 1 Lead cloud engineer, currency "SAR", engagement "team_extension" and buyer_country "SA". The response is { "reference": "q_7HD29K", "delivery": "email", "eta_minutes": 2, "valid_until": "<30 days>", "lane": "self_serve", "vat_note": "Prices exclude 15% VAT." }. The text summary reads: "Your itemised quote for 3 cloud engineers is on its way by e-mail (within 2 minutes), valid 30 days. Prices exclude 15% VAT."

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "estimate_squad_cost",
    "arguments": {
      "roles": [
        {
          "role": "Cloud Engineer",
          "seniority": "senior",
          "count": 2
        },
        {
          "role": "Cloud Engineer",
          "seniority": "lead",
          "count": 1
        }
      ],
      "currency": "SAR",
      "engagement": "team_extension",
      "buyer_country": "SA"
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "Estimated monthly cost for 3 cloud engineers, valid 30 days. Prices exclude 15% VAT."
      }
    ],
    "structuredContent": {
      "quote_id": "q_7HD29K",
      "valid_until": "2026-12-07",
      "currency": "SAR",
      "lines": [
        {
          "role": "Cloud Engineer",
          "seniority": "senior",
          "count": 2,
          "monthly_amount": "priced by the pricing engine — delivered in the itemised quote (PDF) by e-mail"
        },
        {
          "role": "Cloud Engineer",
          "seniority": "lead",
          "count": 1,
          "monthly_amount": "priced by the pricing engine — delivered in the itemised quote (PDF) by e-mail"
        }
      ],
      "monthly_total": "priced by the pricing engine — delivered in the itemised quote (PDF) by e-mail",
      "lane": "reservation",
      "lane_note": "routed by the engine from the monthly total",
      "assumptions": [
        "full-time hours",
        "remote delivery",
        "minimum term: 1 month",
        "multi-specialist discount applied by the engine"
      ],
      "vat_note": "Prices exclude VAT. Saudi buyers: 15% VAT. UAE buyers: 5% VAT. EU business buyers: reverse charge.",
      "quote_url": "https://remote-pro.ai/en/squads/book/quote?quote=q_7HD29K"
    }
  }
}

Errors

• invalid_argument: currency must be SAR, AED, USD or EUR.
• invalid_argument: This role isn't in the catalogue. Use a role from search_talent results or describe it in request_proposal notes.
• invalid_argument: count must be between 1 and 20 per role.
• quote_expired (when re-reading an old reference): This reference expired on date. Request a new quote.

Limits and access

• Public. No token needed.
• With OAuth, the e-mailed proposal uses your organisation's contracted rates and Squad Pack discounts.
• Standard limits apply: 30 per minute anonymous, 120 per minute authenticated.