# upriver

A hosted MCP server from Upriver that hands your assistant breakout topics gaining traction online, each backed by source citations.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: upriver-ai
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/upriver-ai/upriver-mcp
- Updated: 2026-06-26
- HTML: https://affpapa.org/en/nevibecode/mcp/upriver

## What it does

Upriver runs remotely. You point your client at `https://mcp.upriver.ai/mcp` over Streamable HTTP and there is nothing to install or keep running locally. One slice of the Upriver API is exposed so far: breakout topics, meaning subjects picking up speed across tech, sports and politics. Every topic arrives with citations drawn from news, reddit and twitter, so the model argues from sources rather than guessing.

Two read-only tools. `breakout_search_topics` takes a keyword, `breakout_list_topics` browses what is rising right now and can filter by lifecycle status. Both cap results at `limit` topics — 10 unless you say otherwise, 25 at most — and each topic carries up to 5 citations plus a `has_more` flag when the page is not the last.

Access is provisioned per account; request it at `dashboard.upriver.ai`. Sign-in goes through Upriver with OAuth, or you pass a key in the `X-API-Key` header. The connector UIs for Claude and ChatGPT accept OAuth only, so a key will not work there. JetBrains IDEs are out for now: they strip custom request headers and lack OAuth for remote servers, which leaves `X-API-Key` with nothing to attach to.

## Requirements
- Remote server: `https://mcp.upriver.ai/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http upriver https://mcp.upriver.ai/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add upriver --url https://mcp.upriver.ai/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "upriver": {
            "url": "https://mcp.upriver.ai/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "upriver": {
            "type": "http",
            "url": "https://mcp.upriver.ai/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http upriver https://mcp.upriver.ai/mcp
```

## When to use it
- see which topics are gaining traction right now
- search breakout topics by keyword
- narrow trends to tech, sports or politics
- pull citations from news, reddit and twitter for each topic
- filter out topics that are already declining

## Example prompts
- Search breakout topics for "AI video effects" and list the sources
- What's gaining traction in tech right now? Give me up to 10 topics with citations
- Show me only declining topics in sports

## Similar
- [Content Strategy Trends MCP](https://affpapa.org/en/nevibecode/mcp/content-strategy-trends-mcp.md) — MCP server · ★ 44
- [Google Trends MCP](https://affpapa.org/en/nevibecode/mcp/google-trends-mcp.md) — MCP server · ★ 16
- [last30days](https://affpapa.org/en/nevibecode/skills/theflohart-last30days.md) — skill · ★ 449
- [trend-discovery](https://affpapa.org/en/nevibecode/skills/trend-discovery.md) — skill · 1300 installs
- [amazon-trending-products](https://affpapa.org/en/nevibecode/skills/amazon-trending-products.md) — skill · 1200 installs
- [tiktok-shop-trending-products](https://affpapa.org/en/nevibecode/skills/tiktok-shop-trending-products.md) — skill · 1100 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md