MCP Server

Active

MIT

ContextStream MCP Server MCP Server

io.github.contextstream/mcp-server

Persistent memory and millisecond code search for AI agents across sessions.

What is the ContextStream MCP Server MCP server?

The ContextStream MCP Server provides persistent project memory, semantic code search, and grounded agent context for AI coding assistants. It indexes your codebase and docs to help agents find relevant files, recall saved decisions, and build on past work across sessions. Works with Claude, Cursor, GitHub Copilot, and other MCP-compatible clients.

ContextStream connects your code, documentation, and conversations so AI agents can perform fast semantic code search (95ms median), save and retrieve project decisions, and maintain context across multiple sessions. It's designed to make agents more effective by giving them access to both your codebase and the reasoning behind your architectural decisions.

How to install ContextStream MCP Server

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

CONTEXTSTREAM_API_KEY
required
secret
ContextStream API key
CONTEXTSTREAM_API_URL
ContextStream API base URL

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@contextstream/mcp-server"
      ],
      "env": {
        "CONTEXTSTREAM_API_KEY": "<YOUR_CONTEXTSTREAM_API_KEY>",
        "CONTEXTSTREAM_API_URL": "<YOUR_CONTEXTSTREAM_API_URL>"
      }
    }
  }
}

Tools & capabilities

Tools this server exposes to the agent.

Semantic code search — Fast indexed search across your codebase to find relevant files and code snippets.
Project memory — Save and retrieve project decisions and context across sessions.
Git metadata capture — Local Git metadata capture for grounded agent context (configurable).
Transcript saving — Save conversations and decisions for future reference (configurable).

Use cases

Find relevant files and code context before making changes to a large codebase
Save architectural decisions and retrieve them in future sessions without re-explaining
Get AI agents up to speed on project conventions and past decisions across multiple coding sessions
Search code semantically across your entire project in milliseconds
Maintain persistent context for multi-turn agent interactions across tools and editors

ContextStream MCP Server MCP server FAQ

What is ContextStream?

ContextStream is an MCP server that provides persistent project memory and semantic code search for AI agents. It indexes your codebase and lets you save decisions that agents can retrieve in future sessions.

Is it free?

Yes, ContextStream offers 10,000 monthly credits free with no credit card required. Paid plans are available for higher usage.

How do I install it in Cursor or Claude?

Run the one-line installer: `curl -fsSL https://contextstream.io/scripts/mcp.sh | bash` on macOS/Linux or the PowerShell equivalent on Windows. Follow the onboarding to connect your project and editor, then restart your editor.

What data gets sent to ContextStream?

Source code contents are sent for hosted search indexing. Transcript saving and Git metadata capture are on by default but can be turned off. Review the data handling documentation before connecting sensitive projects.

Which editors and AI models does it support?

Works with Claude Code, Cursor, GitHub Copilot, Gemini CLI, Qwen Code, Kimi Code, and other MCP-compatible clients on Claude, GPT, Gemini, Kimi, and other models.

Do I need to create a separate account?

No, you create your account or sign in during MCP onboarding in your editor—no separate website signup needed.

README (reference)

Source of truth, from the repository.

<p align="center"> <img src="assets/contextstream-logo.png" alt="ContextStream" width="64" /> </p> <h1 align="center">ContextStream MCP Server</h1> <p align="center"><strong>Persistent memory. Millisecond code search.</strong></p>

Your agent knows code. Give it the decisions behind yours.

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.

<details> <summary><strong>Other installation options and troubleshooting</strong></summary>

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

</details>

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

Related MCP servers

ContextStream MCP Server

Active

Persistent memory and millisecond code search for AI agents across sessions.

Rust

MIT

View repository →

ContinueWith

Maintained

Install the ContinueWith AI handoff widget from coding agents (Cursor, Claude Code, Codex).

JavaScript

View repository →

ConvergeQA Compare (Due Diligence)

Maintained

Compare one prompt across a multi-model panel side by side, with public verification receipts.

Python

MIT

View repository →

ConvergeQA Reviews (Critique & Iterate)

Maintained

Multi-model Critique and Iterate document reviews with public verification receipts.

Python

MIT

View repository →

ResearchSprint

AI research reports: market analysis, competitor intel, blog posts. USDC payment.

Conversor IAE-CNAE

Active

The first fiscal MCP server for Spain: IAE/CNAE 2025, AEAT modelos, IRPF/IVA, RETA quota.

MIT

View repository →