Webz.io News Search MCP

Step 1: Get Your API Token

Before installing, get your Webz.io API token:

Go to webz.io
Log in to your account
Open your Dashboard
Copy your API Token

Important: Keep your token secure. Never share it publicly or commit it to git.

Step 2: Connect your AI client

Choose your client below. Replace YOUR_WEBZ_TOKEN with your API token from Step 1.

Cursor

Desktop / IDE

Open or create ~/.cursor/mcp.json (see paths below)
Add the webz-news-search entry under mcpServers
Replace YOUR_WEBZ_TOKEN with your API token
Restart Cursor

Save config file to:

macOS ~/.cursor/mcp.json
Linux ~/.cursor/mcp.json
Windows %USERPROFILE%\.cursor\mcp.json

MCP config JSON

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

Claude Desktop

Desktop app

Open your Claude Desktop config file (see paths below)
Merge the webz-news-search entry under mcpServers - do not replace the whole file
Replace YOUR_WEBZ_TOKEN with your API token
Restart Claude Desktop

Save config file to:

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

MCP config JSON

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

Important: Merge into your existing config. Do not replace the whole file.

Claude Code (CLI)

Terminal

Run the CLI command below in your project root
Replace YOUR_WEBZ_TOKEN with your API token
Or copy the JSON below into .mcp.json in your project root

CLI command

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

Save config file to:

macOS /.mcp.json
Linux /.mcp.json
Windows \.mcp.json

MCP config JSON

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

Web clients

ChatGPT (web)

Cloud

ChatGPT uses Plugins (not Connectors). Requires a paid plan and Developer Mode.

Go to chatgpt.com on your computer
Click your profile picture or username (bottom corner) → Settings
Open Apps & Connectors → scroll to Advanced settings → turn on Developer mode
Click Add plugin (top right of the chat area)
Name: e.g. Webz News Search
Set URL: https://news-search-mcp.webz.io/mcp
Authentication: OAuth (leave Client ID / Secret empty if asked)
Complete OAuth and paste your Webz API token on our authorize page
In a new chat, type @ and select Webz News Search to enable the tool for that conversation
Ask it to search world news (mention news or news_search_by_webz)

Developer Mode is mandatory for custom MCP plugins on personal ChatGPT accounts. Paid plan required: Plus, Pro, Business, Enterprise, or Edu.

Claude.ai (web)

Cloud

Add a custom connector in Claude.ai settings. Requires a paid plan.

Requires a paid Claude plan (Pro, Max, Team, or Enterprise)
Go to claude.ai → Settings → Connectors
Click Add custom connector
Name: e.g. Webz News Search
Set URL: https://news-search-mcp.webz.io/mcp
Leave OAuth Client ID / Secret empty (Claude registers automatically)
Click Add, then open a new chat
In chat: click + → Connectors → enable the Webz connector for this conversation
Click Connect when prompted; paste your Webz API token on the authorize page
Ask it to search world news (mention news or news_search_by_webz)

Tool reference

The MCP exposes one search tool: news_search_by_webz. Ask in natural language in chat, or pass these parameters on an explicit tool call.

Parameter	Default	Description
`query`	required	Natural-language topic or question
`k`	10	Articles to return (1-50)
`days`	7	How many days back to search when `allow_all_dates` is false
`allow_all_dates`	false	Search the full indexed coverage window instead of `days`
`trust_gte`	-	Minimum source trust (0.0-1.0)
`sort_by`	best_score	`best_score`, `similarity`, `date_desc`, `date_asc`
`language`, `country`, `sentiment`, `category`	-	Optional filters. Country codes are ISO-2 uppercase (US, GB). Sentiment: positive, negative, neutral.
`domain`	-	Include only these source domains (e.g. `cnn.com`, `yahoo.com`).
`exclude_domain`	-	Exclude these source domains (e.g. `spam.net`). Do not repeat any domain from `domain`.

Category values

Use one category per search. Matching is case-insensitive.

Example prompts (after MCP is connected)

Ask naturally in chat. Mentioning Webz, news, or search helps the AI call news_search_by_webz.

Default search window: last 7 days. Ask for a wider range in chat (e.g. last 2 weeks) or pass days=N on an explicit tool call. Use allow_all_dates=true for the full indexed coverage window.

Current events (default window)

Search Webz news for recent developments on the Iran nuclear deal from the last 7 days and summarize with sources.

Trade / business

Use the Webz search tool to find news about trade agreements between Israel and Greece from the past week.

Wider time range

Search Webz for EU AI regulation coverage over the last month and summarize the main themes.

Full coverage window

Call news_search_by_webz for "EU AI regulation" with k=10 and allow_all_dates=true, then summarize the top findings.

Tip: If the model does not call the tool, add phrases like search Webz, use the news tool, or from the last 7 days. Use allow_all_dates=true when you need the widest available coverage.

Recommended: environment variable token

Set the token once in your shell profile:

export WEBZ_API_TOKEN="your-webz-api-token"

Then use this MCP config (Cursor / Claude):

{
  "mcpServers": {
    "webz-news-search": {
      "url": "https://news-search-mcp.webz.io/mcp",
      "headers": {
        "Authorization": "Bearer ${env:WEBZ_API_TOKEN}"
      }
    }
  }
}

Why env vars? Keeps secrets out of git and config files. Cursor replaces ${env:WEBZ_API_TOKEN} at runtime.

Security notes

Never put your token in the URL query string
Each customer uses their own Webz API token
Token validation happens on the Webz news search API
Get your token from your webz.io Dashboard