breakout_search_topicsLABSCO 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_topicssearches topics by keyword —queryis required, with optionalvertical(tech, sports or politics),limitandcitation_sourcesbreakout_list_topicsbrowses what is trending now, filtered byvertical,status(active, emerging, trending, declining, detected or all) and the same limit and citation options- Both are read-only. Each returns up to
limittopics — default 10, max 25 — and each topic carries up to 5 source citations citation_sourcesrestricts citations to news, reddit or twitter; ahas_moreflag 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
USE CASES
01
Finding out what is gaining traction in a space right now
Browse the live topics for one vertical and read the momentum signal.
02
Checking whether a specific subject is breaking out
Search by keyword instead of scanning the whole list.
03
Grounding an answer in sources you can open
Read the citations attached to each topic rather than the topic name alone.
04
Filtering out a source you don't trust
Restrict citations to news, reddit or twitter as suits the question.
2 tools
Listed in project docs. Your client may show a different list.
breakout_list_topicsBEFORE YOU INSTALL
What to know first
Tools you get
2 tools named in the project's documentation.
Requires
- A client that can reach a remote MCP server over HTTP
- UPRIVER_API_KEY in your environment
INSTALLATION
Connect your client
Server setup
claude mcp add
Claude Code
TERMINAL
claude mcp add --transport http upriver https://mcp.upriver.ai/mcpHosted endpoint
ENDPOINT URL
https://mcp.upriver.ai/mcpAdd this hosted endpoint to your MCP client using the credentials listed under Requirements.
MCP Clients
Cursor
CURSOR · JSON
{
"mcpServers": {
"upriver": {
"url": "https://mcp.upriver.ai/mcp"
}
}
}VS Code
VS CODE · JSON
{
"servers": {
"upriver": {
"type": "http",
"url": "https://mcp.upriver.ai/mcp"
}
}
}Cline
CLINE · JSON
{
"mcpServers": {
"upriver": {
"type": "streamableHttp",
"url": "https://mcp.upriver.ai/mcp"
}
}
}Windsurf
WINDSURF · JSON
{
"mcpServers": {
"upriver": {
"serverUrl": "https://mcp.upriver.ai/mcp"
}
}
}Codex
CODEX · TERMINAL
codex mcp add upriver --url https://mcp.upriver.ai/mcp --header X-API-Key=<YOUR_API_KEY>Goose
GOOSE · YAML
extensions:
upriver:
type: streamable_http
uri: https://mcp.upriver.ai/mcp
enabled: true
headers:
X-API-Key: ${UPRIVER_API_KEY}Zed
ZED · JSON
{
"context_servers": {
"upriver": {
"url": "https://mcp.upriver.ai/mcp",
"headers": {
"X-API-Key": "<YOUR_API_KEY>"
}
}
}
}
