Hottub News

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Worldwide news for agents: search, sync and story clusters across outlets and languages. No key.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Hottub News": {
      "url": "https://hottub.news/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (10)

• search_news read-only

  Newest-first headlines from worldwide sources, optionally filtered by words, language, country, topic, source, kind and time.

  Parameters:

  • q — string — What you're looking for, in any language. Matches by meaning and by keyword (hybrid) over the last 7 days unless since is given; results carry a relevance score.
  • kind — string — Comma-separated: article, press_release, official, community, research, sponsored
  • lang — string — Comma-separated ISO 639-1 codes, e.g. "en,es"
  • sort — string — hot: most widely covered stories of the last 48h, one per story; positive/negative: most positive/negative tone first (last 24h unless since is given)
  • limit — integer
  • match — string — keyword: exact words only; semantic: meaning only (cross-language)
  • since — string — Only items published at/after this: RFC 3339, a date, or an age like "6h", "2d"
  • topic — string — Comma-separated topics, e.g. "space,science"
  • until — string — Only items published at/before this
  • before — string — Paging cursor from a previous result's next link
  • entity — string — Comma-separated Wikidata ids (from find_entities), e.g. "Q312"
  • format — string — md: readable with summaries; lines: tab-separated, fewest tokens; ndjson/json: full records
  • source — string — Comma-separated source ids (see list_sources) or publisher domains
  • country — string — Comma-separated ISO 3166-1 alpha-2 codes of the publisher's country, e.g. "US,GB"
  • category — string — Comma-separated IPTC top-level categories: arts-culture-entertainment, conflict-war, crime-law, disaster-accident, economy-business, education, environment, health, human-interest, labour, lifestyle-leisure, politics, religion, science-technology, society, sport, weather
  • collapse — string — One item per story (best representative); related = other reports of it
  • tone_max — number
  • tone_min — number — Only items with tone ≥ this (-1 most negative … 1 most positive)
  • political — boolean — true: political stories only (political score ≥ 0.5); false: non-political only
  • sentiment — string — Comma-separated: negative, neutral, positive
  • sponsored — string — Paid press releases are labeled; exclude to omit them

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• sync_news read-only

  Incremental feed: returns items added after `after`, oldest first, plus a new cursor. Call again with that cursor to get only what is new.

  Parameters:

  • after (required) — integer — The cursor returned by your previous sync_news call; 0 to start from the oldest retained item
  • kind — string — Comma-separated: article, press_release, official, community, research, sponsored
  • lang — string — Comma-separated ISO 639-1 codes, e.g. "en,es"
  • limit — integer
  • since — string — Only items published at/after this: RFC 3339, a date, or an age like "6h", "2d"
  • topic — string — Comma-separated topics, e.g. "space,science"
  • until — string — Only items published at/before this
  • format — string — md: readable with summaries; lines: tab-separated, fewest tokens; ndjson/json: full records
  • source — string — Comma-separated source ids (see list_sources) or publisher domains
  • country — string — Comma-separated ISO 3166-1 alpha-2 codes of the publisher's country, e.g. "US,GB"
  • category — string — Comma-separated IPTC top-level categories: arts-culture-entertainment, conflict-war, crime-law, disaster-accident, economy-business, education, environment, health, human-interest, labour, lifestyle-leisure, politics, religion, science-technology, society, sport, weather
  • tone_max — number
  • tone_min — number — Only items with tone ≥ this (-1 most negative … 1 most positive)
  • political — boolean — true: political stories only (political score ≥ 0.5); false: non-political only
  • sentiment — string — Comma-separated: negative, neutral, positive
  • sponsored — string — Paid press releases are labeled; exclude to omit them

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• list_stories read-only

  The most widely covered stories right now (last 48h), each with a neutral multi-source brief when available, outlet count, languages, entities and a representative report. Filter by lang, country, category, entity.

  Parameters:

  • lang — string
  • limit — integer
  • entity — string
  • format — string
  • country — string
  • category — string

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• find_entities read-only

  Look up Wikidata ids for a name (e.g. "Tesla", "Lagos") with how many items mention each in the last 7 days; pass the id as `entity` to search_news or list_stories.

  Parameters:

  • q (required) — string

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_story read-only

  Every item in a story (the `story` id on items, st_…): all outlets and languages covering the same event, newest first.

  Parameters:

  • story (required) — string
  • format — string

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_news_item read-only

  Full record for one item id (n_… for news, s_… for sponsored).

  Parameters:

  • id (required) — string

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• list_sources read-only

  Registered sources with their language, country, kind and health. Filter by q (name), country or lang.

  Parameters:

  • q — string
  • lang — string
  • country — string

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• quote_placement read-only

  Quote for placing a labeled, paid press release in the Hottub News mix via Hottub Business. Price varies by topic tier, current topic interest, demand, targeting reach and duration; the response itemizes each factor. Read-only: returns a price; books and charges nothing.

  Parameters:

  • days — integer
  • lang — string
  • topics — string — Comma-separated topics to target, e.g. "ai,business"; omit for run of network
  • country — string

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• newsmap read-only

  What the news covered in a period, for the world or a region: reports counted by publisher country (a choropleth map, as links to SVG and PNG) and the most widely covered stories with outlet counts. Periods: YYYY-MM-DD (UTC day), YYYY-wWW (ISO week), YYYY-MM, or today, yesterday, this-week, last-week, this-month, last-month. Past periods are final and permanent.

  Parameters:

  • format — string
  • period — string — 2026-10-17, 2026-w42, 2026-10, today, yesterday, this-week, last-week, this-month or last-month
  • region — string

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• news_stats read-only

  Item counts over the last 24 hours by kind, language, country and source, plus the current sync cursor.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.