MCP & APImcp.remote-pro.ai

estimate_squad_cost MCP tool

The estimate_squad_cost MCP tool prices a squad using the same engine as remote-pro.ai. It returns line items, a monthly total, the checkout lane, assumptions, a VAT note and a quote_id valid for 30 days. Use it when a user asks what a team would cost. It's public and read-only; prices become binding only in a quotation.

Developer preview until live: the MCP server and the platform API are not running yet. Tools, endpoints and examples on these pages describe the interface we are building; a call made today returns nothing.

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

FieldTypeRequiredNotes
rolesobject[]YesEach: role, seniority, count; optional onsite (none, riyadh, dubai) and hours_per_month
currencyenumYesSAR, AED, USD or EUR
engagementenumNoteam_extension (default), ready_squad or managed_delivery
duration_monthsintegerNoDefaults to the minimum term (1 month for team_extension; 3 months for ready_squad and managed_delivery)
buyer_countrystringNoISO 3166 alpha-2, used for the VAT note
profile_idsstring[]NoPrice specific profiles from search_talent

Output

  • quote_id (e.g. q_7HD29K) and valid_until (30 days from issue)
  • currency, lines[] (role, seniority, count, monthly_amount), monthly_total
  • lane: self_serve (up to USD pb_lane_self_serve_usd per month), reservation (USD pb_lane_self_serve_usd–pb_lane_reservation_usd) or enterprise (above USD pb_lane_reservation_usd), with lane_note
  • 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: 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

tools/call
{
  "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

result
{
  "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.

Frequently asked questions

No. They come from the same pricing engine as remote-pro.ai and stay valid for 30 days through the quote_id, but prices become binding only in a quotation and SOW. Remote Pro Ai pricing is quotation-based, and each estimate lists the assumptions behind it.

The lane tells the assistant how the deal will be completed. Up to USD per month is self-serve with card payment and a click-through MSA. USD – is a reservation with a quotation PDF. Above USD goes to the Enterprise lane with a formal quotation.

No. Amounts exclude VAT, and the vat_note explains the treatment for the buyer's country: 15% VAT for Saudi buyers, 5% for UAE buyers and reverse charge for EU business buyers. Assistants should repeat the note when quoting a figure. Never add VAT yourself.

30 days from issue, matching Remote Pro Ai's quotation validity. Pass it to request_proposal to carry the same squad and prices into a draft proposal. After 30 days, the tool returns quote_expired and you can create a new estimate. A quote_id doesn't hold engineers; use a 72-hour or 7-day hold for that.

Yes. Pass profile_ids from search_talent and the estimate prices those profiles at their level. Without profile_ids, the estimate prices the roles and levels you describe at standard rates. Pricing profiles directly gives the user a more precise figure and lets the quote_id carry the same people into request_proposal, so the draft proposal names the profiles they chose.