Webz.io logoDocs
Overview
Start Here
News, Blogs, Forums & Reviews APIs
News Search API
Introduction
Quickstart
Filters
Response Format
API Reference
MCP Server
Agent Skill
Firehose
Cyber API
Data Breaches API
News, Blogs, Forums & Reviews Archive
Web Content API (Deprecated)
Webz.io logo
Overview
Start Here
News, Blogs, Forums & Reviews APIs
News Search API
Introduction
Quickstart
Filters
Response Format
API Reference
MCP Server
Agent Skill
Firehose
Cyber API
Data Breaches API
News, Blogs, Forums & Reviews Archive
Web Content API (Deprecated)

On this page

No sections

Webz.io DocumentationContact our team© 2026

MCP Server

Connect your AI client - Cursor, Claude, or ChatGPT - to Webz.io News Search. The client gets a news_search_by_webz tool and can search global news by itself.

https://news-search-mcp.webz.io/mcp

Every tool call runs a regular News Search request with your token - the same credits and rate limits apply. See Errors, Rate Limits & Credits.

Step 1: Get your API token

Log in at webz.io and copy the API token from your dashboard. It is the same token you use for the News Search API.

Step 2: Connect your client

Replace YOUR_WEBZ_TOKEN with your token.

Cursor

Add this to ~/.cursor/mcp.json (%USERPROFILE%\.cursor\mcp.json on Windows) and restart Cursor:

json
{
  "mcpServers": {
    "webz-news-search": {
      "url": "https://news-search-mcp.webz.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_WEBZ_TOKEN"
      }
    }
  }
}

Claude Desktop

Merge the same webz-news-search entry into your Claude Desktop config file - do not replace the whole file - then restart Claude Desktop:

OSConfig file
macOS~/Library/Application Support/Claude/claude_desktop_config.json
Linux~/.config/Claude/claude_desktop_config.json
Windows%APPDATA%\Claude\claude_desktop_config.json

Claude Code

Run in your project root:

claude mcp add --transport http webz-news-search https://news-search-mcp.webz.io/mcp --header "Authorization: Bearer YOUR_WEBZ_TOKEN"

Claude.ai and ChatGPT (web)

Add https://news-search-mcp.webz.io/mcp as a custom connector (Claude.ai: Settings > Connectors; ChatGPT: Settings > Apps & Connectors with Developer mode on). Both use OAuth: leave Client ID and Secret empty, then paste your Webz token on the authorize page. Full step-by-step walkthroughs: news-search-mcp.webz.io.

Opening the /mcp endpoint in a browser returns 401 Unauthorized by design - browsers do not send your token. Use an MCP client.

Step 3: Try it

Ask your AI client naturally - mentioning "news" or "Webz" helps it pick the tool:

  • "Search Webz news for recent developments on EU AI regulation and summarize with sources."
  • "Use the Webz news tool to find coverage of trade agreements between Israel and Greece from the past week."
  • "Call news_search_by_webz for 'renewable energy investments' with k=10 and days=30, then summarize."

Tool reference

news_search_by_webz

ParameterDefaultDescription
queryrequiredNatural-language topic or question
k10Articles to return (1-50)
days7How many days back to search
allow_all_datesfalseSearch the full coverage window instead of days
language, country, sentiment, category-Same values as Filters; country codes are ISO-2 uppercase (US, GB)

Each result returns the article title, URL, publish date, and the matching text excerpt.

Keep your token safe

Never commit your token to git or put it in a URL.

Set it once as an environment variable and reference it from the config:

json
"Authorization": "Bearer ${env:WEBZ_API_TOKEN}"

Next steps

  • Add the Agent Skill so your agent knows when and how to search
  • Review Filters for all filter values
Last updated: August 19, 2026
PreviousErrors, Rate Limits & CreditsNextAgent Skill