# ContextStream

A hosted MCP server that gives your agent access to code, docs and saved project decisions. Useful when a fresh session starts from nothing.

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

## What it does

ContextStream connects an agent to your code, documentation and earlier conversations. The agent locates the files it needs, pulls up decisions you stored before, and continues from previous work even when you move between tools. Indexing supplies code context; decisions nobody wrote down stay lost.

Two ways in. The local installer fetches a native Rust build and checks its SHA-256 checksum, while the npm route expects Node.js 20+. Or point your client at the hosted endpoint `https://mcp.contextstream.io/mcp?default_context_mode=fast`, which speaks Streamable HTTP and OAuth. A hosted connection on its own does not sync your local checkout, so think about how your code is reached before you rely on it.

Indexing ships eligible source contents to ContextStream for hosted search. Saving transcripts and capturing local Git metadata both start enabled and you can switch them off. In scripts and CI, wrap the install in `pipefail` — otherwise a failed download can still report success. `setup --yes` reads the key from `CONTEXTSTREAM_API_KEY` or saved credentials, and needs `--workspace-id` when the account holds more than one workspace.

## Requirements
- Needs: a prebuilt binary from the repository releases
- Remote server: `https://mcp.contextstream.io/mcp?default_context_mode=fast&src=registry`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http mcp 'https://mcp.contextstream.io/mcp?default_context_mode=fast&src=registry'
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add contextstream --url 'https://mcp.contextstream.io/mcp?default_context_mode=fast&src=registry'
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "contextstream": {
            "url": "https://mcp.contextstream.io/mcp?default_context_mode=fast&src=registry"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "contextstream": {
            "type": "http",
            "url": "https://mcp.contextstream.io/mcp?default_context_mode=fast&src=registry"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http contextstream 'https://mcp.contextstream.io/mcp?default_context_mode=fast&src=registry'
```

## When to use it
- locate the files a coming change touches
- recall a stored project decision in a new session
- keep code and docs context in one place
- share the same context across several editors
- review what leaves your machine before indexing a sensitive project

## Example prompts
- Save this decision and the reason we made it.
- Retrieve the saved project decisions before I start.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

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