upriver

Upriver MCP

AI アプリケーション向けに、クリエイター、オーディエンス、ブランド、トレンド、スポンサーシップに関するリアルタイムのコンテキストを提供します。

Upriver について

Upriver は、オンラインで起きていることを AI アプリケーション向けのリアルタイムで信頼できるコンテキストに変換する API を提供します。実際の情報源に基づく、証拠に裏付けられたシグナルを次の分野にわたって提供します。

• クリエイター — 関連するクリエイターとプロフィール
• オーディエンス — ペルソナ、関心事、言語、ユーモア
• ブランド — ブランドと、それらがどのように話題にされているか
• 製品 — 製品への言及とユースケース
• トレンド — 注目を集めているトピックと形式
• スポンサーシップ — ブランドとクリエイターの関係、および広告掲載

このリポジトリは、Upriver の Model Context Protocol（MCP） サーバーのホームです。このサーバーは、あらゆる MCP 対応の AI アシスタントやエージェントにコンテキストを提供します。

接続

インストールや実行が不要な、ホスト型のリモートサーバーです。OAuth サインインはすべてのクライアントで機能します。 X-API-Key ヘッダーは Claude Code、Cursor、VS Code、 Cline、Windsurf、Codex CLI、Goose、Zed でサポートされていますが、OAuth のみ対応の Claude および ChatGPT のコネクター UI ではサポートされていません。

Claude Code（CLI）

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

OAuth の代わりに API キーを使用するには、ヘッダーとして渡します。

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

Cursor

~/.cursor/mcp.json（グローバル）または .cursor/mcp.json（プロジェクトごと）に追加してから、Settings → Tools & Integrations で接続し、サインインします。

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

API キー認証の場合は、"headers": { "X-API-Key": "YOUR_UPRIVER_API_KEY" } を追加します。

VS Code（GitHub Copilot）

VS Code では異なる形式を使用します。トップレベルに servers が必要で、"type": "http" も必須です。 .vscode/mcp.json に追加するか、MCP: Add Server を実行します。

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

API キー認証の場合は、"headers": { "X-API-Key": "YOUR_UPRIVER_API_KEY" } を追加します。

Claude Desktop と claude.ai

Claude で Customize → Connectors → "+" → Add custom connector に進み、名前を Upriver にして https://mcp.upriver.ai/mcp を貼り付け、Connect を選択してサインインします。 （Claude のコネクターは OAuth のみ対応です。API キー用のフィールドはありません。また、claude_desktop_config.json に生の url エントリを追加しないでください。デスクトップアプリで拒否されます。）

Cline

Remote Servers タブ（Transport: Streamable HTTP）を使用するか、 cline_mcp_settings.json を編集します。type フィールドは必須です。指定しないと Cline は旧式の SSE にフォールバックし、失敗します。

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

Windsurf

~/.codeium/windsurf/mcp_config.json を編集します。Windsurf のフィールド名は serverUrl です。

{ "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

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

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

その他の MCP クライアント

ほとんどのクライアントでは、上記の Cursor 形式（mcpServers と url、任意の headers）を使用します。 インストールマニフェストを読み込むエージェントについては、llms-install.md を参照してください。

JetBrains IDEs： MCP は動作しますが、現在 IDE はカスタムリクエストヘッダーを削除してしまい、リモートサーバー向けの OAuth にもまだ対応していません。そのため、Upriver の X-API-Key 認証ではまだ接続できません。JetBrains が修正をリリースしたら掲載します。

現在利用できるツール

MCP サーバーは現在、Upriver の急上昇トピックを公開しています。これは、テクノロジー、スポーツ、政治の分野でオンライン上の注目を集めつつある新たな話題で、モデルが推測ではなく実際の根拠に基づいて推論できるよう、出典付きで返されます。

どちらのツールも読み取り専用です。それぞれ最大 limit 件のトピックを返します（デフォルトは 10 件、最大 25 件）。各トピックには最大 5 件の出典が付き、次のページにさらにトピックがある場合は has_more フラグが設定されます。

breakout_search_topics

キーワードで急上昇トピックを検索します。

breakout_list_topics

現在注目を集めている急上昇トピックを閲覧します。

各トピックには、名前、分野、ライフサイクルのステータス、勢いを示すシグナル、および上位の出典（タイトル、URL、出典カテゴリ、公開日時）が含まれます。

今後の予定

急上昇トピックは、Upriver API のうち、最初に MCP ツールとして提供される機能です。Creators、Audiences、Brands、Products、Trends、Sponsorships を含む API 全体のドキュメントは docs.upriver.ai にあります。これらのエンドポイントも MCP ツールとして順次提供していきます。新しいツールのリリースについては、このリポジトリをご確認ください。

アクセス

Upriver MCP の利用権限はアカウントごとに付与されます。dashboard.upriver.ai からアクセスを申請するか、[email protected] までメールでお問い合わせください。アカウントが有効になると、同じ Upriver サインイン情報（または API キー）をすべての MCP クライアントで利用できます。

リンク

• ドキュメント — https://docs.upriver.ai
• ダッシュボード — https://dashboard.upriver.ai
• ウェブサイト — https://upriver.ai

ライセンス

このリポジトリの内容（接続ドキュメントおよび掲載メタデータ）は、MIT License の下で公開されています。

ホスト型の Upriver MCP サービスおよび Upriver API は、Potato Laboratories, Inc.（Upriver として事業を運営）が運営しており、Upriver の利用規約が適用されます。MIT License の適用対象はこのリポジトリのみであり、サービスやサービスが返すデータは対象外です。「Upriver」および Upriver のロゴは Potato Laboratories, Inc. の商標であり、MIT License の適用対象ではありません。