Summary

Citations attached to every topic, not offered separately.

A trend feed that hands a model a list of topic names invites confident invention; here each topic arrives with up to five citations carrying title, URL and publish time, so an answer can be traced back. The tool surface is deliberately small right now — breakout topics only, with creators, brands and sponsorships still on the API side.

What it is

A hosted server on the Upriver API. Today it exposes Upriver's breakout topics: subjects picking up attention online, returned with grounded citations so the model reasons from real sources rather than from what it remembers. Nothing to install — it is remote and speaks Streamable HTTP.

What you get

`breakout_search_topics` searches topics by keyword — `query` is required, with optional `vertical` (tech, sports or politics), `limit` and `citation_sources`
`breakout_list_topics` browses what is trending now, filtered by `vertical`, `status` (active, emerging, trending, declining, detected or all) and the same limit and citation options
Both are read-only. Each returns up to `limit` topics — default 10, max 25 — and each topic carries up to 5 source citations
`citation_sources` restricts citations to news, reddit or twitter; a `has_more` flag tells you when there are further topics beyond the page
Each topic includes its name, vertical, lifecycle status, a momentum signal, and its top citations with title, URL, source category and publish time

Requirements

Upriver access is provisioned per account — request it at `dashboard.upriver.ai`. Point a client at `https://mcp.upriver.ai/mcp` and either sign in with OAuth, which works everywhere, or send your key in an `X-API-Key` header. In Claude Code: `claude mcp add --transport http upriver https://mcp.upriver.ai/mcp`. The header route is supported by Claude Code, Cursor, VS Code, Cline, Windsurf, Codex CLI, Goose and Zed, but not by Claude's or ChatGPT's connector UIs, which are OAuth-only. JetBrains IDEs currently drop custom headers and don't yet do OAuth for remote servers, so neither path connects there.

Setup effort

One command plus a key — claude mcp add --transport http upriver https://mcp.upriver.ai/mcp, then supply credentials