@webz.io/ai-sdk

Search global news with Webz.io from the Vercel AI SDK - in natural language, with the most relevant articles first.

Webz.io News Search covers news and current events from sources worldwide. Ask a question in plain language, narrow results with filters (language, country, date, sentiment, domain, ticker, and more), and get back focused article excerpts with titles, URLs, and metadata.

Use this package with generateText / streamText, or call the hosted MCP tool directly.

What you get

• Natural-language search - no keyword hacking. Example: "EU AI Act enforcement updates" or "How is Tesla stock reacting to earnings?"
• Worldwide coverage - semantic search over Webz.io's global news index.
• Rich filters - language, country, days, sentiment, domain, ticker, person, organization, topic, and more. See the MCP tool reference.
• Live schema - filters are loaded from the hosted MCP server (tools/list). New Webz filters appear automatically, without republishing this package.

Install

npm install @webz.io/ai-sdk
export WEBZ_API_TOKEN="your-webz-api-token"

Get a token from your Webz.io dashboard (same token as the News Search API).

Full setup and client options: MCP Server docs.

With the Vercel AI SDK

import { generateText, isStepCount } from "ai";
import { getWebzTools } from "@webz.io/ai-sdk";

const { tools, close } = await getWebzTools();

try {
  const { text } = await generateText({
    model: "openai/gpt-4.1-mini",
    prompt: "Find recent articles about Nvidia supply-chain risks",
    tools,
    stopWhen: isStepCount(5),
  });
  console.log(text);
} finally {
  await close();
}

Direct search (no LLM)

import { flattenToolResult, webzNewsSearch } from "@webz.io/ai-sdk";

const session = await webzNewsSearch(); // reads WEBZ_API_TOKEN
try {
  const result = await session.client.callTool({
    name: session.toolName,
    arguments: {
      query: "recent developments on EU AI regulation",
      k: 10,
      days: 30,
    },
  });
  console.log(flattenToolResult(result));
} finally {
  await session.close();
}

To see every tool your connection supports:

const { tools, close } = await getWebzTools();
console.log(Object.keys(tools).sort());
await close();

How it works

This package connects to the hosted Webz News Search MCP server at https://news-search-mcp.webz.io/mcp via @ai-sdk/mcp. Each call runs a regular News Search API request with your token (same credits and rate limits). It does not hardcode filter fields - the tool schema comes from the live server.

Configuration

| Name | Default | Purpose | | --- | --- | --- | | WEBZ_API_TOKEN | required | Webz API token from the dashboard | | WEBZ_MCP_URL | https://news-search-mcp.webz.io/mcp | Override for local MCP testing |

You can also pass apiToken and mcpUrl to the helpers.

Links

• Webz.io
• News Search MCP documentation
• MCP server landing page
• GitHub