ContextStream MCP Server

Persistent memory and cross-session learning for AI coding assistants. Cloud-based context management via MCP.

Remote serverstreamable-httpTypeScript

What is the ContextStream MCP server?

ContextStream MCP server exists for a simple reason — assistants are far more useful when they can act on ContextStream directly instead of describing what you should do. Persistent memory and cross-session learning for AI coding assistants. Cloud-based context management via MCP.

What you get

Persistent memory, semantic code search, and team context for Claude Code, Cursor, VS Code Copilot, Windsurf — and every MCP-compatible AI coding assistant.

It works with any MCP client: Claude Code, Cursor, VS Code + GitHub Copilot, Windsurf, Cline, Roo Code, Kilo Code, Codex CLI, OpenCode, Aider, Antigravity, and Claude Desktop.

Setting it up

Being a remote server, there is no local install. You register the endpoint with your client, authorise it once, and the tools appear.

What the assistant can call

Once ContextStream is connected, these are the calls the assistant has available:

  • search — semantic, hybrid, keyword, pattern, exhaustive, refactor modes
  • memory — events, decisions, docs, runbooks, tasks, todos, diagrams, transcripts
  • session — capture decisions & lessons, recall past sessions, plans, retroactive capture
  • graph — dependencies, impact analysis, circular deps, unused code
  • capsule — portable, shareable context snapshots for agent handoffs
  • entity — tickets, incidents, releases, sprints, OKRs, risks
  • skill — reusable instruction + action bundles, portable across tools
  • media — index and search images, video, audio, and documents

Configuration and credentials

You will need 3 environment variables: CONTEXTSTREAM_API_URL, CONTEXTSTREAM_API_KEY, CONTEXTSTREAM_TOOLSET. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

Before you rely on it

  • Your data travels to the provider's service, so the usual questions apply about what you send and what they retain.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the contextstream mcp server does with a few real requests.

Choosing this one

Among the knowledge and memory options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. ContextStream's toolset — search, memory, session and 5 more — is a fair guide to whether it matches your workflow. It is maintained by contextstream; worth a glance at recent repository activity before you build anything load-bearing on it.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Available tools

ToolWhat it does
searchsemantic, hybrid, keyword, pattern, exhaustive, refactor modes
memoryevents, decisions, docs, runbooks, tasks, todos, diagrams, transcripts
sessioncapture decisions & lessons, recall past sessions, plans, retroactive capture
graphdependencies, impact analysis, circular deps, unused code
capsuleportable, shareable context snapshots for agent handoffs
entitytickets, incidents, releases, sprints, OKRs, risks
skillreusable instruction + action bundles, portable across tools
mediaindex and search images, video, audio, and documents

How to install the ContextStream 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",
        "CONTEXTSTREAM_TOOLSET": "complete"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
CONTEXTSTREAM_API_URLEndpoint or connection string the server talks to.Yes
CONTEXTSTREAM_API_KEYCredential the server authenticates with.Yes
CONTEXTSTREAM_TOOLSETConfiguration value read at startup.Optional

Example prompts to try

  • Use ContextStream to search.
  • Use ContextStream to memory.
  • Use ContextStream to session.

Frequently asked questions

The source code is linked from the repository URL on this page.