How do I install ContextStream?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does ContextStream need an API key?

No required environment variable is listed on this record.

What transport does ContextStream use?

ContextStream is reached over HTTP.

When was ContextStream last checked?

Last checked 2026-10-16. Persistent memory and cross-session learning for AI coding assistants (hosted remote MCP).

ContextStream MCP server

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Server URL

https://mcp.contextstream.io/mcp?default_context_mode=fast&src=registry

Provider

Add in Claude

Claude opens with the name and URL filled in. You still confirm it there.

Claude Code

claude mcp add --transport http io.contextstream-mcp https://mcp.contextstream.io/mcp?default_context_mode=fast&src=registry

Run in a terminal.

Claude Desktop

{
  "mcpServers": {
    "io.contextstream-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.contextstream.io/mcp?default_context_mode=fast&src=registry"
      ]
    }
  }
}

claude_desktop_config.json

Step-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Connect your code, docs, and conversations so your agents can find the right files, recall saved decisions, and build on past work across sessions and tools.

Start free with MCP

10,000 monthly credits. No credit card required.

Works with Claude Code, Cursor, Codex, GitHub Copilot, Gemini CLI, Qwen Code, Kimi Code, Muse Code, ZCode, Zed, and more MCP clients, on Claude, GPT, Gemini, Kimi, GLM, Qwen, and other models. Create your account or sign in during MCP onboarding. No separate website signup needed.

macOS and Linux

curl -fsSL https://contextstream.io/scripts/mcp.sh | bash

Windows PowerShell

irm https://contextstream.io/scripts/mcp.ps1 | iex

Paste the command into your terminal and follow onboarding to connect your project and supported editor. Restart your editor after setup.

What gets installed and indexed? · Supported clients · Setup guide · Prefer to start on the web?

Make the next session useful

Ask your connected agent:

Use ContextStream to find the files relevant to my next change. Cite the sources and retrieve any saved project decisions that should guide the work.

Then ask it to save a real decision and its reason. Start a new session and retrieve that decision without explaining it again. Indexing supplies code context; it cannot recover every undocumented decision.

Proof and data controls

95 ms median code search in our published benchmark. This is the measured successful-response median for the disclosed configuration, not a latency guarantee. See results, methodology, and limitations.

Scoped access. Traceable sources. Configurable capture. Indexing sends eligible source contents to ContextStream for hosted search. Transcript saving and local Git metadata capture are on by default and can be turned off. Review data handling and controls before connecting sensitive projects.

npm (Node.js 20+)

npx -y @contextstream/mcp-server@latest setup

The npm launcher downloads the native Rust binary for your platform and verifies its SHA-256 checksum. Pin an exact package version for production automation.

Hosted MCP without a local process

For clients supporting Streamable HTTP and OAuth, the hosted endpoint is:

https://mcp.contextstream.io/mcp?default_context_mode=fast

Supported clients lists one-line add commands for Claude Code, Codex, Gemini CLI, Qwen Code, Copilot CLI, and Droid, and one-click install for VS Code. Use the MCP documentation for other clients and stdio alternatives. A hosted connection alone does not sync your local checkout.

Preview or diagnose setup

contextstream-mcp setup --dry-run
contextstream-mcp doctor --scope=all --only-configured

Scripted and CI setup

For automation, wrap the install in pipefail so it fails when the download fails, instead of reporting success after installing nothing:

bash -o pipefail -c 'curl -fsSL https://contextstream.io/scripts/mcp.sh | bash'

setup --yes reads the key from CONTEXTSTREAM_API_KEY or saved credentials, and needs --workspace-id when the account has more than one workspace:

export CONTEXTSTREAM_API_KEY=...   # or: printf %s "$KEY" | contextstream-mcp configure --api-key-stdin
contextstream-mcp setup --yes --editors=claude --workspace-id=<UUID> --project-path=.

Open source and contributing

This repository contains the MIT-licensed Rust MCP server, client, editor setup, and release tooling. The hosted backend is separate and is not included here. See the architecture, release integrity, and latest release.

