Vercel AI SDK tool with Stophy | Stophy

Give any AI SDK model live web search. The model asks for a search, execute calls Stophy, and the model answers from the results.

The search tool

Save this as stophy.ts. When execute calls it, it returns the top 5 web results as JSON.

stophy.ts

export async function stophySearch(query: string): Promise<string> {
  const headers: Record<string, string> = { "Content-Type": "application/json" };
  if (process.env.STOPHY_API_KEY) headers.Authorization = `Bearer ${process.env.STOPHY_API_KEY}`;
  const response = await fetch("https://api.stophy.dev/v1/search", {
    method: "POST",
    headers,
    body: JSON.stringify({ query, limit: 5 }),
  });
  const body = await response.json();
  if (!body.success) throw new Error(body.error);
  return JSON.stringify(body.data.web);
}

Give it to the AI SDK

npm install ai @ai-sdk/openai zod

Set OPENAI_API_KEY in your environment, and STOPHY_API_KEY to go past the free limits. Wrap the search in tool(). stopWhen lets the model search, read the results and answer in up to five steps. Any AI SDK model works, so swap openai(...) for another provider.

import { openai } from "@ai-sdk/openai";
import { generateText, stepCountIs, tool } from "ai";
import { z } from "zod";
import { stophySearch } from "./stophy";

const { text } = await generateText({
  model: openai("gpt-5-mini"),
  prompt: "What changed in the latest Bun release?",
  tools: {
    webSearch: tool({
      description: "Search the web. Returns the top results as JSON.",
      inputSchema: z.object({ query: z.string().describe("What to search for") }),
      execute: async ({ query }) => stophySearch(query),
    }),
  },
  stopWhen: stepCountIs(5),
});

console.log(text);