> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rako.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Tools

> Reference for the Rako MCP server tools.

# MCP Tools

The Rako MCP server exposes three core tools.

## `search_offers`

Search for product offers by vertical, price, allowance, provider, or contract length.

| Parameter         | Type   | Required | Description                                                    |
| ----------------- | ------ | -------- | -------------------------------------------------------------- |
| `vertical`        | string | No       | `sim`, `broadband`, `energy`, `flights`, `hotels`, `insurance` |
| `provider`        | string | No       | Filter by provider name                                        |
| `max_price`       | number | No       | Maximum monthly price in GBP                                   |
| `min_data_gb`     | number | No       | Minimum data allowance in GB                                   |
| `contract_months` | number | No       | Contract 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.

| Parameter  | Type   | Required | Description                   |
| ---------- | ------ | -------- | ----------------------------- |
| `offer_id` | string | Yes      | Offer ID from `search_offers` |

**Returns:** required fields, eligibility criteria, constraints, and suggested next steps for collecting any missing information conversationally.

## `get_checkout_link`

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.

| Parameter    | Type   | Required | Description                     |
| ------------ | ------ | -------- | ------------------------------- |
| `session_id` | string | Yes      | Session ID from `search_offers` |
| `offer_id`   | string | Yes      | Offer ID the user selected      |
| `context`    | string | No       | Why this offer was chosen       |

**Returns:** checkout URL, status, and attribution reference details when available.

<Card title="MCP flow tutorial" href="/guides/mcp-agent-flow">
  See the canonical flow in a mock transcript with placeholder values.
</Card>