News MCP - Webz.io | Webz.io Docs

Search news articles from the open web. This server exposes one tool: search_webz_news.

MCP endpoint

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

How it works

You describe what you need in plain language. The assistant turns that into a Webz q query and calls GET /api/news with your token.

Each result includes metadata plus an Excerpt: a short clip (up to about 600 characters) from the post body (text), or from summary / highlightText when present. It is not the full article.

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": {
      "url": "https://news-mcp.webz.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_WEBZ_TOKEN"
      }
    }
  }
}

Token needs news (api_news) access. OAuth: https://news-mcp.webz.io/.

Claude Desktop

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

OS	Config 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 https://news-mcp.webz.io/mcp --header "Authorization: Bearer YOUR_WEBZ_TOKEN"

n8n

Add an MCP Client Tool node and connect it to an AI Agent node's Tool input:

Field	Value
Endpoint	`https://news-mcp.webz.io/mcp`
Server Transport	`HTTP Streamable`
Authentication	`Bearer Auth`
Tools to Include	`All`

Create a Bearer Auth credential and paste your Webz.io API token as the bearer token. The agent receives a search_webz_news tool.

Claude.ai and ChatGPT (web)

Add https://news-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. Setup instructions for every client are at news-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.

End-to-end example

1. What you ask

Search recent English UK news about Ronaldo and the Champions League.

2. What the assistant calls

Tool: search_webz_news

Argument	Value
`days`	`1`
`q`	`Ronaldo (AFC OR Asian OR "Champions League") language:english country:GB`
`size`	`10`
`sort`	`published`

The assistant may retry once with a broader q if the first call returns zero posts (that is success, not an error).

3. What the MCP tool returns

Plain text the model reads (truncated here after two results):

text

Query: Ronaldo (AFC OR Asian OR "Champions League") language:english country:GB
Total results: 22
More results available: 12
Requests left: 783

--- Result 1 ---
Title: Cristiano Ronaldo Is Just 19 Goals Away From '1,000' Milestone While Portugal Chief Teases November Return
URL: https://www.ibtimes.co.uk/ronaldo-981-goals-portugal-return-speculation-1825224
Published: 2026-10-13T09:14:00.000+03:00
Site: ibtimes.co.uk
Site type: news
Language: english
Sentiment: positive
Excerpt: Meanwhile, Portuguese Football Federation (FPF) president Pedro Proença expressed optimism about Ronaldo's return despite an unresolved disciplinary dispute involving Portugal manager Jorge Jesus. The Portuguese forward converted after Sadio Mané delivered a cross that Ayman Yahya controlled and redirected into his path. The strike marked Ronaldo's 981st senior career goal, leaving him just 19 away from the unprecedented milestone he has repeatedly expressed ambitions of reaching...

--- Result 2 ---
Title: Manchester United thought they had found a star on their last visit to Atletico Madrid
URL: https://uk.sports.yahoo.com/news/manchester-united-thought-had-found-050000042.html
Published: 2026-10-13T08:00:00.000+03:00
Site: yahoo.com
Site type: news
Language: english
Sentiment: neutral
Excerpt: United were fortunate to nick a draw in Madrid that night, but it was a coming-of-age moment for Elanga, who demonstrated his mettle by bouncing back from a penalty miss earlier that month...

(... more results in the same format ...)

4. What you see from the assistant

A short summary in your language, with links, for example:

In the last day of UK English coverage, Ronaldo stories focus on his 981st career goal and a possible Portugal return (IBTimes). Related pieces tie Champions League context to Manchester United and Atletico (Yahoo Sports UK). Several articles also cover Asian Cup security concerns in Saudi Arabia rather than Ronaldo directly. Webz reported 22 matching articles; the tool showed the first 10 by publish date.

Tool parameters (simple view)

Parameter	You usually say…	What the tool does
`q`	topic, outlet, language, country	full search query (required)
`days`	"yesterday", "past week"	crawl lookback
`size`	"give me 20"	how many posts (default 10)
`sort`	"newest first"	e.g. `published` or `crawled`

