Docs

NewsMCP changelog

Client-facing changes only — new tools, new or removed parameters, changed defaults, and limits. Internal refactors, logging, and deployment changes are not listed here.

← Back to docs

0.6.4 — August 31, 2026

  • Changed Keyless and free-tier ceilings raised. Keyless: from_ lookback 3 → 7 days, limit 5 → 20 stories per call. Free tier: lookback 7 → 14 days, limit 20 → 50. Calls per hour are unchanged (keyless 20, free tier 50), as is one request in flight at a time. Keyless over-asking is still narrowed with a notice rather than rejected; with a key it is still a validation error naming the maximum. check_limits reports the live ceilings and costs nothing to call.
  • Changed news now returns 20 stories per call by default, up from 10 — a bare call with no limit set returns as much as a keyless caller is allowed.
  • Fixed Keyless narrowing notices are surfaced again on news and check_coverage. A keyless call that asked past a ceiling — limit=25 against the keyless 20, say — was narrowed by the API and answered, but the reply carried no explanation at all: the Note (keyless): line in a markdown or text reply and the notices array under response_format json were both dropped. Both are back, so a thin result now says why it is thin.

0.6.3 — August 26, 2026

  • Changed An overloaded or unreachable search index now answers with a service_overloaded error instead of leaking a raw connection failure. Retry once after a few seconds, then report the outage rather than retrying in a loop.

0.6.2 — August 24, 2026

  • Fixed A natural-language question in news's q no longer returns nothing. Conversational filler is stripped before the search runs, so "what is happening with Iran and sanctions" now returns events instead of an empty result. Quoted phrases, all-caps acronyms and capitalised names are left intact, the rewrite can never empty a query, and every change is reported as a Note: line (or visible in applied_filters.search_text with response_format json). MCP only — REST searches the string you send verbatim.

0.6.1 — August 21, 2026

  • Fixed 429 errors now reliably distinguish a spent hourly call budget (carries retry_after_seconds — wait that long) from a concurrency conflict (no wait quoted — only one request may be in flight at a time). Earlier releases sometimes reported one as the other for news.

0.6.0 — August 21, 2026

  • Removed offset is gone from news — there's no paging past limit any more; the underlying index dropped support for it.
  • Removed Six more parameters dropped from news (order, to_, enriched_only, min_articles, min_sources, min_confidence), taking it from 19 parameters to 13. Sorting is always most-recent/best-match first, “up to now” is the implicit upper bound, and min_newsrooms is the one corroboration floor worth setting.
  • Added subject parameter on news — pass a company, person, or place name and it's quoted automatically (matches as a phrase, not ANDed words) and widens the default search window to 30 days.
  • Added get_story tool — expand one story by id, with include_sources for the complete source-link list.
  • Added check_coverage tool — judges how widely and independently a claim has been reported, separating independent newsrooms from reprints, and totals the clustered variants of one story across languages.
  • Changed sort is now optional and correctly defaults to relevance when a query is given and newsrooms when it isn't — previously every search was silently forced to newsrooms, ranking by story size instead of match quality.

0.5.0 — August 20, 2026

  • Added check_limits tool — reports the caller's access level, remaining hourly searches, lookback ceiling, and largest allowed limit, at no cost to the caller's own quota.
  • Changed news's limit ceiling lowered to 50 (previously 500), matching the API's page-size cap.
  • Changed The environment variable for providing a key when self-hosting is now NEWSMCP_API_KEY (NEWSMCP_API_TOKEN is a deprecated alias, still read).

0.4.0 — August 20, 2026

  • Fixed Requests exceeding a keyed plan's ceiling (e.g. an oversized limit) previously failed with no explanation; the error now names the field and its maximum so the caller can clamp and retry.
  • Fixed A 404 from news/get_story no longer always claims the story id doesn't exist — it now distinguishes a genuinely unresolved id from a server misconfiguration.

0.3.0 — August 19, 2026

  • Added news — the current search tool, wrapping GET /v0/news / GET /v0/news/{event_id}: query plus event_type/content_type/sector filters, corroboration floors, a story-start window, sorting, paging, verbosity, fetch-by-id, and response_format (markdown/text/json, markdown by default).
  • Removed Breaking. the search_news tool is gone; news is the only search surface. Anything calling search_news by name must switch to news.
  • Removed Breaking. the x-api-token header is no longer accepted; use x-api-key.
  • Fixed Keyed calls were silently being served as keyless due to the server sending the wrong upstream auth header — keys now work correctly and get the full keyed page size.
  • Added news rejects sort="relevance" without a q, with a message pointing at trending or the default instead of letting the call fail upstream.
  • Added Keyless narrowing notices are now shown in markdown/text replies, not just json — previously a narrowed keyless response looked identical to a full one outside of JSON mode.