[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_107":108},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module not found","tools","module",{"_20":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":34,"_35":26,"_36":37,"_38":-5,"_39":-5,"_40":41,"_42":43,"_44":45,"_46":47,"_48":49,"_50":51,"_52":53,"_54":55,"_56":-5,"_57":49,"_58":59,"_60":61,"_62":63,"_64":65,"_66":67,"_68":49,"_69":70,"_71":72,"_73":74,"_75":76,"_77":78,"_79":-5,"_80":-5,"_81":-5,"_82":49,"_83":-5,"_84":59,"_85":86,"_87":88,"_89":90,"_91":92,"_93":94},"apiUrl","https://odel.app/api","creator","upriver-ai","moduleId","upriver-mcp","@upriver-ai/upriver-mcp","displayName","upriver mcp","tagline","Know what's gaining traction online: breakout topics in tech, sports & politics, with citations.","iconKey","https://avatars.githubusercontent.com/u/120606799?v=4","category","remote","status","published","visibility","public","metaDescription","deploymentType","external","workerName","bindingName","mcpConfig","{\"url\":\"https://mcp.upriver.ai/mcp\",\"transport\":\"streamable-http\",\"authType\":\"none\"}","pricingModel","free","creatorUserId","system:external-import","createdAt",1783311997000,"updatedAt",1788755295000,"sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=ai.upriver%2Fupriver","sourceVerified",false,"sourceMissingSince","importedAt","upstreamStars",0,"upstreamUpdatedAt",1782515322000,"detectedTransport","streamable-http","detectedAuthType","oauth","probeStatus","ok","lastProbedAt","githubRepoUrl","https://github.com/upriver-ai/upriver-mcp","githubRepoFullName","upriver-ai/upriver-mcp","releaseId","ext-upriver-ai-upriver-mcp","version","0.1.0","descriptionMarkdown","

\n $\"Upriver\"$ \n

\n\n

Upriver MCP

\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

More clients — Codex CLI, ChatGPT, Goose, Zed

\n\n**Codex CLI (OpenAI)**\n\n```bash\ncodex mcp add upriver --url https://mcp.upriver.ai/mcp --header X-API-Key=YOUR_UPRIVER_API_KEY\n```\n\n**ChatGPT** — Enable **Developer mode** (Settings → Apps & Connectors → Advanced), then\n**Settings → Connectors → Create**, name it `Upriver`, paste `https://mcp.upriver.ai/mcp`,\nchoose **OAuth**, and sign in. (No custom-header field — OAuth only in the UI.)\n\n**Goose** — add to `~/.config/goose/config.yaml`:\n\n```yaml\nextensions:\n upriver:\n type: streamable_http\n uri: https://mcp.upriver.ai/mcp\n enabled: true\n headers:\n X-API-Key: \"${UPRIVER_API_KEY}\"\n```\n\n**Zed** — add to `settings.json` under `context_servers`:\n\n```json\n{ \"context_servers\": { \"upriver\": { \"url\": \"https://mcp.upriver.ai/mcp\", \"headers\": { \"X-API-Key\": \"YOUR_UPRIVER_API_KEY\" } } } }\n```\n\n

\n\n### Any other MCP client\n\nMost clients use the Cursor shape above (`mcpServers` + `url`, optional `headers`).\nFor agents that read install manifests, see [`llms-install.md`](https://github.com/upriver-ai/upriver-mcp/blob/main/llms-install.md).\n\n> **JetBrains IDEs:** MCP works, but the IDE currently drops custom request headers and\n> doesn't yet support OAuth for remote servers, so Upriver's `X-API-Key` auth can't\n> connect there yet — we'll list it once JetBrains ships the fix.\n\n## Tools available today\n\nThe MCP server currently exposes Upriver's **breakout topics** — emerging\nsubjects gaining traction online across tech, sports, and politics, each\nreturned with grounded source citations so the model reasons from real evidence\ninstead of guessing.\n\nBoth tools are read-only. Each returns up to `limit` topics (default 10,\nmax 25), every topic carrying up to 5 source citations, plus a `has_more` flag\nwhen more topics exist beyond the page.\n\n### `breakout_search_topics`\n\nSearch breakout topics by keyword.\n\n| Parameter | Type | Description |\n|---|---|---|\n| `query` | string · **required** | Natural-language search, e.g. `\"AI video effects\"`. |\n| `vertical` | enum | Restrict to `tech`, `sports`, or `politics`. |\n| `limit` | integer | 1–25 (default 10). |\n| `citation_sources` | array | Restrict citations to any of `news`, `reddit`, `twitter`. |\n\n### `breakout_list_topics`\n\nBrowse breakout topics gaining traction right now.\n\n| Parameter | Type | Description |\n|---|---|---|\n| `vertical` | enum | Restrict to `tech`, `sports`, or `politics`. |\n| `status` | enum | Lifecycle filter: `active` (default), `emerging`, `trending`, `declining`, `detected`, or `all`. |\n| `limit` | integer | 1–25 (default 10). |\n| `citation_sources` | array | Restrict citations to any of `news`, `reddit`, `twitter`. |\n\nEach topic includes its name, vertical, lifecycle status, a momentum signal, and\nits top citations (title, URL, source category, and publish time).\n\n## More on the way\n\nBreakout topics are the first slice of the Upriver API to land as MCP tools. The\nfull API — Creators, Audiences, Brands, Products, Trends, and Sponsorships — is\ndocumented at **[docs.upriver.ai](https://docs.upriver.ai)**, and we're rolling\nthose endpoints out as MCP tools. Watch this repository for new tools as they\nship.\n\n## Access\n\nUpriver MCP access is provisioned per account. Request access at\n[dashboard.upriver.ai](https://dashboard.upriver.ai) or email\n[support@upriver.ai](mailto:support@upriver.ai). Once your account is enabled,\nthe same Upriver sign-in (or API key) works across every MCP client.\n\n## Links\n\n- **Docs** — https://docs.upriver.ai\n- **Dashboard** — https://dashboard.upriver.ai\n- **Website** — https://upriver.ai\n\n## License\n\nThe contents of this repository — connection documentation and listing\nmetadata — are released under the [MIT License](https://github.com/upriver-ai/upriver-mcp/blob/main/LICENSE).\n\nThe hosted Upriver MCP service and the Upriver API are operated by Potato\nLaboratories, Inc. d/b/a Upriver and are governed by Upriver's\n[Terms of Service](https://upriver.ai/terms). The MIT License covers this\nrepository only — not the service, nor the data it returns. \"Upriver\" and the\nUpriver logo are trademarks of Potato Laboratories, Inc. and are not covered by\nthe MIT License.\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays","upstream",{"_97":98,"_99":100,"_101":-5,"_102":103,"_104":-5,"_105":106},"requiredSecrets",[],"tags",[],"assets",[],"stats",{"_95":59,"_96":59},"ratingAvg","reviewCount","topics",[],"license","MIT","language","registryName","ai.upriver/upriver","homepage","packages",[],"ENV",{"_109":110,"_111":112,"_113":114},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]