Wait at least 1 second between searches on this server; the Webz API allows about one request per second per endpoint on your token.

More detail

Search news articles from the open web. This server exposes one tool: search_webz_news.

MCP endpoint

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

How it works

You describe what you need in plain language. The assistant turns that into a Webz q query and calls GET /api/news with your token.

Each result includes metadata plus an Excerpt: a short clip (up to about 600 characters) from the post body (text), or from summary / highlightText when present. It is not the full article.

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": {
      "url": "https://news-mcp.webz.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_WEBZ_TOKEN"
      }
    }
  }
}

Token needs news (api_news) access. OAuth: https://news-mcp.webz.io/.

Claude Desktop

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

OS	Config 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 https://news-mcp.webz.io/mcp --header "Authorization: Bearer YOUR_WEBZ_TOKEN"

n8n

Add an MCP Client Tool node and connect it to an AI Agent node's Tool input:

Field	Value
Endpoint	`https://news-mcp.webz.io/mcp`
Server Transport	`HTTP Streamable`
Authentication	`Bearer Auth`
Tools to Include	`All`

Create a Bearer Auth credential and paste your Webz.io API token as the bearer token. The agent receives a search_webz_news tool.

Claude.ai and ChatGPT (web)

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

End-to-end example

1. What you ask

Search recent English UK news about Ronaldo and the Champions League.

2. What the assistant calls

Tool: search_webz_news

Argument	Value
`days`	`1`
`q`	`Ronaldo (AFC OR Asian OR "Champions League") language:english country:GB`
`size`	`10`
`sort`	`published`

The assistant may retry once with a broader q if the first call returns zero posts (that is success, not an error).

3. What the MCP tool returns

Plain text the model reads (truncated here after two results):

text

Query: Ronaldo (AFC OR Asian OR "Champions League") language:english country:GB
Total results: 22
More results available: 12
Requests left: 783

--- Result 1 ---
Title: Cristiano Ronaldo Is Just 19 Goals Away From '1,000' Milestone While Portugal Chief Teases November Return
URL: https://www.ibtimes.co.uk/ronaldo-981-goals-portugal-return-speculation-1825224
Published: 2026-10-13T09:14:00.000+03:00
Site: ibtimes.co.uk
Site type: news
Language: english
Sentiment: positive
Excerpt: Meanwhile, Portuguese Football Federation (FPF) president Pedro Proença expressed optimism about Ronaldo's return despite an unresolved disciplinary dispute involving Portugal manager Jorge Jesus. The Portuguese forward converted after Sadio Mané delivered a cross that Ayman Yahya controlled and redirected into his path. The strike marked Ronaldo's 981st senior career goal, leaving him just 19 away from the unprecedented milestone he has repeatedly expressed ambitions of reaching...

--- Result 2 ---
Title: Manchester United thought they had found a star on their last visit to Atletico Madrid
URL: https://uk.sports.yahoo.com/news/manchester-united-thought-had-found-050000042.html
Published: 2026-10-13T08:00:00.000+03:00
Site: yahoo.com
Site type: news
Language: english
Sentiment: neutral
Excerpt: United were fortunate to nick a draw in Madrid that night, but it was a coming-of-age moment for Elanga, who demonstrated his mettle by bouncing back from a penalty miss earlier that month...

(... more results in the same format ...)

4. What you see from the assistant

A short summary in your language, with links, for example:

In the last day of UK English coverage, Ronaldo stories focus on his 981st career goal and a possible Portugal return (IBTimes). Related pieces tie Champions League context to Manchester United and Atletico (Yahoo Sports UK). Several articles also cover Asian Cup security concerns in Saudi Arabia rather than Ronaldo directly. Webz reported 22 matching articles; the tool showed the first 10 by publish date.

Tool parameters (simple view)

Parameter	You usually say…	What the tool does
`q`	topic, outlet, language, country	full search query (required)
`days`	"yesterday", "past week"	crawl lookback
`size`	"give me 20"	how many posts (default 10)
`sort`	"newest first"	e.g. `published` or `crawled`

Wait at least 1 second between searches on this server; the Webz API allows about one request per second per endpoint on your token.