Vercel AI SDK

npm install ai @ai-sdk/mcp

import { streamText } from "ai";
import { createMCPClient } from "@ai-sdk/mcp";

const mcpClient = await createMCPClient({
  transport: {
    type: "http",
    url: "https://aix.brambles.ai/api/aix/mcp",
    headers: { Authorization: `Bearer ${process.env.AIX_PUBLISHER_KEY}` },
  },
});

const tools = await mcpClient.tools();

const result = await streamText({
  model: yourModel,
  system: AIX_RULES, // see below
  tools,
  messages,
  onEnd: async () => {
    await mcpClient.close();
  },
});

import { tool } from "ai";
import { z } from "zod";

const AIX = "https://aix.brambles.ai/api/aix";

async function aix(path: string, body: unknown) {
  const key = process.env.AIX_PUBLISHER_KEY;
  if (!key) return { status: "skipped", reason: "no_key" };
  try {
    const res = await fetch(`${AIX}/${path}`, {
      method: "POST",
      headers: { authorization: `Bearer ${key}`, "content-type": "application/json" },
      body: JSON.stringify(body),
      signal: AbortSignal.timeout(3000),
    });
    return res.ok ? await res.json() : { status: "skipped", reason: `http_${res.status}` };
  } catch {
    return { status: "skipped", reason: "timeout" }; // never block the shopper
  }
}

const fact = z.object({
  attribute: z.enum(["brand", "width", "size", "department", "use_case", "feature", "merchant", "deal"]),
  value: z.string(),
  strength: z.enum(["required", "preferred", "excluded"]),
});

export const aixTools = {
  submit_intent: tool({
    description:
      "Report the shopper's current shopping task to AIX. Call after any turn that states or changes what they want to buy. Shopping requirements only, never personal data.",
    inputSchema: z.object({
      intent: z.object({
        session_id: z.string().min(1).max(128),
        country: z.string().length(2),
        task: z.object({
          category: z.string(),
          summary: z.string().max(1600),
          budget: z.object({ currency: z.string().length(3), max_cents: z.number().int() }).optional(),
          facts: z.array(fact),
        }),
      }),
    }),
    execute: ({ intent }) => aix("intents", intent),
  }),
  report_handoff: tool({
    description:
      "Report that the shopper is being sent to a store or product page (the store's own URL). Returns landing_url, the store URL with AIX's id appended; use it as that page's URL, inside your affiliate link if you use one.",
    inputSchema: z.object({
      session_id: z.string(),
      destination_url: z.string().url(),
      consent: z.enum(["granted", "denied"]).optional(),
    }),
    execute: (input) => aix("handoffs", input),
  }),
};

You can send shopping intent to the Agentic Intent Exchange (AIX).
- After any user turn that states or changes what they want to buy, call submit_intent with one
  argument, intent: an object holding the conversation's session_id, the shopper's two-letter
  country, and the task: a category, a one-line summary, the budget when they gave one, and facts
  with attribute, value and strength (required, preferred or excluded). Send only shopping
  requirements: never names, emails, phone numbers, addresses, account or order numbers, or the
  conversation itself.
- Before you give the user a link to a store or product page, call report_handoff with the same
  session_id and the store's page URL, then use the returned landing_url as that page's URL (inside
  your own affiliate or ad link, if you use one).
- If either tool fails or is slow, carry on without it. Never ask the user for a key.