APITube News

Official2 tools

by apitube

Real-time news search across 500,000+ sources in 60+ languages with sentiment and entities.

APITube News MCP (io.apitube/news)

The io.apitube/news MCP server provides real-time and archived news search over the Model Context Protocol. It supports searching across 500,000+ sources in 60+ languages and includes sentiment and entity information. It is hosted at https://mcp.apitube.io/ with no package to install and no local process required.

🛠️ Key Features

Real-time news search
Archived news search
Coverage: 500,000+ sources
Coverage: 60+ languages
Sentiment and entities

🚀 Use Cases

Supplying AI agents with current and historical news content
Enabling language-agnostic news lookup (60+ languages)
Extracting sentiment and entity data alongside news results

⚡ Developer Benefits

MCP access for tools and agents
Hosted service: no local setup or process to keep running
Integrates sentiment and entity signals into retrieved news

Topics

ai-agentsclaude-codecodexcursorllm-toolsmcpmcp-servermodel-context-protocolnewsnews-apisentiment-analysis

Captured live from the server via tools/list.

search_news

Search news articles using APITube News API with comprehensive filtering. IMPORTANT INSTRUCTIONS FOR QUERY CONSTRUCTION: 1. DO NOT use dots in parameter names directly in the root object. Use nested objects instead. 2. The system will automatically convert nested objects to dot notation for the API. Example: Use { language: { code: "en" } } instead of { "language.code": "en" }. 3. For multiple values in one parameter, use COMMA separation (e.g., "en,ru,fr" for multiple languages). 4. Integer filters (has_*, is_*) accept ONLY 0 or 1 (e.g., has_image=1, is_duplicate=0). 5. Date format: ISO 8601 (YYYY-MM-DD or YYYY-MM-DDTHH:MM:SSZ). 6. Sentiment scores range: -1.0 (negative) to 1.0 (positive). 7. Default sorting: published_at DESC (newest first). 8. Unknown parameters are rejected with an error (-32602) instead of being silently ignored — check the spelling against the list below. 9. By default the response returns id, title, href, published_at, description and source.domain. The article body is NOT included — request it explicitly with fl (e.g. fl: "title,href,body"). AVAILABLE PARAMETERS: ### Content Search - title: Search by article title (supports up to 3 keywords with comma separation) IMPORTANT: a title search covers at most a 31-day published_at window. Omit the dates and the last 31 days are searched; pass a range wider than 31 days and the call fails with 400 ER0110. To cover a longer period, make one call per month-sized window. - ignore: { title: "keyword" } - Exclude articles with specific titles ### Languages (60+ supported) - language: { code: "en,ru,fr" } - Filter by language codes (up to 3) - ignore: { language: { code: "fr" } } - Exclude specific languages ### Categories (IPTC taxonomy) - category: { id: "medtop:04000000" } - Filter by category ID (up to 3) - ignore: { category: { id: "315" } } - Exclude categories ### Topics - topic: { id: "crypto_news,climate_change" } - Filter by topic ID (up to 3) - ignore: { topic: { id: "2" } } - Exclude topics ### Industries - industry: { id: "246771,246772" } - Filter by industry ID (up to 3) - ignore: { industry: { id: "246772" } } - Exclude industries ### Entities - entity: { id: "1278268,1282301" } - Filter by entity ID (up to 3) - ignore: { entity: { id: "315" } } - Exclude entities ### Persons - person: { name: "Elon Musk,Tim Cook" } - Filter by person name (up to 3) - ignore: { person: { name: "John Doe" } } - Exclude persons ### Locations - location: { name: "Tokyo,New York" } - Filter by location (up to 3) - ignore: { location: { name: "Paris" } } - Exclude locations ### Organizations - organization: { name: "Tesla,Apple,Google" } - Filter by organization (up to 3) - ignore: { organization: { name: "Microsoft" } } - Exclude organizations ### Disasters - disaster: { name: "Earthquake,Tsunami" } - Filter by disaster type (up to 3) - ignore: { disaster: { name: "Flood" } } - Exclude disasters ### Diseases - disease: { name: "COVID-19,Influenza" } - Filter by disease (up to 3) - ignore: { disease: { name: "Flu" } } - Exclude diseases ### Events - event: { name: "Olympics,World Cup" } - Filter by event (up to 3) - ignore: { event: { name: "Super Bowl" } } - Exclude events ### Brands - brand: { name: "Nike,Adidas" } - Filter by brand (up to 3) - ignore: { brand: { name: "Puma" } } - Exclude brands ### Authors - author: { id: "123,456" } - Filter by author ID (up to 3) - author: { name: "John Doe,Jane Smith" } - Filter by author name (up to 3) - ignore: { author: { id: "789" } } - Exclude author IDs - ignore: { author: { name: "Bob Jones" } } - Exclude author names - has_author: 1 - Articles with attributed authors (0 for without) ### Sentiment Analysis - sentiment: { overall: { score: { min: 0.5, max: 1.0 } } } - Sentiment score range - sentiment: { overall: { polarity: "positive" | "negative" | "neutral" } } - Sentiment polarity - sentiment: { title: { score: { min: -1.0, max: 1.0 } } } - Title sentiment - sentiment: { body: { score: { min: -1.0, max: 1.0 } } } - Body sentiment - sentiment: { mixed: 1 } - Articles with mixed sentim

