@contextstream/mcp-server

ContextStream MCP Server

Give your AI coding assistant brilliant memory, deep context, and superpowers it never had.

Documentation • Pricing

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

Get Started (VS Code + Copilot)

Option 1: Rust MCP (recommended)

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

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

Then run:

contextstream-mcp setup

Option 2: Node MCP

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

After setup, restart VS Code/Copilot.

Works with: Claude Code • Cursor • VS Code • Claude Desktop • Codex CLI • OpenCode • Antigravity

This Isn't Just Memory. This Is Intelligence.

Other tools give your AI a notepad. ContextStream gives it a brain.

Your AI doesn't just remember things—it understands your entire codebase, learns from every conversation, pulls knowledge from your team's GitHub, Slack, and Notion, and delivers exactly the right context at exactly the right moment.

One setup. Instant transformation.

What Changes When You Install This

Before	After
AI searches files one-by-one, burning tokens	Semantic search finds code by meaning in milliseconds
Context lost when conversations get long	Smart compression preserves what matters before compaction
Team knowledge scattered across tools	Unified intelligence from GitHub, Slack, Notion—automatically
Same mistakes repeated across sessions	Lessons system ensures your AI learns from every failure
Generic responses, no project awareness	Deep context about your architecture, decisions, patterns

The Power Under the Hood

Semantic Code Intelligence

Ask "where do we handle authentication?" and get the answer instantly. No grep chains. No reading 10 files. Your AI understands your code at a conceptual level.

SmartRouter Context Delivery

Every message is analyzed. Risky refactor? Relevant lessons surface automatically. Making a decision? Your AI knows to capture it. The right context, every time, without you asking.

Team Knowledge Fusion

Connect GitHub, Slack, and Notion. Discussions from months ago? Surfaced when relevant. That architecture decision buried in a PR comment? Your AI knows about it.

Code Graph Analysis

"What depends on UserService?" "What's the impact of changing this function?" Your AI sees the connections across your entire codebase.

Context Pressure Awareness

Long conversation? ContextStream tracks token usage, auto-saves critical state, and ensures nothing important is lost when context compacts.

The Tools Your AI Gets

init            → Loads your workspace context instantly
context         → Delivers relevant context every single message
search          → Semantic, hybrid, keyword—find anything by meaning
session         → Captures decisions, preferences, lessons automatically
memory          → Builds a knowledge graph of your project
graph           → Maps dependencies and analyzes impact
project         → Indexes your codebase for semantic understanding
media           → Index and search video, audio, images (great for Remotion)
integration     → Queries GitHub, Slack, Notion directly

Your AI uses these automatically. You just code.

Manual Configuration

Skip this if you ran the setup wizard.

Claude Code

claude mcp add contextstream -- npx --prefer-online -y @contextstream/mcp-server@latest
claude mcp update contextstream -e CONTEXTSTREAM_API_URL=https://api.contextstream.io -e CONTEXTSTREAM_API_KEY=your_key

Cursor / Claude Desktop

{
  "mcpServers": {
    "contextstream": {
      "command": "npx",
      "args": ["--prefer-online", "-y", "@contextstream/mcp-server@latest"],
      "env": {
        "CONTEXTSTREAM_API_URL": "https://api.contextstream.io",
        "CONTEXTSTREAM_API_KEY": "your_key"
      }
    }
  }
}

Locations: ~/.cursor/mcp.json • ~/Library/Application Support/Claude/claude_desktop_config.json

OpenCode

Local server:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "contextstream": {
      "type": "local",
      "command": ["npx", "-y", "contextstream-mcp"],
      "environment": {
        "CONTEXTSTREAM_API_KEY": "{env:CONTEXTSTREAM_API_KEY}"
      },
      "enabled": true
    }
  }
}

Remote server:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "contextstream": {
      "type": "remote",
      "url": "https://mcp.contextstream.com",
      "enabled": true
    }
  }
}

For the local variant, export CONTEXTSTREAM_API_KEY before launching OpenCode.

Locations: ./opencode.json • ~/.config/opencode/opencode.json

VS Code

For GitHub Copilot in VS Code, use project-level MCP at .vscode/mcp.json.

Rust MCP (recommended)

{
  "servers": {
    "contextstream": {
      "type": "stdio",
      "command": "contextstream-mcp",
      "args": [],
      "env": {
        "CONTEXTSTREAM_API_URL": "https://api.contextstream.io",
        "CONTEXTSTREAM_API_KEY": "your_key"
      }
    }
  }
}

Node MCP server

{
  "servers": {
    "contextstream": {
      "type": "stdio",
      "command": "npx",
      "args": ["--prefer-online", "-y", "@contextstream/mcp-server@latest"],
      "env": {
        "CONTEXTSTREAM_API_URL": "https://api.contextstream.io",
        "CONTEXTSTREAM_API_KEY": "your_key"
      }
    }
  }
}

GitHub Copilot CLI

Use the Copilot CLI to interactively add the MCP server:

/mcp add

Or add to ~/.copilot/mcp-config.json (pick one runtime):

Rust MCP (recommended)

{
  "mcpServers": {
    "contextstream": {
      "command": "contextstream-mcp",
      "args": [],
      "env": {
        "CONTEXTSTREAM_API_URL": "https://api.contextstream.io",
        "CONTEXTSTREAM_API_KEY": "your_key"
      }
    }
  }
}

Node MCP server

{
  "mcpServers": {
    "contextstream": {
      "command": "npx",
      "args": ["--prefer-online", "-y", "@contextstream/mcp-server@latest"],
      "env": {
        "CONTEXTSTREAM_API_URL": "https://api.contextstream.io",
        "CONTEXTSTREAM_API_KEY": "your_key"
      }
    }
  }
}

For more information, see the GitHub Copilot CLI documentation.

VS Code + Copilot Tips

• Run setup once and keep both config files:
  • ~/.copilot/mcp-config.json
  • .vscode/mcp.json
• Rust install: use contextstream-mcp as the command.
• Node install: use npx --prefer-online -y @contextstream/mcp-server@latest as the command.
• Use mcpServers in Copilot CLI config and servers in VS Code config.

Quick Troubleshooting

• Remove duplicate ContextStream entries across Workspace/User config scopes.
• Check CONTEXTSTREAM_API_URL and CONTEXTSTREAM_API_KEY are set.
• Remove stale version pins like @contextstream/[e-mail].
• Restart VS Code/Copilot after config changes.

Marketplace Note

Marketplace npm installs can pin Node MCP versions and do not run external bootstrap scripts (curl ... | bash / irm ... | iex). Use the Rust install command directly when you want the Rust runtime.

Links

Website: https://contextstream.io

Docs: https://contextstream.io/docs

Stop teaching your AI the same things over and over.
_{ContextStream makes it brilliant from the first message.}