How do I use APITube News MCP-Server?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@APITube News MCP-Server Find recent news about artificial intelligence from the last 24 hours in English." That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

APITube News MCP-Server

Official

by apitube

Overview Schema Source Related Servers Discussions Admin

Remote

Overview

The APITube MCP server gives an assistant live access to the world's news as structured data, not scraped HTML. It exposes 2 tools:

search_news — most of the News API filter set in one call: keywords, language, country, source domain and quality rank, sentiment range, named entities, media, date ranges, sorting, faceting and highlighting.
suggest — resolves a name like "Tesla" into the entity, category, topic and industry IDs the precise filters need.

Every article comes back enriched by the pipeline behind it: sentiment scores, extracted entities (people, organizations, locations, brands, events), IPTC categories, topics and industries.

MCP client  →  mcp.apitube.io  →  api.apitube.io
               (this server)      (News API)

JSON-RPC over HTTP, Authorization: Bearer <API_KEY>

Property	Value
Endpoint	`https://mcp.apitube.io/`
Transport	Streamable HTTP (`POST /`), JSON-RPC 2.0
Protocol	`2025-11-25`, negotiated down to your client's version (`2024-11-05` works)
Server	`APITube News MCP-Server` `1.0.0`
Auth	`Authorization: Bearer <API_KEY>`, or `X-API-Key: <API_KEY>`
Registry	`io.apitube/news` (`server.json`)

Related MCP server: news-sentiment-mcp

Quick Start

Get an API key at apitube.io.
Add the server to your client with the block below — each one is also a ready file in configs/.
Restart the client and ask it something like "find positive breaking news about Tesla in English from the last week".

claude mcp add --transport http apitube-news https://mcp.apitube.io/ \
  --header "Authorization: Bearer YOUR_API_KEY"

Check it with /mcp. To commit the server to a project instead, put configs/claude-code.mcp.json at the repo root as .mcp.json.

MCP Servers → Configure, or ~/.cline/mcp.json for the CLI:

{
  "mcpServers": {
    "apitube-news": {
      "type": "streamableHttp",
      "url": "https://mcp.apitube.io/",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" },
      "disabled": false,
      "autoApprove": []
    }
  }
}

type must be set explicitly — without it Cline falls back to the legacy SSE transport, which this server does not serve. Both tools are read-only, so autoApprove: ["search_news", "suggest"] is safe if you would rather not confirm every call.

~/.cursor/mcp.json (global) or .cursor/mcp.json (per project):