Parameters38

title	string	optional	Search by article title. Up to 3 keywords comma-separated (OR). Phrase in quotes for exact match.
ignore	object	optional	Exclusion filters — exclude articles matching these. Mirror the positive filters.
language	object	optional	Language filter.
category	object	optional	IPTC category filter.
topic	object	optional
industry	object	optional
entity	object	optional	Named-entity filter.
person	object	optional
organization	object	optional
location	object	optional
disaster	object	optional
disease	object	optional
event	object	optional
brand	object	optional
source	object	optional	Source filter.
author	object	optional
sentiment	object	optional	Sentiment filter. Scores range -1.0..1.0.
media	object	optional	Media-content filter.
published_at	object	optional	Publication date range (ISO 8601).
sort	object	optional
read_time	object	optional	Reading time in minutes.
facet	boolean \| object	optional	Enable faceting (true) or object form for analytics.
hl	boolean \| object	optional	Enable highlighting (true) or object form.
has_image	integer	optional	Articles with at least one image.
has_video	integer	optional	Articles with at least one video.
has_hq_images	integer	optional	High-quality images (width >= 1200px).
is_media_rich	integer	optional	Both images and videos.
has_author	integer	optional	Has an attributed author.
is_breaking	integer	optional	Breaking news only.
is_duplicate	integer	optional	0 to exclude duplicates.
is_paywall	integer	optional	0 to exclude paywalled content.
is_long_read	integer	optional	Read time >= 5 minutes.
is_short_read	integer	optional	Read time < 3 minutes.
is_premium_source	integer	optional	Premium sources (OPR >= 6).
is_verified_source	integer	optional	Verified sources (OPR >= 5).
page	integer	optional	Page number (default 1).
per_page	integer	optional	Results per page (default 10). One response carries at most 25 articles.
fl	string	optional	Comma-separated fields to return (dot-notation supported), e.g. "id,title,source.name,sentiment.overall.score".

