# Upstream.so

A remote MCP server for the Upstream.so cloud streaming platform. It lets an assistant start broadcasts, edit playback queues and plan schedules.

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

## What it does

One URL, `https://studio.upstream.so/mcp`, over Streamable HTTP. There is no local process and no package to pull down. Every tool follows the public Upstream API, so ownership checks, validation and rate limits match the REST endpoint behind it.

Streams come first: list them with pagination, fetch one by UUID, create, patch, delete, start and stop. Stopping cuts a live broadcast for viewers, so keep approval prompts on. Scheduling is not a separate tool — `create_stream` and `update_stream` accept a `schedule` object with start and end times, repeats, and a continuous mode that carries its own work and rest intervals. Playback queues, media library search and multistream destinations round out the set.

OAuth is the recommended path: add the URL, sign in on `studio.upstream.so`, approve the access. Your client gets a token, not your password. Clients that send custom headers can use a Personal Access Token from Profile → API Keys as `Authorization: Bearer`. Both grant the same tools, including ones that change or delete data — the `mcp:use` scope is not read-only. A saved API-key header can stop a client from starting OAuth, so clear it before reconnecting.

## Requirements
- Remote server: `https://studio.upstream.so/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http upstream https://studio.upstream.so/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add upstreamso --url https://studio.upstream.so/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "upstreamso": {
            "url": "https://studio.upstream.so/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "upstreamso": {
            "type": "http",
            "url": "https://studio.upstream.so/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http upstreamso https://studio.upstream.so/mcp
```

## When to use it
- start a broadcast on YouTube or Twitch from the chat
- reorder items in a playback queue
- find a file in the media library
- set up a repeating schedule with breaks
- add a destination for multistreaming

## Example prompts
- List my streams, newest first
- Start the stream on my Twitch channel
- Move this clip to the top of the playback queue

## Similar
- [smartest-tv](https://affpapa.org/en/nevibecode/mcp/smartest-tv.md) — MCP server · ★ 55
- [tracing-upstream-lineage](https://affpapa.org/en/nevibecode/skills/tracing-upstream-lineage.md) — skill · 1000 installs
- [Spotify Automation](https://affpapa.org/en/nevibecode/skills/spotify-automation.md) — skill · 4600 installs
- [upstream-patches](https://affpapa.org/en/nevibecode/skills/upstream-patches.md) — skill · 634 installs
- [mcp-arr](https://affpapa.org/en/nevibecode/mcp/mcp-arr.md) — MCP server · ★ 234
- [wonda-cli](https://affpapa.org/en/nevibecode/skills/wonda-cli.md) — skill · 74600 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