Skip to main content

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 Server

The fastest way to connect an agent to Rako is the Rako MCP server. Add it to Claude Desktop, Cursor, or any MCP-compatible client and your agent gets tools to search offers, record recommendations, and start checkout.
mcp-config.json
{
  "mcpServers": {
    "aap": {
      "command": "bunx",
      "args": ["@rakohq/mcp"],
      "env": {
        "AAP_API_KEY": "your-api-key"
      }
    }
  }
}

​
Flow

search_offers → recommend → checkout
  1. search_offers returns eligible offers and a session ID.
  2. recommend records that the agent recommended a specific offer.
  3. checkout starts the merchant checkout flow for the recommendation.

​
Example conversation

User: I need a new SIM deal. Cheap, at least 10GB, no contract.

Agent: [calls search_offers(vertical="sim", min_data_gb=10, contract_months=0)]
       I found 4 options:

       1. SMARTY 30GB — £10/mo (Three network, no credit check)
       2. giffgaff 10GB — £10/mo (O2, 5G included)
       3. giffgaff 25GB — £12/mo (O2, 5G included)
       4. Lebara 5GB — £5/mo (Vodafone)

       I'd recommend SMARTY 30GB — 3x the data at the same price.
       [calls recommend(session_id, offer_id, context="Best value")]

User: Sounds good, let's go with SMARTY.

Agent: [calls checkout(session_id, recommendation_id)]
       Done! Here's your checkout link: https://aap.link/r/...
Use an API key intended for agent/server integrations. Do not put private API keys in client-side code or public repositories.