Raw schema

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "description": "Search by article title. Up to 3 keywords comma-separated (OR). Phrase in quotes for exact match."
    },
    "ignore": {
      "type": "object",
      "description": "Exclusion filters — exclude articles matching these. Mirror the positive filters.",
      "properties": {
        "title": {
          "type": "string",
          "description": "Exclude titles with these keyword(s), comma-separated."
        },
        "language": {
          "type": "object",
          "properties": {
            "code": {
              "type": "string"
            }
          }
        },
        "category": {
          "type": "object",
          "properties": {
            "id": {
              "type": "string"
            }
          }
        },
        "topic": {
          "type": "object",
          "properties": {
            "id": {
              "type": "string"
            }
          }
        },
        "industry": {
          "type": "object",
          "properties": {
            "id": {
              "type": "string"
            }
          }
        },
        "entity": {
          "type": "object",
          "properties": {
            "id": {
              "type": "string"
            }
          }
        },
        "person": {
          "type": "object",
          "properties": {
            "name": {
              "type": "string"
            }
          }
        },
        "location": {
          "type": "object",
          "properties": {
            "name": {
              "type": "string"
            }
          }
        },
        "organization": {
          "type": "object",
          "properties": {
            "name": {
              "type": "string"
            }
          }
        },
        "disaster": {
          "type": "object",
          "properties": {
            "name": {
              "type": "string"
            }
          }
        },
        "disease": {
          "type": "object",
          "properties": {
            "name": {
              "type": "string"
            }
          }
        },
        "event": {
          "type": "object",
          "properties": {
            "type": {
              "type": "string",
              "description": "Exclude these event codes (max 5)."
            },
            "name": {
              "type": "string",
              "description": "Exclude these named events (up to 3)."
            }
          }
        },
        "brand": {
          "type": "object",
          "properties": {
            "name": {
              "type": "string"
            }
          }
        },
        "author": {
          "type": "object",
          "properties": {
            "id": {
              "type": "string"
            },
            "name": {
              "type": "string"
            }
          }
        },
        "source": {
          "type": "object",
          "properties": {
            "id": {
              "type": "string"
            },
            "domain": {
              "type": "string"
            },
            "country": {
              "type": "object",
              "properties": {
                "code": {
                  "type": "string"
                }
              }
            },
            "bias": {
              "type": "string"
            }
          }
        }
      }
    },
    "language": {
      "type": "object",
      "description": "Language filter.",
      "properties": {
        "code": {
          "type": "string",
          "description": "ISO codes, comma-separated up to 3 (e.g. \"en,ru,fr\")."
        }
      }
    },
    "category": {
      "type": "object",
      "description": "IPTC category filter.",
      "properties": {
        "id": {
          "type": "string",
          "description": "Category id, e.g. \"medtop:04000000\". Comma-separated up to 3."
        }
      }
    },
    "topic": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "Topic id(s), comma-separated up to 3."
        }
      }
    },
    "industry": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "Industry id(s), comma-separated up to 3."
        }
      }
    },
    "entity": {
      "type": "object",
      "description": "Named-entity filter.",
      "properties": {
        "id": {
          "type": "string",
          "description": "Numeric entity id(s), comma-separated up to 3."
        }
      }
    },
    "person": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "Person name(s), comma-separated up to 3."
        }
      }
    },
    "organization": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "Organization name(s), comma-separated up to 3."
        }
      }
    },
    "location": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "Location name(s), comma-separated up to 3."
        }
      }
    },
    "disaster": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "Disaster name(s), comma-separated up to 3."
        }
      }
    },
    "disease": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "Disease name(s), comma-separated up to 3."
        }
      }
    },
    "event": {
      "type": "object",
      "properties": {
        "type": {
          "type": "string",
          "description": "Event codes, comma-separated (max 5) — see /v1/news/event-types, e.g. layoffs, ipo, recall, wildfire."
        },
        "category": {
          "type": "string",
          "enum": [
            "business",
            "society",
            "environment"
          ],
          "description": "Event family."
        },
        "name": {
          "type": "string",
          "description": "Named event entity, comma-separated up to 3. The directory is nearly empty — prefer type/category; an unknown name returns 400 ER0228."
        }
      }
    },
    "brand": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "Brand name(s), comma-separated up to 3."
        }
      }
    },
    "source": {
      "type": "object",
      "description": "Source filter.",
      "properties": {
        "id": {
          "type": "string",
          "description": "Source id(s), comma-separated up to 3."
        },
        "domain": {
          "type": "string",
          "description": "Domain(s), e.g. \"cnn.com,bbc.com\"."
        },
        "country": {
          "type": "object",
          "properties": {
            "code": {
              "type": "string",
              "description": "Country code(s), e.g. \"us,uk,de\"."
            }
          }
        },
        "bias": {
          "type": "string",
          "enum": [
            "left",
            "center",
            "right"
          ],
          "description": "Media bias (comma-separated for multiple)."
        },
        "rank": {
          "type": "object",
          "properties": {
            "opr": {
              "type": "object",
              "description": "OpenPageRank range (0-7).",
              "properties": {
                "min": {
                  "type": "number"
                },
                "max": {
                  "type": "number"
                }
              }
            }
          }
        }
      }
    },
    "author": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "Author id(s), comma-separated up to 3."
        },
        "name": {
          "type": "string",
          "description": "Author name(s), comma-separated up to 3."
        }
      }
    },
    "sentiment": {
      "type": "object",
      "description": "Sentiment filter. Scores range -1.0..1.0.",
      "properties": {
        "overall": {
          "type": "object",
          "properties": {
            "polarity": {
              "type": "string",
              "enum": [
                "positive",
                "negative",
                "neutral"
              ],
              "description": "Overall sentiment polarity."
            },
            "score": {
              "type": "object",
              "properties": {
                "min": {
                  "type": "number"
                },
                "max": {
                  "type": "number"
                }
              }
            }
          }
        },
        "title": {
          "type": "object",
          "properties": {
            "score": {
              "type": "object",
              "properties": {
                "min": {
                  "type": "number"
                },
                "max": {
                  "type": "number"
                }
              }
            }
          }
        },
        "body": {
          "type": "object",
          "properties": {
            "score": {
              "type": "object",
              "properties": {
                "min": {
                  "type": "number"
                },
                "max": {
                  "type": "number"
                }
              }
            }
          }
        },
        "mixed": {
          "type": "integer",
          "enum": [
            0,
            1
          ],
          "description": "Title/body sentiment differ."
        },
        "consistent": {
          "type": "integer",
          "enum": [
            0,
            1
          ],
          "description": "Title/body sentiment agree."
        }
      }
    },
    "media": {
      "type": "object",
      "description": "Media-content filter.",
      "properties": {
        "images": {
          "type": "object",
          "properties": {
            "count": {
              "type": "object",
              "properties": {
                "min": {
                  "type": "integer"
                },
                "max": {
                  "type": "integer"
                }
              }
            },
            "width": {
              "type": "object",
              "properties": {
                "min": {
                  "type": "integer"
                },
                "max": {
                  "type": "integer"
                }
              }
            },
            "height": {
              "type": "object",
              "properties": {
                "min": {
                  "type": "integer"
                },
                "max": {
                  "type": "integer"
                }
              }
            }
          }
        },
        "videos": {
          "type": "object",
          "properties": {
            "count": {
              "type": "object",
              "properties": {
                "min": {
                  "type": "integer"
                },
                "max": {
                  "type": "integer"
                }
              }
            }
          }
        }
      }
    },
    "published_at": {
      "type": "object",
      "description": "Publication date range (ISO 8601).",
      "properties": {
        "start": {
          "type": "string",
          "description": "YYYY-MM-DD or RFC3339."
        },
        "end": {
          "type": "string",
          "description": "YYYY-MM-DD or RFC3339."
        }
      }
    },
    "sort": {
      "type": "object",
      "properties": {
        "by": {
          "type": "string",
          "enum": [
            "published_at",
            "created_at",
            "id",
            "source.rank.opr",
            "read_time",
            "sentiment.overall.score",
            "sentiment.title.score",
            "sentiment.body.score",
            "media.images.count",
            "media.videos.count",
            "media.images.width.min",
            "media.images.width.max",
            "media.images.height.min",
            "media.images.height.max",
            "media_richness",
            "shares.facebook.min",
            "shares.facebook.max",
            "shares.twitter.min",
            "shares.twitter.max",
            "shares.reddit.min",
            "shares.reddit.max",
            "relevance",
            "engagement",
            "quality",
            "controversy",
            "trust"
          ],
          "description": "Field to sort by."
        },
        "order": {
          "type": "string",
          "enum": [
            "asc",
            "desc"
          ],
          "description": "Sort direction."
        }
      }
    },
    "read_time": {
      "type": "object",
      "description": "Reading time in minutes.",
      "properties": {
        "min": {
          "type": "integer"
        },
        "max": {
          "type": "integer"
        }
      }
    },
    "facet": {
      "type": [
        "boolean",
        "object"
      ],
      "description": "Enable faceting (true) or object form for analytics.",
      "properties": {
        "field": {
          "type": "string",
          "description": "Facet field(s), comma-separated."
        },
        "limit": {
          "type": "integer"
        },
        "mincount": {
          "type": "integer"
        },
        "range": {
          "type": "object",
          "description": "Range faceting → facet.range.* params.",
          "properties": {
            "field": {
              "type": "string",
              "description": "Numeric/date field to bucket."
            },
            "start": {
              "type": "string"
            },
            "end": {
              "type": "string"
            },
            "gap": {
              "type": "string",
              "description": "e.g. \"1MONTH\" for dates or \"0.25\" for numbers."
            }
          }
        }
      }
    },
    "hl": {
      "type": [
        "boolean",
        "object"
      ],
      "description": "Enable highlighting (true) or object form.",
      "properties": {
        "fl": {
          "type": "string",
          "description": "Fields to highlight, comma-separated."
        },
        "fragsize": {
          "type": "integer"
        },
        "snippets": {
          "type": "integer"
        },
        "tag": {
          "type": "object",
          "properties": {
            "pre": {
              "type": "string"
            },
            "post": {
              "type": "string"
            }
          }
        }
      }
    },
    "has_image": {
      "type": "integer",
      "enum": [
        0,
        1
      ],
      "description": "Articles with at least one image."
    },
    "has_video": {
      "type": "integer",
      "enum": [
        0,
        1
      ],
      "description": "Articles with at least one video."
    },
    "has_hq_images": {
      "type": "integer",
      "enum": [
        0,
        1
      ],
      "description": "High-quality images (width >= 1200px)."
    },
    "is_media_rich": {
      "type": "integer",
      "enum": [
        0,
        1
      ],
      "description": "Both images and videos."
    },
    "has_author": {
      "type": "integer",
      "enum": [
        0,
        1
      ],
      "description": "Has an attributed author."
    },
    "is_breaking": {
      "type": "integer",
      "enum": [
        0,
        1
      ],
      "description": "Breaking news only."
    },
    "is_duplicate": {
      "type": "integer",
      "enum": [
        0,
        1
      ],
      "description": "0 to exclude duplicates."
    },
    "is_paywall": {
      "type": "integer",
      "enum": [
        0,
        1
      ],
      "description": "0 to exclude paywalled content."
    },
    "is_long_read": {
      "type": "integer",
      "enum": [
        0,
        1
      ],
      "description": "Read time >= 5 minutes."
    },
    "is_short_read": {
      "type": "integer",
      "enum": [
        0,
        1
      ],
      "description": "Read time < 3 minutes."
    },
    "is_premium_source": {
      "type": "integer",
      "enum": [
        0,
        1
      ],
      "description": "Premium sources (OPR >= 6)."
    },
    "is_verified_source": {
      "type": "integer",
      "enum": [
        0,
        1
      ],
      "description": "Verified sources (OPR >= 5)."
    },
    "page": {
      "type": "integer",
      "minimum": 1,
      "description": "Page number (default 1)."
    },
    "per_page": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25,
      "description": "Results per page (default 10). One response carries at most 25 articles."
    },
    "fl": {
      "type": "string",
      "description": "Comma-separated fields to return (dot-notation supported), e.g. \"id,title,source.name,sentiment.overall.score\"."
    }
  },
  "required": [],
  "additionalProperties": true
}