cargo build --locked -p mcp-server --bin contextstream-mcp
cargo test --locked --workspace

Use the pinned Rust toolchain. For contribution checks and commit sign-off, read CONTRIBUTING.md. Report vulnerabilities using SECURITY.md. See LICENSE, NOTICE, and GOVERNANCE.md for licensing, trademarks, and project governance.

Let humans be human.

Docs · Pricing · Integrations · Benchmarks

Optional deep project learning

Deep project learning starts off for new accounts. Plain contextstream-mcp setup --yes preserves your current choice. To review consent, run contextstream-mcp configure --account-learning on and confirm on the signed-in privacy page. To withdraw, run contextstream-mcp configure --account-learning off. Agents cannot consent for you. Doctor and init show status only. See data handling and controls.

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Server URL

https://mcp.contextstream.io/mcp?default_context_mode=fast&src=registry

Provider

Add in Claude

Claude opens with the name and URL filled in. You still confirm it there.

Claude Code

claude mcp add --transport http io.contextstream-mcp https://mcp.contextstream.io/mcp?default_context_mode=fast&src=registry

Run in a terminal.

Claude Desktop

{
  "mcpServers": {
    "io.contextstream-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.contextstream.io/mcp?default_context_mode=fast&src=registry"
      ]
    }
  }
}

claude_desktop_config.json

Step-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Connect your code, docs, and conversations so your agents can find the right files, recall saved decisions, and build on past work across sessions and tools.

Start free with MCP

10,000 monthly credits. No credit card required.

macOS and Linux

curl -fsSL https://contextstream.io/scripts/mcp.sh | bash

Windows PowerShell

irm https://contextstream.io/scripts/mcp.ps1 | iex

Paste the command into your terminal and follow onboarding to connect your project and supported editor. Restart your editor after setup.

What gets installed and indexed? · Supported clients · Setup guide · Prefer to start on the web?

Make the next session useful

Ask your connected agent:

Use ContextStream to find the files relevant to my next change. Cite the sources and retrieve any saved project decisions that should guide the work.

Proof and data controls

npm (Node.js 20+)

npx -y @contextstream/mcp-server@latest setup

The npm launcher downloads the native Rust binary for your platform and verifies its SHA-256 checksum. Pin an exact package version for production automation.

Hosted MCP without a local process

For clients supporting Streamable HTTP and OAuth, the hosted endpoint is:

https://mcp.contextstream.io/mcp?default_context_mode=fast

Preview or diagnose setup

contextstream-mcp setup --dry-run
contextstream-mcp doctor --scope=all --only-configured

Scripted and CI setup

For automation, wrap the install in pipefail so it fails when the download fails, instead of reporting success after installing nothing:

bash -o pipefail -c 'curl -fsSL https://contextstream.io/scripts/mcp.sh | bash'

setup --yes reads the key from CONTEXTSTREAM_API_KEY or saved credentials, and needs --workspace-id when the account has more than one workspace:

export CONTEXTSTREAM_API_KEY=...   # or: printf %s "$KEY" | contextstream-mcp configure --api-key-stdin
contextstream-mcp setup --yes --editors=claude --workspace-id=<UUID> --project-path=.

Open source and contributing

cargo build --locked -p mcp-server --bin contextstream-mcp
cargo test --locked --workspace

Let humans be human.

Docs · Pricing · Integrations · Benchmarks

ContextStream

Add this server

Host a copy with our keys and logs.

Related MCP

Related skills

Start free with MCP

Make the next session useful

Proof and data controls

npm (Node.js 20+)

Hosted MCP without a local process

Preview or diagnose setup

Scripted and CI setup

Open source and contributing

Optional deep project learning

ContextStream

Add this server

Host a copy with our keys and logs.

Related MCP

Related skills

Start free with MCP

Make the next session useful

Proof and data controls

npm (Node.js 20+)

Hosted MCP without a local process

Preview or diagnose setup

Scripted and CI setup

Open source and contributing

Optional deep project learning