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?"
Input
| Field | Type | Required | Notes |
|---|---|---|---|
roles | object[] | Yes | Each: role, seniority, count; optional onsite (none, riyadh, dubai) and hours_per_month |
currency | enum | Yes | SAR, AED, USD or EUR |
engagement | enum | No | team_extension (default), ready_squad or managed_delivery |
duration_months | integer | No | Defaults to the minimum term (1 month for team_extension; 3 months for ready_squad and managed_delivery) |
buyer_country | string | No | ISO 3166 alpha-2, used for the VAT note |
profile_ids | string[] | No | Price specific profiles from search_talent |
Output
quote_id(e.g. q_7HD29K) andvalid_until(30 days from issue)currency,lines[](role,seniority,count,monthly_amount),monthly_totallane:self_serve(up to USD pb_lane_self_serve_usd per month),reservation(USD pb_lane_self_serve_usd–pb_lane_reservation_usd) orenterprise(above USD pb_lane_reservation_usd), withlane_noteassumptions[]: e.g. full-time hours, remote delivery, minimum termvat_note: e.g. Prices exclude VAT. Saudi buyers: 15% VAT. UAE buyers: 5% VAT. EU business buyers: reverse charge.quote_url: shareable quote page with PDF download and next steps
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 returns quote_id q_7HD29K valid until 30 days from today, 2 lines (Senior at SAR pb_senior_sar and Lead at SAR pb_lead_sar per seat per month), a monthly total, lane "self_serve" or "reservation" depending on the total, assumptions of full-time remote delivery over the 1-month minimum term for team_extension, and the VAT note for Saudi buyers. The text summary reads: "Estimated monthly cost for 3 cloud engineers, valid 30 days. Prices exclude 15% VAT."
Request
{
"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"
}
}
}Response
{
"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-11-19",
"currency": "SAR",
"lines": [
{
"role": "Cloud Engineer",
"seniority": "senior",
"count": 2,
"monthly_amount": "46000.00"
},
{
"role": "Cloud Engineer",
"seniority": "lead",
"count": 1,
"monthly_amount": "29900.00"
}
],
"monthly_total": "72864.00",
"lane": "self_serve",
"lane_note": "",
"assumptions": [
"full-time hours",
"remote delivery",
"minimum term: 1 month",
"3+ specialists: −4%"
],
"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 quote): This quote_id expired on date. Create a new estimate.
Limits and access
- Public. No token needed.
- With OAuth, estimates use your organisation's contracted rates and Squad Pack discounts.
- Standard limits apply: 30 per minute anonymous, 120 per minute authenticated.