suggest

Resolve a name or prefix to APITube taxonomy IDs so you can use them in the `search_news` tool's filters. The `search_news` tool's most precise filters require IDs you cannot guess: - entity.id — numeric (persons, organizations, locations, brands, events...) - category.id — IPTC slug, e.g. "medtop:04000000" - topic.id — slug - industry.id — numeric Use this tool FIRST to look those IDs up, then pass them into `search_news`. USAGE: - type: which taxonomy to autocomplete — one of "entities", "categories", "topics", "industries". - prefix: the name (or its beginning) to search, e.g. "Tesla", "Elon", "spo". Returns an array of matches; take the `id` of the best match and put it into `search_news`: suggest({ type: "entities", prefix: "Tesla" }) → [{ id: 12345, name: "Tesla, Inc.", ... }] search_news({ entity: { id: "12345" } })

Parameters2

type	string	required	Which taxonomy to autocomplete.
prefix	string	required	Name or prefix to search, e.g. "Tesla", "Elon", "spo".

Raw schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "entities",
        "categories",
        "topics",
        "industries"
      ],
      "description": "Which taxonomy to autocomplete."
    },
    "prefix": {
      "type": "string",
      "description": "Name or prefix to search, e.g. \"Tesla\", \"Elon\", \"spo\"."
    }
  },
  "required": [
    "type",
    "prefix"
  ],
  "additionalProperties": false
}