{
  "mcpServers": {
    "apitube-news": {
      "url": "https://mcp.apitube.io/",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Settings → MCP should list apitube-news as connected.

Claude Desktop only launches local processes, so bridge the hosted server with mcp-remote. Edit claude_desktop_config.json (~/Library/Application Support/Claude/ on macOS, %APPDATA%\Claude\ on Windows):

{
  "mcpServers": {
    "apitube-news": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.apitube.io/",
        "--header",
        "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}

Restart the app; the tools appear under the slider icon.

.vscode/mcp.json, with the key prompted instead of stored in plain text:

{
  "inputs": [
    { "type": "promptString", "id": "apitube-key", "description": "APITube API Key", "password": true }
  ],
  "servers": {
    "apitube-news": {
      "type": "http",
      "url": "https://mcp.apitube.io/",
      "headers": { "Authorization": "Bearer ${input:apitube-key}" }
    }
  }
}

Open Copilot Chat in Agent mode and enable the apitube-news tools.

~/.codeium/windsurf/mcp_config.json — note serverUrl, not url:

{
  "mcpServers": {
    "apitube-news": {
      "serverUrl": "https://mcp.apitube.io/",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Windsurf Settings → Cascade → MCP Servers → refresh.

Anything that speaks Streamable HTTP takes the URL directly; clients limited to stdio go through mcp-remote, as in the Claude Desktop block. The handshake needs no key:

curl -s -X POST https://mcp.apitube.io/ \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"curl","version":"1.0.0"}},"id":1}'

{
  "jsonrpc": "2.0",
  "result": {
    "protocolVersion": "2024-11-05",
    "serverInfo": { "name": "APITube News MCP-Server", "version": "1.0.0" },
    "capabilities": { "tools": { "listChanged": true }, "prompts": { "listChanged": true } }
  }
}

A real search adds the key:

curl -s -X POST https://mcp.apitube.io/ \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"search_news","arguments":{"title":"Bitcoin","language":{"code":"en"},"per_page":5}},"id":1}'

Tools

Tool	Title	Kind	What it does
`search_news`	News Search	read-only	Searches articles across the News API filter set
`suggest`	Resolve Taxonomy IDs	read-only	Turns a name or prefix into entity / category / topic / industry IDs

`search_news`

Arguments are nested objects, never dotted strings:

{ "language": { "code": "en" } }      // ✅
{ "language.code": "en" }             // ❌ rejected

Three things worth knowing before the first call:

The article body is not returned by default. The default field list is id,title,href,published_at,description,source.domain. Ask for the text explicitly with fl: "title,href,body".
One response carries at most 25 articles. per_page defaults to 10 and is clamped to 25; walk further with page. If a result set still has to be cut — 25 articles of full text can be large — the response gains an _mcp_truncated field saying how many were omitted.
A title search spans at most 31 days. With no dates it covers the last 31 days; a wider explicit range fails with 400 ER0110. Split longer periods into month-sized windows. Searches without a title filter have no range limit.

Misspelled arguments are rejected with JSON-RPC -32602 and a suggestion, instead of being silently ignored:

Unknown parameter 'langauge.code'. Did you mean 'language.code'?

export, query and prompt are deliberately not exposed.

`suggest`

The precise filters take IDs you cannot guess, so resolve them first:

suggest({ type: "entities", prefix: "Tesla" })
// → [{ id: 474, name: "Tesla Robotaxi", type: "brand", … }, …]

search_news({ entity: { id: "474" }, language: { code: "en" } })

type is one of entities, categories, topics, industries; prefix is a name or its beginning. Both are required. Matching is by prefix, so read the names before filtering on the first hit.

Filters

Everything below belongs to search_news. Content, taxonomy, language, author and source filters have an ignore.* twin for exclusion (ignore.title, ignore.entity.id, ignore.source.domain, …); sentiment, media and time filters do not. Multi-value filters take up to 3 comma-separated values. has_* and is_* take 0 or 1, not true/false.

Argument	Example
`title`	`"Bitcoin"` — up to 3 comma-separated keywords, quotes for an exact phrase
`category.id`	`"medtop:04000000"` — IPTC taxonomy
`topic.id`	`"industry.crypto_news"` — slug, from `suggest`
`industry.id`	`"411"` — numeric, from `suggest`
`entity.id`	`"474"` — from `suggest`
`person.name` · `organization.name` · `location.name`	`"Elon Musk"` · `"Tesla,Apple"` · `"Tokyo"`
`brand.name` · `event.name` · `disaster.name` · `disease.name`	`"Nike"` · `"Olympics"` · `"Earthquake"` · `"COVID-19"`
`author.id` · `author.name` · `has_author`	`"123"` · `"Jane Smith"` · `1`
`language.code`	`"en,de,fr"`

Argument	Example
`sentiment.overall.polarity`	`"positive"` \| `"negative"` \| `"neutral"`
`sentiment.overall.score.{min,max}`	`-1.0` … `1.0`
`sentiment.title.score` · `sentiment.body.score`	same range, headline or body only
`sentiment.mixed` · `sentiment.consistent`	`1` — title and body disagree / agree

Argument	Example
`source.domain` · `source.id`	`"cnn.com,bbc.com"` · `"314"`
`source.country.code`	`"us,uk,de"`
`source.bias`	`"left"` \| `"center"` \| `"right"`
`source.rank.opr.{min,max}`	OpenPageRank, 0–7
`is_premium_source` · `is_verified_source`	OPR ≥ 6 · OPR ≥ 5
`is_duplicate` · `is_paywall`	`0` to exclude

Argument	Example
`has_image` · `has_video` · `has_hq_images` · `is_media_rich`	`1`
`media.images.count.{min,max}` · `media.images.{width,height}` · `media.videos.count`	`{ "min": 2 }`
`is_breaking` · `is_long_read` · `is_short_read`	`1` — read time ≥ 5 min / < 3 min
`read_time.{min,max}`	minutes
`published_at.{start,end}`	`"2026-01-01"` … `"2026-01-31"`, ISO 8601

Argument	Example
`sort.by`	`published_at`, `relevance`, `engagement`, `quality`, `controversy`, `trust`, `source.rank.opr`, `sentiment..score`, `media.`, `read_time`, …
`sort.order`	`"asc"` \| `"desc"`
`page` · `per_page`	`1` · `10` (max 25)
`fl`	`"id,title,source.name,sentiment.overall.score"` — dot notation for nested fields
`facet`	`true`, or `{ "field": "source.id,language.id", "limit": 20, "mincount": 5 }`
`facet.range`	`{ "field": "published_at", "start": "2026-01-01", "end": "2026-12-31", "gap": "1MONTH" }`
`hl`	`true`, or `{ "fl": "title,body", "fragsize": 300, "tag": { "pre": "<mark>", "post": "</mark>" } }`

Prompts

Slash commands in clients that support MCP prompts:

Prompt	Arguments	What it does
`monitor_company`	`company` (required), `days`	Recent coverage and sentiment for one company
`topic_sentiment`	`topic` (required), `language`	Sentiment breakdown of coverage on a topic
`breaking_news`	`subject`, `country`	Latest breaking stories, optionally narrowed
`compare_coverage`	`subject_a`, `subject_b` (both required)	Volume and sentiment, two subjects side by side

Use cases

You want to	Ask for	Tools
Watch a brand across languages	mentions of the company with sentiment, last 7 days	`suggest` → `search_news`
Feed a trading or risk model	entity + industry filtered news with sentiment scores	`suggest` → `search_news`
Ground an agent in live news	recent articles with `fl: "title,href,body"` for RAG	`search_news`
Track a running story	`is_breaking: 1`, sorted by `published_at`	`search_news`
Measure share of voice	two subjects compared by volume and sentiment	`compare_coverage`
Study an archive	a date range with no title filter — no 31-day limit	`search_news`

Pricing

The MCP server is part of the paid plans; the free tier covers the REST API only.

Plan	Price	Requests	MCP server
Free	$0	100/day	—
Starter	$29/mo	10,000/mo	✅
Basic	$99/mo	50,000/mo	✅
Professional	$199/mo	150,000/mo	✅

Annual billing takes 20% off. Current numbers always live at apitube.io/pricing.

Page size is capped separately: through MCP one response holds at most 25 articles on every plan, regardless of the larger per_page the REST API allows.

Troubleshooting

Auth and transport failures arrive as JSON-RPC -32000 with an APITube code in the message and the matching HTTP status.

Code	HTTP	Meaning	Fix
`ER0201`	401	No API key reached the server	The header is missing, or the client strips custom headers — use the `mcp-remote` bridge
`ER0202`	401	Key invalid or revoked	Re-copy it from apitube.io
`ER0230`	401	Key expired	Extend the expiry in the key's settings
`ER0601` / `ER0602`	403	IP or referrer not allowed for this key	Adjust the key's restrictions
`ER0603`	403	Key not permitted to call this tool	Grant it access to `search_news` / `suggest`
`ER0429`	429	Over 120 requests/minute	Slow down — the limit is per key
`ER0900`	503	Key validation temporarily unavailable	Retry; the key is fine, do not reissue it

Symptom	Cause
Client reconnects in a loop	It opened a `GET` SSE stream. Expected: the server answers `405 Allow: POST` because it has no event stream, and compliant clients fall back to `POST`
`-32602` with a suggested name	Misspelled argument — arguments are nested objects, never dotted keys
`403` from a Python script	The default `Python-urllib/3.x` user agent is rejected at the edge. Send a real `User-Agent`, or use `requests`
Search returns nothing for an old story	A title search only covers 31 days. Add `published_at` and walk month by month
Articles arrive without text	The body is excluded by default. Add `fl: "title,href,body"`

Documentation

Resource	Link
MCP server reference	https://docs.apitube.io/platform/news-api/ai/mcp-server
Editor setup, one-click install links	https://docs.apitube.io/platform/news-api/ai/code-editors
All News API parameters	https://docs.apitube.io/platform/news-api/everything
Authentication	https://docs.apitube.io/platform/news-api/authentication
Machine-readable server card	https://docs.apitube.io/.well-known/mcp/server-card.json
Agent skill, SDKs, migration kits	https://github.com/apitube
Installing this server as an agent	`llms-install.md`

Registry

Published in the official MCP Registry from server.json in this repository:

mcp-name: io.apitube/news

See more on Claude Market's MCP directory.

Support

Channel	Where
Bugs and corrections	open an issue
Account and billing	support@apitube.io
Everything else	https://apitube.io/contact

Found an argument that behaves differently from what is written here? Open an issue with the request you sent and the response you got — those corrections are the most useful thing you can file.

License

MIT — see LICENSE.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained

ResponsivenessNo issues

Resources

Need Help?

Related Servers

Related MCP Connectors

finlight Financial NewsOAuth
me.finlight
Real-time financial news for AI agents: search by ticker and source, with sentiment and entities.
Finance Search AI & Machine Learning
2
NewzAI News MCP server AOAuth
ai.newzai.api
The only News based AI MCP your agents will ever need — custom categories, global regions, and time-scoped results in one tool. We use multi-vector & sparse-hybrid search to search through thousands of articles across the world to find the exact news you're looking for.
RAG Systems Research & Data Search
102
AllNewsAPI A
io.github.AllNewsAPI
Get access to real-time and historical news data including top headlines from global sources
Research & Data Search Web Scraping
311
newsflash A
sh.newsflash
Real-time corroborated news events + 5-year archive, for agents. Free tier, no key.
Search Open Data
52

Related MCP Servers

Real Time News Data MCP Server
Search Open Data
BACH-AI-Tools
A
license
B
quality
D
maintenance
Enables access to real-time news articles through search, topic headlines, full story coverage, and geo-based local news across multiple countries and languages using the Real Time News Data API.
Updated 9 months ago (2025-12-07 22:19 UTC)
7
MIT
news-sentiment-mcp
Search Research & Data AI & Machine Learning
trendsmcp-ai
A
license
Not graded
quality
C
maintenance
Provides news sentiment scores, media volume trends, and historical coverage data for any topic, enabling AI to analyze positive or negative coverage over time.
Updated 5 months ago (2026-04-03 12:18 UTC)
1
MIT
News Aggregator MCP Server
Search Entertainment & Media
AiAgentKarl
A
license
A
quality
D
maintenance
Enables AI agents to fetch and search news from multiple sources including RSS/Atom feeds, HackerNews, and GDELT global news intelligence without requiring an API key.
Updated 5 months ago (2026-04-03 16:05 UTC)
11
177 PyPI
4
MIT
news-sentiment-mcp
Research & Data Open Data Search
trendsmcp-ai
A
license
A
quality
B
maintenance
Provides news sentiment scores and media volume trends for any topic, enabling AI assistants to analyze whether news coverage is positive or negative.
Updated 18 days ago (2026-08-30 14:51 UTC)
3
1
MIT