Python integration

pip install kaireonai

from kaireonai import KaireonClient

client = KaireonClient(
    base_url="https://playground.kaireonai.com",  # or set KAIREON_BASE_URL
    api_key="...",                                 # or set KAIREON_API_KEY
    tenant_id="...",                               # or set KAIREON_TENANT_ID
)

# Ask for the next best actions for a customer
rec = client.recommend(customer_id="cust-1", channel="email")

from kaireonai import KaireonClient, KaireonError

client = KaireonClient()  # reads env vars

try:
    rec = client.recommend(customer_id="cust-1", channel="email", limit=3)
    outcome = client.respond(
        recommendation_id=rec["interactionId"],
        customer_id="cust-1",
        rank=1,
        outcome_key="click",
    )
except KaireonError as err:
    print(err.status, err.body)

npm install -g @openapitools/openapi-generator-cli
openapi-generator-cli generate \
  -i https://playground.kaireonai.com/api/openapi.json \
  -g <python|typescript-axios|java|go|...> \
  -o ./generated-client

import json, urllib.request

def mcp_call(method, params=None, base="https://playground.kaireonai.com",
             api_key="...", tenant_id="..."):
    payload = {"jsonrpc": "2.0", "id": 1, "method": method, "params": params or {}}
    req = urllib.request.Request(
        f"{base}/api/v1/mcp",
        data=json.dumps(payload).encode(),
        method="POST",
        headers={
            "Content-Type": "application/json",
            "X-API-Key": api_key,
            "X-Tenant-Id": tenant_id,
        },
    )
    with urllib.request.urlopen(req) as resp:
        return json.load(resp)["result"]

tools = mcp_call("tools/list")["tools"]
print([t["name"] for t in tools])

pip install "git+https://github.com/kaireonai/sdks.git#subdirectory=sdks/python"