How do I install APITube News?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does APITube News need an API key?

No required environment variable is listed on this record.

What transport does APITube News use?

APITube News is reached over HTTP.

When was APITube News last checked?

Last checked 2026-11-08. Real-time news search across 500,000+ sources in 60+ languages with sentiment and entities.

APITube News MCP server

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`)

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	[email protected]
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.

APITube News

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install APITube News?

Does APITube News need an API key?

What transport does APITube News use?

When was APITube News last checked?

Documentation

Overview

Quick Start

Tools

`search_news`

`suggest`

Filters

Prompts

Use cases

Pricing

Troubleshooting

Documentation

Registry

Support

License