# ContextStream MCP server

> Lets AI agents search your code, recall saved team decisions, and reuse project context across sessions and tools, with cited sources.

- Repository: https://github.com/contextstream/mcp-server
- Page: https://hostedmcp.org/servers/contextstream/mcp-server
- Transport: remote
- Stars: 46
- License: MIT
- Latest version: 0.5.35

## Install

### Claude Code

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

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

```json
{
  "mcpServers": {
    "mcp-server": {
      "url": "https://mcp.contextstream.io/mcp?default_context_mode=fast&src=registry"
    }
  }
}
```

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

```json
{
  "servers": {
    "mcp-server": {
      "type": "http",
      "url": "https://mcp.contextstream.io/mcp?default_context_mode=fast&src=registry"
    }
  }
}
```

### Codex (`~/.codex/config.toml`)

```toml
[mcp_servers.mcp-server]
url = "https://mcp.contextstream.io/mcp?default_context_mode=fast&src=registry"
```

### Gemini CLI (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "mcp-server": {
      "httpUrl": "https://mcp.contextstream.io/mcp?default_context_mode=fast&src=registry"
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `CONTEXTSTREAM_API_KEY` | no | no |  |

## FAQ

### How do I install the ContextStream MCP server?

Run the one-line install script for macOS/Linux or Windows PowerShell, or use the npm launcher with setup. Then restart your editor and follow onboarding to connect your project.

### Does ContextStream let agents remember decisions from past sessions?

Yes. Agents can save a decision with its reason, then retrieve it in a new session without you explaining it again.

### What data does ContextStream capture, and can I turn it off?

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.

### Can I use ContextStream without installing a local process?

Yes, if your client supports Streamable HTTP and OAuth, you can connect to the hosted endpoint. A hosted connection alone does not sync your local checkout.

### Does ContextStream have a free tier?

Yes, it starts free with 10,000 monthly credits and no credit card required. You can create or sign in to an account during MCP onboarding.