![\"Upriver\"](\"https://mcp.upriver.ai/icon.png\"){kind=icon}
\n\n \n
Real-time context on creators, audiences, brands, trends, and sponsorships — for AI applications.
\n\n## About Upriver\n\n[Upriver](https://upriver.ai) provides an API that turns what's happening online\ninto real-time, reliable context for AI applications. It delivers\nevidence-backed signals — each grounded in real sources — across:\n\n- **Creators** — relevant creators and profiles\n- **Audiences** — personas, interests, language, and humor\n- **Brands** — brands and how they're being discussed\n- **Products** — product mentions and use cases\n- **Trends** — topics and formats gaining attention\n- **Sponsorships** — brand–creator relationships and placements\n\nThis repository is the home of Upriver's **Model Context Protocol (MCP)**\nserver, which brings that context to any MCP-compatible AI assistant or agent.\n\n## Connect\n\n| | |\n|---|---|\n| **Endpoint** | `https://mcp.upriver.ai/mcp` |\n| **Transport** | Streamable HTTP |\n| **Auth** | Sign in with Upriver (OAuth), or send your Upriver API key in the `X-API-Key` header |\n\nIt's a remote, hosted server — nothing to install or run. **OAuth sign-in works in\nevery client.** The `X-API-Key` header is supported by Claude Code, Cursor, VS Code,\nCline, Windsurf, Codex CLI, Goose, and Zed — but **not** by Claude's or ChatGPT's\nconnector UIs, which are OAuth-only.\n\n### Claude Code (CLI)\n\n```bash\nclaude mcp add --transport http upriver https://mcp.upriver.ai/mcp\n```\n\nTo use an API key instead of OAuth, pass it as a header:\n\n```bash\nclaude mcp add --transport http upriver https://mcp.upriver.ai/mcp \\\n --header \"X-API-Key: YOUR_UPRIVER_API_KEY\"\n```\n\n### Cursor\n\nAdd to `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (per-project), then connect\nit in **Settings → Tools & Integrations** to sign in:\n\n```json\n{ \"mcpServers\": { \"upriver\": { \"url\": \"https://mcp.upriver.ai/mcp\" } } }\n```\n\nFor API-key auth, add `\"headers\": { \"X-API-Key\": \"YOUR_UPRIVER_API_KEY\" }`.\n\n### VS Code (GitHub Copilot)\n\nVS Code uses a different shape — top-level **`servers`** and a required **`\"type\": \"http\"`**.\nAdd to `.vscode/mcp.json` (or run **MCP: Add Server**):\n\n```json\n{ \"servers\": { \"upriver\": { \"type\": \"http\", \"url\": \"https://mcp.upriver.ai/mcp\" } } }\n```\n\nFor API-key auth, add `\"headers\": { \"X-API-Key\": \"YOUR_UPRIVER_API_KEY\" }`.\n\n### Claude Desktop & claude.ai\n\nIn Claude, go to **Customize → Connectors → \"+\" → Add custom connector**, name it\n`Upriver`, paste `https://mcp.upriver.ai/mcp`, then **Connect** and sign in.\n(Claude's connector is OAuth-only — there's no field for an API key, and don't add a\nraw `url` entry to `claude_desktop_config.json`; the desktop app rejects it.)\n\n### Cline\n\nUse the **Remote Servers** tab (Transport: **Streamable HTTP**), or edit\n`cline_mcp_settings.json` — the `type` field is required, or Cline falls back to legacy\nSSE and fails:\n\n```json\n{ \"mcpServers\": { \"upriver\": { \"type\": \"streamableHttp\", \"url\": \"https://mcp.upriver.ai/mcp\" } } }\n```\n\n### Windsurf\n\nEdit `~/.codeium/windsurf/mcp_config.json` — Windsurf's field is **`serverUrl`**:\n\n```json\n{ \"mcpServers\": { \"upriver\": { \"serverUrl\": \"https://mcp.upriver.ai/mcp\" } } }\n```\n\n