Skip to main content

MCP Tools

The Rako MCP server exposes three core tools.

search_offers

Search for product offers by vertical, price, allowance, provider, or contract length.
ParameterTypeRequiredDescription
verticalstringNosim, broadband, energy, flights, hotels, insurance
providerstringNoFilter by provider name
max_pricenumberNoMaximum monthly price in GBP
min_data_gbnumberNoMinimum data allowance in GB
contract_monthsnumberNoContract length, where 0 means rolling
Returns: matching offers, offer IDs, and a session ID used by checkout.

get_checkout_requirements

Get the information, confirmations, and eligibility checks needed before the user can check out a specific offer.
ParameterTypeRequiredDescription
offer_idstringYesOffer ID from search_offers
Returns: required fields, eligibility criteria, constraints, and suggested next steps for collecting any missing information conversationally. Generate a hosted checkout link for the selected offer. This records the attribution context internally and returns a URL the user can open to complete checkout. This tool does not process payment, charge the user, transfer money, prove conversion, confirm commission, or settle anything. It only generates the checkout-link handoff; conversion requires later platform-side outcome evidence.
ParameterTypeRequiredDescription
session_idstringYesSession ID from search_offers
offer_idstringYesOffer ID the user selected
contextstringNoWhy this offer was chosen
Returns: checkout URL, status, and attribution reference details when available.

MCP flow tutorial

See the canonical flow in a mock transcript with placeholder values.