Upriver

- Creators— relevant creators and profiles
- Audiences— personas, interests, language, and humor
- Brands— brands and how they're being discussed
- Products— product mentions and use cases
- Trends— topics and formats gaining attention
- Sponsorships— brand–creator relationships and placements

This repository is the home of Upriver'sModel Context Protocol (MCP)server, which brings that context to any MCP-compatible AI assistant or agent.

It's a remote, hosted server — nothing to install or run.OAuth sign-in works in every client.TheX-API-Keyheader is supported by Claude Code, Cursor, VS Code, Cline, Windsurf, Codex CLI, Goose, and Zed — butnotby Claude's or ChatGPT's connector UIs, which are OAuth-only.

claude mcp add --transport http upriver https://mcp.upriver.ai/mcp

To use an API key instead of OAuth, pass it as a header:

claude mcp add --transport http upriver https://mcp.upriver.ai/mcp \ --header "X-API-Key: YOUR_UPRIVER_API_KEY"

{ "mcpServers": { "upriver": { "url": "https://mcp.upriver.ai/mcp" } } }

For API-key auth, add"headers": { "X-API-Key": "YOUR_UPRIVER_API_KEY" }.

VS Code uses a different shape — top-levelserversand a required"type": "http". Add to.vscode/mcp.json(or runMCP: Add Server):

{ "servers": { "upriver": { "type": "http", "url": "https://mcp.upriver.ai/mcp" } } }

For API-key auth, add"headers": { "X-API-Key": "YOUR_UPRIVER_API_KEY" }.

Use theRemote Serverstab (Transport:Streamable HTTP), or editcline_mcp_settings.json— thetypefield is required, or Cline falls back to legacy SSE and fails:

{ "mcpServers": { "upriver": { "type": "streamableHttp", "url": "https://mcp.upriver.ai/mcp" } } }

Edit~/.codeium/windsurf/mcp_config.json— Windsurf's field isserverUrl:

{ "mcpServers": { "upriver": { "serverUrl": "https://mcp.upriver.ai/mcp" } } }

codex mcp add upriver --url https://mcp.upriver.ai/mcp --header X-API-Key=YOUR_UPRIVER_API_KEY

Goose— add to~/.config/goose/config.yaml:

extensions: upriver: type: streamable_http uri: https://mcp.upriver.ai/mcp enabled: true headers: X-API-Key: "${UPRIVER_API_KEY}"

Zed— add tosettings.jsonundercontext_servers:

{ "context_servers": { "upriver": { "url": "https://mcp.upriver.ai/mcp", "headers": { "X-API-Key": "YOUR_UPRIVER_API_KEY" } } } }

JetBrains IDEs:MCP works, but the IDE currently drops custom request headers and doesn't yet support OAuth for remote servers, so Upriver'sX-API-Keyauth can't connect there yet — we'll list it once JetBrains ships the fix.

The MCP server currently exposes Upriver'sbreakout topics— emerging subjects gaining traction online across tech, sports, and politics, each returned with grounded source citations so the model reasons from real evidence instead of guessing.

Both tools are read-only. Each returns up tolimittopics (default 10, max 25), every topic carrying up to 5 source citations, plus ahas_moreflag when more topics exist beyond the page.

Browse breakout topics gaining traction right now.

Each topic includes its name, vertical, lifecycle status, a momentum signal, and its top citations (title, URL, source category, and publish time).

Search global news using natural language. Webz.io News Search API returns the most relevant articles and content, with filters for source, country, language, date, sentiment, and category.

Objective-driven deep research paid per request via MPP - free daily quick search (news/arXiv), quote-first paid cloud-browser research with cross-source reports. MCP Streamable HTTP, no API key.

About Free multi-engine MCP search server — 8 free engines (DDG, Sogou, Bing, Baidu, Wikipedia, Startpage, Yandex, Mojeek), waterfall progressive search, multi-source verification, content enrichment, news search, language auto-detection, rate limit exposure. Zero API keys needed. Self-hostable.

Hosted MCP server for the APITube News API: search articles from 500,000+ sources in 60+ languages, filtered by sentiment, entities, topics and source quality.

A search engine for AI applications, providing world knowledge from web pages and various content sources like weather, news, and images.

Fetches the latest news headlines from the Boring News API.

An MCP (Model Context Protocol) server that gives AI assistants real-time news fetching, search, NLP analysis, and personalized news preferences — all accessible through natural language.

Comprehensive web, news, and social media search and analysis using xAI's Grok API.

Search for stories, get user information, and interact with Hacker News.