Connect your agent
in three calls

{
  "mcpServers": {
    "aap": {
      "command": "bunx",
      "args": ["@rakohq/mcp"],
      "env": {
        "AAP_API_KEY": "your-api-key"
      }
    }
  }
}

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/...

import { AAP } from '@rakohq/sdk';

const aap = new AAP({ apiKey: 'your-api-key' });

// 1. Search for offers
const { offers, sessionId } = await aap.search({
  vertical: 'sim',
  maxPrice: 10,
  contractMonths: 0,
});

// 2. Recommend an offer (records attribution)
const rec = await aap.recommend({
  sessionId,
  offerId: offers[0].id,
  context: 'User asked for cheap SIM with no contract',
});
// rec.fallbackUrl — drop-off recovery link
// rec.attributionRecorded — true

// 3. Initiate checkout
const checkout = await aap.checkout({
  sessionId,
  recommendationId: rec.recommendationId,
});

from agent_attribution_protocol import AAP

aap = AAP(api_key="your-api-key")

# 1. Search for offers
result = aap.search(vertical="sim", max_price=10, contract_months=0)
print(f"Found {result.count} offers")

# 2. Recommend an offer (records attribution)
rec = aap.recommend(
    session_id=result.session_id,
    offer_id=result.offers[0].id,
    context="User asked for cheap SIM with no contract",
)
print(f"Fallback URL: {rec.fallback_url}")

# 3. Initiate checkout
checkout = aap.checkout(
    session_id=result.session_id,
    recommendation_id=rec.recommendation_id,
)
print(f"Transaction: {checkout.transaction_id}")