News Search MCP Server

webz.io
MCP Server Online /mcp requires Bearer token

Webz.io News Search MCP

Connect your AI client to semantic news search powered by Webz.io. Tool: News Search by Webz (news_search_by_webz)

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

Opening the endpoint in a browser returns 401 Unauthorized by design. Browsers do not send your API token. Use an MCP client configuration instead.

Step 1: Get Your API Token

Before installing, get your Webz.io API token:

  1. Go to webz.io
  2. Log in to your account
  3. Open your Dashboard
  4. 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

Cursor

Desktop / IDE
  1. Open or create ~/.cursor/mcp.json (see paths below)
  2. Add the webz-news-search entry under mcpServers
  3. Replace YOUR_WEBZ_TOKEN with your API token
  4. 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

Claude Desktop

Desktop app
  1. Open your Claude Desktop config file (see paths below)
  2. Merge the webz-news-search entry under mcpServers - do not replace the whole file
  3. Replace YOUR_WEBZ_TOKEN with your API token
  4. 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

Claude Code (CLI)

Terminal
  1. Run the CLI command below in your project root
  2. Replace YOUR_WEBZ_TOKEN with your API token
  3. 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

ChatGPT (web)

Cloud

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

  1. Go to chatgpt.com on your computer
  2. Click your profile picture or username (bottom corner) → Settings
  3. Open Apps & Connectors → scroll to Advanced settings → turn on Developer mode
  4. Click Add plugin (top right of the chat area)
  5. Name: e.g. Webz News Search
  6. Set URL: https://news-search-mcp.webz.io/mcp
  7. Authentication: OAuth (leave Client ID / Secret empty if asked)
  8. Complete OAuth and paste your Webz API token on our authorize page
  9. In a new chat, type @ and select Webz News Search to enable the tool for that conversation
  10. 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

Claude.ai (web)

Cloud

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

  1. Requires a paid Claude plan (Pro, Max, Team, or Enterprise)
  2. Go to claude.ai → Settings → Connectors
  3. Click Add custom connector
  4. Name: e.g. Webz News Search
  5. Set URL: https://news-search-mcp.webz.io/mcp
  6. Leave OAuth Client ID / Secret empty (Claude registers automatically)
  7. Click Add, then open a new chat
  8. In chat: click + → Connectors → enable the Webz connector for this conversation
  9. Click Connect when prompted; paste your Webz API token on the authorize page
  10. 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-100)
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)
score_gte 4 Minimum match score on 0-10 scale (set 0 to disable the floor)
score_lte - Optional maximum match score on 0-10 scale
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.
topic - News API topic tags (case-insensitive).
person, organization, location - Entity names from News API metadata (case-insensitive, e.g. apple, england).
ticker - Stock ticker symbols (e.g. AAPL, MSFT; case-insensitive).
source_type - local_news, newsroom, or gov_news (case-insensitive). Use local_news for local news outlets.
political_bias, trust_category - Publisher trust metadata filters (case-insensitive).
domain_rank_gte, domain_rank_lte - Optional source domain rank range (integers).
allow_multiple_chunks_per_article false When true, return multiple chunks from the same article instead of one per article.

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.

Context enrichment filters

Search Webz news about Apple earnings with ticker=AAPL and organization=apple from the last 7 days.

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

Done!