README.md17 KBView on GitHub

APITube News MCP

Real-time and archived news search for AI agents, over the Model Context Protocol.

Hosted at https://mcp.apitube.io/ — no package to install, no local process to keep alive.

Transport: Streamable HTTP MCP protocol 2025-11-25 2 tools 300,000+ sources 59 languages

Quick Start • Tools • Filters • Prompts • Pricing • Troubleshooting • Docs • Support

300,000+ sources · 177 countries · 59 languages. Sentiment and entities on every article.

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.

code

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 Code

bash

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.

Cline

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

json

{
  "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

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

json

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

Settings → MCP should list apitube-news as connected.

Claude Desktop

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

json

{
  "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.

VS Code (GitHub Copilot)

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

json

{
  "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.

Windsurf

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

json

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

Windsurf Settings → Cascade → MCP Servers → refresh.

Any other client, or plain curl

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:

bash

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}'

json

{
  "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:

bash

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:

jsonc

{ "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:

code

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:

jsonc

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.

Content and taxonomy

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

Sentiment

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

Sources and quality

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

Media, shape and time

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

Output: sorting, paging, faceting, highlighting

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

Other symptoms

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.

Install

Tools (2)

search_newssuggest

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp.apitube.io/

Add to VS Code Add to Cursor

claude_desktop_config.json

json

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

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

APITube News MCP (io.apitube/news)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

Topics

search_news

suggest

APITube News MCP

Overview

Quick Start

Tools

search_news

suggest

Filters

Prompts

Use cases

Pricing

Troubleshooting

Documentation

Registry

Support

License

Install

Remote endpoint

Related servers

`search_news`

`suggest`