@iwantfyi/ai-sdk

Vercel AI SDK tools for iwant.fyi — the reference implementation of the iwant.fyi demand-side protocol v1.1. Drop structured purchase-intent and multi-source product-search tools into any AI SDK agent.

npm install @iwantfyi/ai-sdk

zod is a peer dependency (the AI SDK already uses it).

Usage

import { generateText } from "ai";
import { openai } from "@ai-sdk/openai";
import { iwantfyiTools } from "@iwantfyi/ai-sdk";

const result = await generateText({
  model: openai("gpt-4o"),
  prompt: "Find me waterproof running shoes under $120",
  tools: iwantfyiTools({ apiKey: process.env.IWANTFYI_API_KEY! }),
  maxSteps: 5,
});

console.log(result.text);

Get a free API key by registering an agent: POST https://iwant.fyi/api/agents/register (or see /developers).

Tools

| Tool | What it does | |---|---| | demand_search | Find products to buy across multiple sources for a query (no persistence). | | demand_create_want | Create a buyer Want (structured purchase intent) and return matches. | | demand_get_want | Retrieve a Want by id with its current matches. | | demand_record_outcome | Report viewed/clicked/purchased for attribution + match-quality learning. | | demand_list_verticals | Discover supported verticals + spec keys. | | demand_list_constraints | Discover the constraint vocabulary. | | demand_health | Liveness + active supply sources. |

AI SDK version compatibility

Each tool is returned with both inputSchema (AI SDK v5+) and parameters (v4) pointing at the same Zod schema, so the set works across SDK versions. Pass the returned object straight into generateText/streamText tools.

Options

iwantfyiTools(options) accepts the same options as IwantClient from @iwantfyi/sdk:

• apiKey (required) — iwant_ak_...
• baseUrl — defaults to https://iwant.fyi
• transport — "mcp" (default) or "http"
• client — reuse an existing IwantClient (testing / pooling)

License

Apache-2.0. Full protocol spec: iwant.fyi/protocol/v1.