# ContextStream MCP Server

> ContextStream MCP Server is a freemium MCP server for knowledge and memory. Persistent project memory, code search and shared decisions for your coding assistant. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI, vscode
- **Website:** https://contextstream.io/docs/mcp
- **Repository:** https://github.com/contextstream/mcp-server
- **MCP Registry name:** io.github.contextstream/mcp-server
- **Categories:** knowledge and memory, developer tools
- **Listing updated:** 2026-11-14

## About

The connection pairs an indexed repository with durable records so an assistant can answer questions such as where tokens expire or what was decided about retries. Approved plans, decisions, lessons and captured exchanges persist across sessions, assistants and machines, so something saved in Cursor can inform Claude Code the next day.

The docs describe an assistant that picks its own lookups instead of following prescribed commands, and cover handoffs to another agent, runbooks and narrow, expiring context capsules. Personal records and uncaptured conversations stay outside shared context.

It connects Claude Code, Cursor, Codex, VS Code and other clients through a Rust MCP server or a hosted endpoint. Plans use credits: the Starter plan gives 10,000 credits a month with one user and up to 15 projects, with Pro, Elite and Team tiers above it.

## Features

- **Indexed code search:** Find code by intent, text, symbol or path with source locations.
- **Decision memory:** Store decisions and the reasons behind them, with history and conflicts.
- **Lessons:** Surface past corrections when similar work comes up.
- **Handoffs:** Pass state, questions and next steps to another agent.
- **Cross-client continuity:** Context carries between editors and assistants.

## Good for

- Recall why a design choice was made
- Resume work after a session ends
- Find where a behaviour lives without reading the repo
- Hand a review to another agent

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mcp-server https://mcp.contextstream.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.contextstream.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "url": "https://mcp.contextstream.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp-server": {
      "type": "http",
      "url": "https://mcp.contextstream.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "serverUrl": "https://mcp.contextstream.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp-server": {
      "type": "http",
      "url": "https://mcp.contextstream.io/mcp"
    }
  }
}
```

## FAQ

### Is there a free plan?

Yes. Starter includes 10,000 credits a month, one user and up to 15 projects.

### Which clients work?

Claude Code, Cursor, Codex and VS Code are named, plus other supported clients.

### Is shared context private?

Personal records and uncaptured conversations stay outside shared context.

### Do plans differ by features?

The pricing page says every plan has every feature and differs by credits, projects and people.

### Is ContextStream MCP Server free?

ContextStream MCP Server has a free plan, with paid plans for more usage or features.

### How do I add ContextStream MCP Server to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp-server https://mcp.contextstream.io/mcp

### What are the best alternatives to ContextStream MCP Server?

The closest alternatives to ContextStream MCP Server are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/contextstream-mcp-server
