Summary
ContextStream wires your AI assistant into a persistent memory and knowledge layer across your codebase, conversations, and team tools. It exposes semantic search over code, a lessons system that captures failures and decisions, session memory that survives context window pressure, and direct integrations with GitHub, Slack, and Notion. The server indexes your project locally and syncs with a hosted service, then surfaces relevant context automatically through a SmartRouter that analyzes each message. You get dependency graph queries, multi-modal media indexing, and hybrid search without manually feeding files into prompts. Setup drops an MCP config into Claude Desktop, Cursor, VS Code with Copilot, or OpenCode, and the tools hook in transparently from there.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
Tools
Public tool metadata for what this MCP can expose to an agent.
59 tools
mcp_server_versionReturn the running ContextStream MCP server package version Access: Free
Return the running ContextStream MCP server package version Access: Free
No parameter schema in public metadata yet.
auth_meFetch authenticated user profile Access: Free
Fetch authenticated user profile Access: Free
No parameter schema in public metadata yet.
workspaces_listList accessible workspaces (paginated list: items, total, page, per_page, has_next, has_prev). Access: Free2 params
List accessible workspaces (paginated list: items, total, page, per_page, has_next, has_prev). Access: Free
Parameters* required
pagenumberPage number for pagination.
page_sizenumberResults per page.
projects_listList projects (optionally by workspace; paginated list: items, total, page, per_page, has_next, has_prev). Access: Free3 params
List projects (optionally by workspace; paginated list: items, total, page, per_page, has_next, has_prev). Access: Free
Parameters* required
pagenumberPage number for pagination.
page_sizenumberResults per page.
workspace_idstringWorkspace ID (UUID).
projects_createCreate a new project within a workspace. Use this when you need to create a project for a specific folder/codebase. If workspace_id is not provided, uses the current session's workspace. Optionally associates a local folder and generates AI editor rules. Access: Free Access: Free5 params
Create a new project within a workspace. Use this when you need to create a project for a specific folder/codebase. If workspace_id is not provided, uses the current session's workspace. Optionally associates a local folder and generates AI editor rules. Access: Free Access: Free
Parameters* required
namestringProject name
descriptionstringProject description
folder_pathstringOptional: Local folder path to associate with this project
workspace_idstringWorkspace ID (uses current session workspace if not provided)
generate_editor_rulesbooleanGenerate AI editor rules in folder_path (requires folder_path)
projects_updateUpdate a project (rename or change description) Access: Free3 params
Update a project (rename or change description) Access: Free
Parameters* required
namestringName for the resource.
project_idstringProject ID (UUID).
descriptionstringShort description.
projects_indexTrigger indexing for a project Access: Free1 params
Trigger indexing for a project Access: Free
Parameters* required
project_idstringProject ID (UUID).
search_semanticSemantic vector search Access: Free4 params
Semantic vector search Access: Free
Parameters* required
limitnumberMaximum number of results to return.
querystringSearch query string.
project_idstringProject ID (UUID).
workspace_idstringWorkspace ID (UUID).
search_hybridHybrid search (semantic + keyword) Access: Free4 params
Hybrid search (semantic + keyword) Access: Free
Parameters* required
limitnumberMaximum number of results to return.
querystringSearch query string.
project_idstringProject ID (UUID).
workspace_idstringWorkspace ID (UUID).
search_keywordKeyword search Access: Free4 params
Keyword search Access: Free
Parameters* required
limitnumberMaximum number of results to return.
querystringSearch query string.
project_idstringProject ID (UUID).
workspace_idstringWorkspace ID (UUID).
memory_create_eventCreate a memory event for a workspace/project Access: Free6 params
Create a memory event for a workspace/project Access: Free
Parameters* required
titlestringShort descriptive title.
contentstringFull content/body.
metadataobjectInput parameter: metadata.
event_typestringInput parameter: event type.
project_idstringProject ID (UUID).
workspace_idstringWorkspace ID (UUID).
memory_list_eventsList memory events (optionally scoped) Access: Free3 params
List memory events (optionally scoped) Access: Free
Parameters* required
limitnumberMaximum number of results to return.
project_idstringProject ID (UUID).
workspace_idstringWorkspace ID (UUID).
memory_create_nodeCreate a knowledge node with optional relations Access: Free6 params
Create a knowledge node with optional relations Access: Free
Parameters* required
titlestringShort descriptive title.
contentstringFull content/body.
node_typestringInput parameter: node type.
relationsarrayInput parameter: relations.
project_idstringProject ID (UUID).
workspace_idstringWorkspace ID (UUID).
memory_list_nodesList knowledge graph nodes Access: Free3 params
List knowledge graph nodes Access: Free
Parameters* required
limitnumberMaximum number of results to return.
project_idstringProject ID (UUID).
workspace_idstringWorkspace ID (UUID).
memory_searchSearch memory events/notes Access: Free4 params
Search memory events/notes Access: Free
Parameters* required
limitnumberMaximum number of results to return.
querystringSearch query string.
project_idstringProject ID (UUID).
workspace_idstringWorkspace ID (UUID).
memory_decisionsList decision summaries from workspace memory Access: Free4 params
List decision summaries from workspace memory Access: Free
Parameters* required
limitnumberMaximum number of results to return.
categorystringOptional category filter. If not specified, returns all decisions regardless of category.
project_idstringProject ID (UUID).
workspace_idstringWorkspace ID (UUID).
graph_relatedFind related nodes in the knowledge graph Access: Elite/Team (Full Graph) (upgrade: https://contextstream.io/pricing)4 params
Find related nodes in the knowledge graph Access: Elite/Team (Full Graph) (upgrade: https://contextstream.io/pricing)
Parameters* required
limitnumberMaximum number of results to return.
node_idstringNode ID (UUID).
project_idstringProject ID (UUID).
workspace_idstringWorkspace ID (UUID).
graph_pathFind path between two nodes Access: Elite/Team (Full Graph) (upgrade: https://contextstream.io/pricing)4 params
Find path between two nodes Access: Elite/Team (Full Graph) (upgrade: https://contextstream.io/pricing)
Parameters* required
source_idstringID for the source.
target_idstringID for the target.
project_idstringProject ID (UUID).
workspace_idstringWorkspace ID (UUID).
graph_decisionsDecision history in the knowledge graph Access: Elite/Team (Full Graph) (upgrade: https://contextstream.io/pricing)3 params
Decision history in the knowledge graph Access: Elite/Team (Full Graph) (upgrade: https://contextstream.io/pricing)
Parameters* required
limitnumberMaximum number of results to return.
project_idstringProject ID (UUID).
workspace_idstringWorkspace ID (UUID).
graph_dependenciesDependency graph query Access: Pro (Graph-Lite) (upgrade: https://contextstream.io/pricing)3 params
Dependency graph query Access: Pro (Graph-Lite) (upgrade: https://contextstream.io/pricing)
Parameters* required
targetobjectInput parameter: target.
max_depthnumberMaximum traversal depth.
include_transitivebooleanInclude transitive dependencies.
graph_call_pathFind call path between two targets Access: Elite/Team (Full Graph) (upgrade: https://contextstream.io/pricing)3 params
Find call path between two targets Access: Elite/Team (Full Graph) (upgrade: https://contextstream.io/pricing)
Parameters* required
sourceobjectInput parameter: source.
targetobjectInput parameter: target.
max_depthnumberMaximum traversal depth.
graph_impactAnalyze impact of a target node Access: Pro (Graph-Lite) (upgrade: https://contextstream.io/pricing)2 params
Analyze impact of a target node Access: Pro (Graph-Lite) (upgrade: https://contextstream.io/pricing)
Parameters* required
targetobjectInput parameter: target.
max_depthnumberMaximum traversal depth.
graph_ingestBuild and persist the dependency graph for a project. Runs async by default (wait=false) and can take a few minutes for larger repos. Access: Elite/Team (Full Graph) (upgrade: https://contextstream.io/pricing)2 params
Build and persist the dependency graph for a project. Runs async by default (wait=false) and can take a few minutes for larger repos. Access: Elite/Team (Full Graph) (upgrade: https://contextstream.io/pricing)
Parameters* required
waitbooleanIf true, wait for ingestion to finish before returning. Defaults to false (async).
project_idstringProject ID (UUID).
projects_getGet project details by ID Access: Free1 params
Get project details by ID Access: Free
Parameters* required
project_idstringProject ID (UUID).
projects_overviewGet project overview with summary information Access: Free1 params
Get project overview with summary information Access: Free
Parameters* required
project_idstringProject ID (UUID).
projects_statisticsGet project statistics (files, lines, complexity) Access: Free1 params
Get project statistics (files, lines, complexity) Access: Free
Parameters* required
project_idstringProject ID (UUID).
projects_filesList all indexed files in a project Access: Free1 params
List all indexed files in a project Access: Free
Parameters* required
project_idstringProject ID (UUID).
projects_index_statusGet project indexing status Access: Free1 params
Get project indexing status Access: Free
Parameters* required
project_idstringProject ID (UUID).
projects_ingest_localRead ALL files from a local directory and ingest them for indexing. This indexes your entire project by reading files in batches. Automatically detects code files and skips ignored directories like node_modules, target, dist, etc. Access: Free4 params
Read ALL files from a local directory and ingest them for indexing. This indexes your entire project by reading files in batches. Automatically detects code files and skips ignored directories like node_modules, target, dist, etc. Access: Free
Parameters* required
pathstringLocal directory path to read files from
overwritebooleanAllow overwriting existing files when write_to_disk is enabled
project_idstringProject to ingest files into (defaults to current session project)
write_to_diskbooleanWhen true, write files to disk under QA_FILE_WRITE_ROOT before indexing (for testing/QA)
workspaces_getGet workspace details by ID Access: Free1 params
Get workspace details by ID Access: Free
Parameters* required
workspace_idstringWorkspace ID (UUID).
memory_get_eventGet a specific memory event by ID with FULL content (not truncated). Use this when you need the complete content of a memory event, not just the preview returned by search/recall. Access: Free1 params
Get a specific memory event by ID with FULL content (not truncated). Use this when you need the complete content of a memory event, not just the preview returned by search/recall. Access: Free
Parameters* required
event_idstringThe UUID of the memory event to retrieve
memory_update_eventUpdate a memory event Access: Free4 params
Update a memory event Access: Free
Parameters* required
titlestringShort descriptive title.
contentstringFull content/body.
event_idstringEvent ID (UUID).
metadataobjectInput parameter: metadata.
memory_delete_eventDelete a memory event Access: Free1 params
Delete a memory event Access: Free
Parameters* required
event_idstringEvent ID (UUID).
memory_timelineGet chronological timeline of memory events for a workspace Access: Free1 params
Get chronological timeline of memory events for a workspace Access: Free
Parameters* required
workspace_idstringWorkspace ID (UUID).
memory_summaryGet condensed summary of workspace memory Access: Free1 params
Get condensed summary of workspace memory Access: Free
Parameters* required
workspace_idstringWorkspace ID (UUID).
graph_circular_dependenciesDetect circular dependencies in project code Access: Elite/Team (Full Graph) (upgrade: https://contextstream.io/pricing)1 params
Detect circular dependencies in project code Access: Elite/Team (Full Graph) (upgrade: https://contextstream.io/pricing)
Parameters* required
project_idstringProject ID (UUID).
graph_unused_codeDetect unused code in project Access: Elite/Team (Full Graph) (upgrade: https://contextstream.io/pricing)1 params
Detect unused code in project Access: Elite/Team (Full Graph) (upgrade: https://contextstream.io/pricing)
Parameters* required
project_idstringProject ID (UUID).
session_initInitialize a new conversation session and automatically retrieve relevant context. This is the FIRST tool AI assistants should call when starting a conversation. Returns: workspace info, project info, recent memory, recent decisions, relevant context, and high-priority lessons...9 params
Initialize a new conversation session and automatically retrieve relevant context. This is the FIRST tool AI assistants should call when starting a conversation. Returns: workspace info, project info, recent memory, recent decisions, relevant context, and high-priority lessons...
Parameters* required
auto_indexbooleanAutomatically create and index project from IDE workspace (default: true)
project_idstringProject to initialize context for
session_idstringCustom session ID (auto-generated if not provided)
folder_pathstringCurrent workspace/project folder path (absolute). Use this when IDE roots are not available.
context_hintstringRECOMMENDED: Pass the user's first message here for semantic search. This finds relevant context from ANY time, not just recent items.
workspace_idstringWorkspace to initialize context for
include_decisionsbooleanInclude recent decisions (default: true)
allow_no_workspacebooleanIf true, allow session_init to return connected even if no workspace is resolved (workspace-level tools may not work).
include_recent_memorybooleanInclude recent memory events (default: true)
session_toolsGet an ultra-compact list of all available ContextStream MCP tools. Use this when you need to know what tools are available without reading full descriptions. Returns a token-efficient tool catalog (~120 tokens) organized by category. Format options: - 'grouped' (default): Cat...2 params
Get an ultra-compact list of all available ContextStream MCP tools. Use this when you need to know what tools are available without reading full descriptions. Returns a token-efficient tool catalog (~120 tokens) organized by category. Format options: - 'grouped' (default): Cat...
Parameters* required
formatstringOutput format: grouped (default, ~120 tokens), minimal (~80 tokens), or full (~200 tokens)one of
grouped · minimal · fulldefault: groupedcategorystringFilter to specific category: Session, Search, Memory, Knowledge, Graph, Workspace, Project, AI
session_get_user_contextRetrieve user preferences, coding style, and persona from memory. Use this to understand how the user likes to work and adapt your responses accordingly. Access: Free1 params
Retrieve user preferences, coding style, and persona from memory. Use this to understand how the user likes to work and adapt your responses accordingly. Access: Free
Parameters* required
workspace_idstringWorkspace to get user context from
workspace_associateAssociate a folder/repo with a workspace after user selection. Call this after session_init returns status='requires_workspace_selection' and the user has chosen a workspace. This persists the selection to .contextstream/config.json so future sessions auto-connect. Optionally...5 params
Associate a folder/repo with a workspace after user selection. Call this after session_init returns status='requires_workspace_selection' and the user has chosen a workspace. This persists the selection to .contextstream/config.json so future sessions auto-connect. Optionally...
Parameters* required
folder_pathstringAbsolute path to the folder/repo to associate
workspace_idstringWorkspace ID to associate with
workspace_namestringWorkspace name for reference
create_parent_mappingbooleanAlso create a parent folder mapping (e.g., /dev/maker/* -> workspace)
generate_editor_rulesbooleanGenerate AI editor rules for Windsurf, Cursor, Cline, Kilo Code, Roo Code, Claude Code, and Aider
workspace_bootstrapCreate a new workspace (user-provided name) and onboard the current folder as a project. This is useful when session_init returns status='requires_workspace_name' (no workspaces exist yet) or when you want to create a new workspace for a repo. Behavior: - Creates a workspace w...8 params
Create a new workspace (user-provided name) and onboard the current folder as a project. This is useful when session_init returns status='requires_workspace_name' (no workspaces exist yet) or when you want to create a new workspace for a repo. Behavior: - Creates a workspace w...
Parameters* required
auto_indexbooleanAutomatically create and index project from folder (default: true)
visibilitystringWorkspace visibility (default: private)one of
private · publicdescriptionstringOptional workspace description
folder_pathstringAbsolute folder path (defaults to IDE root/cwd)
context_hintstringOptional context hint for session initialization
workspace_namestringName for the new workspace (ask the user)
create_parent_mappingbooleanAlso create a parent folder mapping (e.g., /dev/company/* -> workspace)
generate_editor_rulesbooleanGenerate AI editor rules in the folder for automatic ContextStream usage
session_captureAutomatically capture and store important context from the conversation. Use this to persist decisions, insights, preferences, or important information. Access: Free8 params
Automatically capture and store important context from the conversation. Use this to persist decisions, insights, preferences, or important information. Access: Free
Parameters* required
tagsarrayTags for categorization
titlestringBrief title for the captured context
contentstringFull content/details to capture
event_typestringType of context being capturedone of
conversation · decision · insight · preference · task · bugimportancestringImportance levelone of
low · medium · high · criticalproject_idstringProject ID (UUID).
session_idstringSession ID to associate with this capture
workspace_idstringWorkspace ID (UUID).
session_capture_lessonCapture a lesson learned from a mistake or correction. Use this when the user corrects you, expresses frustration, or points out an error. These lessons are surfaced in future sessions to prevent repeating the same mistakes. Example triggers: - User says "No, you should..." or...9 params
Capture a lesson learned from a mistake or correction. Use this when the user corrects you, expresses frustration, or points out an error. These lessons are surfaced in future sessions to prevent repeating the same mistakes. Example triggers: - User says "No, you should..." or...
Parameters* required
titlestringLesson title - what to remember (e.g., "Always verify assets in git before pushing")
impactstringWhat went wrong (e.g., "Production 404 errors - broken landing page")
triggerstringWhat action caused the problem (e.g., "Pushed code referencing images without committing them")
categorystringCategory of the lessonone of
workflow · code_quality · verification · communication · project_specifickeywordsarrayKeywords for matching in future contexts (e.g., ["git", "images", "assets", "push"])
severitystringSeverity: critical for production issues, high for breaking changes, medium for workflow, low for minorone of
low · medium · high · criticaldefault: mediumpreventionstringHow to prevent in future (e.g., "Run git status to check untracked files before pushing")
project_idstringProject ID (UUID).
workspace_idstringWorkspace ID (UUID).
session_get_lessonsRetrieve lessons learned from past mistakes and corrections. Use this to check for relevant warnings before taking actions that have caused problems before. Returns lessons filtered by: - Query: semantic search for relevant lessons - Category: workflow, code_quality, verificat...6 params
Retrieve lessons learned from past mistakes and corrections. Use this to check for relevant warnings before taking actions that have caused problems before. Returns lessons filtered by: - Query: semantic search for relevant lessons - Category: workflow, code_quality, verificat...
Parameters* required
limitnumberMaximum lessons to returndefault: 10
querystringSearch for relevant lessons (e.g., "git push images")
categorystringFilter by categoryone of
workflow · code_quality · verification · communication · project_specificseveritystringFilter by minimum severityone of
low · medium · high · criticalproject_idstringProject ID (UUID).
workspace_idstringWorkspace ID (UUID).
session_smart_searchSearch memory with automatic context enrichment. Returns memory matches, relevant code, and related decisions in one call. Access: Free5 params
Search memory with automatic context enrichment. Returns memory matches, relevant code, and related decisions in one call. Access: Free
Parameters* required
querystringWhat to search for
project_idstringProject ID (UUID).
workspace_idstringWorkspace ID (UUID).
include_relatedbooleanInclude related context (default: true)
include_decisionsbooleanInclude related decisions (default: true)
session_rememberQuick way to store something in memory. Use natural language. Example: "Remember that I prefer TypeScript strict mode" or "Remember we decided to use PostgreSQL" Access: Free5 params
Quick way to store something in memory. Use natural language. Example: "Remember that I prefer TypeScript strict mode" or "Remember we decided to use PostgreSQL" Access: Free
Parameters* required
contentstringWhat to remember (natural language)
importancestringInput parameter: importance.one of
low · medium · highproject_idstringProject ID (UUID).
workspace_idstringWorkspace ID (UUID).
await_indexingbooleanIf true, wait for indexing to complete before returning. This ensures the content is immediately searchable.
session_recallQuick way to recall relevant context. Use natural language. Example: "What were the auth decisions?" or "What are my TypeScript preferences?" Access: Free3 params
Quick way to recall relevant context. Use natural language. Example: "What were the auth decisions?" or "What are my TypeScript preferences?" Access: Free
Parameters* required
querystringWhat to recall (natural language)
project_idstringProject ID (UUID).
workspace_idstringWorkspace ID (UUID).
generate_editor_rulesGenerate AI rule files for editors (Windsurf, Cursor, Cline, Kilo Code, Roo Code, Claude Code, Aider). These rules instruct the AI to automatically use ContextStream for memory and context. Supported editors: codex, windsurf, cursor, cline, kilo, roo, claude, aider Access: Free8 params
Generate AI rule files for editors (Windsurf, Cursor, Cline, Kilo Code, Roo Code, Claude Code, Aider). These rules instruct the AI to automatically use ContextStream for memory and context. Supported editors: codex, windsurf, cursor, cline, kilo, roo, claude, aider Access: Free
Parameters* required
modestringRule verbosity mode (default: minimal)one of
minimal · fulldry_runbooleanIf true, return content without writing files
editorsarrayWhich editors to generate rules for. Defaults to all.
folder_pathstringAbsolute path to the project folder
project_namestringProject name to include in rules
workspace_idstringWorkspace ID to include in rules
workspace_namestringWorkspace name to include in rules
additional_rulesstringAdditional project-specific rules to append
session_summaryGet a compact, token-efficient summary of workspace context (~500 tokens). This is designed to replace loading full chat history in AI prompts. Returns: workspace/project info, top decisions (titles only), preferences, memory count. Use this at conversation start instead of lo...3 params
Get a compact, token-efficient summary of workspace context (~500 tokens). This is designed to replace loading full chat history in AI prompts. Returns: workspace/project info, top decisions (titles only), preferences, memory count. Use this at conversation start instead of lo...
Parameters* required
max_tokensnumberMaximum tokens for summary (default: 500)
project_idstringProject ID (UUID).
workspace_idstringWorkspace ID (UUID).
session_compressExtract and store key information from chat history as memory events. This allows clearing chat history while preserving important context. Use at conversation end or when context window is getting full. Extracts: - Decisions made - User preferences learned - Insights discover...4 params
Extract and store key information from chat history as memory events. This allows clearing chat history while preserving important context. Use at conversation end or when context window is getting full. Extracts: - Decisions made - User preferences learned - Insights discover...
Parameters* required
project_idstringProject ID (UUID).
chat_historystringThe chat history to compress and extract from
workspace_idstringWorkspace ID (UUID).
extract_typesarrayTypes of information to extract (default: all)
session_deltaGet new context added since a specific timestamp. Useful for efficient context synchronization without reloading everything. Returns: - Count of new decisions and memory events - List of new items with titles and timestamps Use case: AI can track what's new since last session_...4 params
Get new context added since a specific timestamp. Useful for efficient context synchronization without reloading everything. Returns: - Count of new decisions and memory events - List of new items with titles and timestamps Use case: AI can track what's new since last session_...
Parameters* required
limitnumberMaximum items to return (default: 20)
sincestringISO timestamp to get changes since (e.g., "2025-12-05T00:00:00Z")
project_idstringProject ID (UUID).
workspace_idstringWorkspace ID (UUID).
context_smart**CALL THIS BEFORE EVERY AI RESPONSE** to get relevant context. This is the KEY tool for token-efficient AI interactions. It: 1. Analyzes the user's message to understand what context is needed 2. Retrieves only relevant context in a minified, token-efficient format 3. Replace...5 params
**CALL THIS BEFORE EVERY AI RESPONSE** to get relevant context. This is the KEY tool for token-efficient AI interactions. It: 1. Analyzes the user's message to understand what context is needed 2. Retrieves only relevant context in a minified, token-efficient format 3. Replace...
Parameters* required
formatstringContext format (default: minified)one of
minified · readable · structuredmax_tokensnumberMaximum tokens for context (default: 800)
project_idstringProject ID (UUID).
user_messagestringThe user message to analyze and get context for
workspace_idstringWorkspace ID (UUID).
reminders_listList all reminders for the current user. Returns: reminders with title, content, remind_at, priority, status, and keywords. Can filter by status (pending, completed, dismissed, snoozed) and priority (low, normal, high, urgent). Use this to see what reminders you have set. Acce...5 params
List all reminders for the current user. Returns: reminders with title, content, remind_at, priority, status, and keywords. Can filter by status (pending, completed, dismissed, snoozed) and priority (low, normal, high, urgent). Use this to see what reminders you have set. Acce...
Parameters* required
limitnumberMaximum reminders to return (default: 20)
statusstringFilter by statusone of
pending · completed · dismissed · snoozedprioritystringFilter by priorityone of
low · normal · high · urgentproject_idstringProject ID (UUID).
workspace_idstringWorkspace ID (UUID).
reminders_activeGet active reminders that are pending, overdue, or due soon. Returns: reminders with urgency levels (overdue, due_soon, today, upcoming). Optionally provide context (e.g., current task description) to get contextually relevant reminders. Use this to see what reminders need att...4 params
Get active reminders that are pending, overdue, or due soon. Returns: reminders with urgency levels (overdue, due_soon, today, upcoming). Optionally provide context (e.g., current task description) to get contextually relevant reminders. Use this to see what reminders need att...
Parameters* required
limitnumberMaximum reminders to return (default: 10)
contextstringOptional context to match relevant reminders (e.g., current task)
project_idstringProject ID (UUID).
workspace_idstringWorkspace ID (UUID).
reminders_createCreate a new reminder for a specific date/time. Set reminders to be notified about tasks, follow-ups, or important dates. Priority levels: low, normal, high, urgent Recurrence: daily, weekly, monthly (optional) Example: Create a reminder to "Review PR #123" for tomorrow at 10a...8 params
Create a new reminder for a specific date/time. Set reminders to be notified about tasks, follow-ups, or important dates. Priority levels: low, normal, high, urgent Recurrence: daily, weekly, monthly (optional) Example: Create a reminder to "Review PR #123" for tomorrow at 10a...
Parameters* required
titlestringReminder title (brief, descriptive)
contentstringReminder details/description
keywordsarrayKeywords for contextual surfacing
prioritystringPriority level (default: normal)one of
low · normal · high · urgentremind_atstringWhen to remind (ISO 8601 datetime, e.g., "2025-01-15T10:00:00Z")
project_idstringProject ID (UUID).
recurrencestringRecurrence patternone of
daily · weekly · monthlyworkspace_idstringWorkspace ID (UUID).
reminders_snoozeSnooze a reminder until a later time. Use this to postpone a reminder without dismissing it. Common snooze durations: - 1 hour: add 1 hour to current time - 4 hours: add 4 hours - Tomorrow: next day at 9am - Next week: 7 days from now Access: Free2 params
Snooze a reminder until a later time. Use this to postpone a reminder without dismissing it. Common snooze durations: - 1 hour: add 1 hour to current time - 4 hours: add 4 hours - Tomorrow: next day at 9am - Next week: 7 days from now Access: Free
Parameters* required
untilstringWhen to resurface the reminder (ISO 8601 datetime)
reminder_idstringID of the reminder to snooze
reminders_completeMark a reminder as completed. Use this when the task or action associated with the reminder is done. Access: Free1 params
Mark a reminder as completed. Use this when the task or action associated with the reminder is done. Access: Free
Parameters* required
reminder_idstringID of the reminder to complete
reminders_dismissDismiss a reminder without completing it. Use this to remove a reminder that is no longer relevant. Access: Free1 params
Dismiss a reminder without completing it. Use this to remove a reminder that is no longer relevant. Access: Free
Parameters* required
reminder_idstringID of the reminder to dismiss
ContextStream MCP Server
Give your AI coding assistant brilliant memory, deep context, and superpowers it never had.
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.
Global Fallback Workspace (Unmapped Folders)
ContextStream now supports a catch-all mode for random folders (for example ~ or ad-hoc dirs) that are not associated with a project/workspace yet.
init(...)resolves normal folder mappings first (.contextstream/config.json, parent/global mappings).- If no mapping exists, it uses a single hidden global fallback workspace (
.contextstream-global) in workspace-only mode. - Context/memory/session tools continue to work without hard setup errors.
- Project-bound actions (for example
project(action="ingest_local")) return guided remediation to create/select a project instead of failing with a rawproject_id requirederror. - As soon as you enter a mapped project folder, that real workspace/project is prioritized and replaces fallback scope.
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, the easiest path is the hosted remote MCP with built-in OAuth. Marketplace installs should write this remote server definition automatically.
Hosted remote MCP (recommended)
{
"servers": {
"contextstream": {
"type": "http",
"url": "https://mcp.contextstream.io/mcp?default_context_mode=fast"
}
}
}
On first use, VS Code should prompt you to authorize ContextStream in the browser and then complete setup without an API key in the config file.
npx @contextstream/mcp-server@latest setup now defaults VS Code/Copilot to this hosted remote when you are using the production ContextStream cloud. To force a local runtime instead, run setup with CONTEXTSTREAM_VSCODE_MCP_MODE=local.
For self-hosted or non-default API deployments, local runtime remains the default:
Rust MCP (recommended)
{
"servers": {
"contextstream": {
"type": "stdio",
"command": "contextstream-mcp",
"args": [],
"env": {
"CONTEXTSTREAM_API_URL": "https://api.contextstream.io",
"CONTEXTSTREAM_API_KEY": "your_key",
"CONTEXTSTREAM_TOOLSET": "complete",
"CONTEXTSTREAM_TRANSCRIPTS_ENABLED": "true",
"CONTEXTSTREAM_HOOK_TRANSCRIPTS_ENABLED": "true",
"CONTEXTSTREAM_SEARCH_LIMIT": "15",
"CONTEXTSTREAM_SEARCH_MAX_CHARS": "2400"
}
}
}
}
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",
"CONTEXTSTREAM_TOOLSET": "complete",
"CONTEXTSTREAM_TRANSCRIPTS_ENABLED": "true",
"CONTEXTSTREAM_HOOK_TRANSCRIPTS_ENABLED": "true",
"CONTEXTSTREAM_SEARCH_LIMIT": "15",
"CONTEXTSTREAM_SEARCH_MAX_CHARS": "2400"
}
}
}
}
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",
"CONTEXTSTREAM_TOOLSET": "complete",
"CONTEXTSTREAM_TRANSCRIPTS_ENABLED": "true",
"CONTEXTSTREAM_HOOK_TRANSCRIPTS_ENABLED": "true",
"CONTEXTSTREAM_SEARCH_LIMIT": "15",
"CONTEXTSTREAM_SEARCH_MAX_CHARS": "2400"
}
}
}
}
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",
"CONTEXTSTREAM_TOOLSET": "complete",
"CONTEXTSTREAM_TRANSCRIPTS_ENABLED": "true",
"CONTEXTSTREAM_HOOK_TRANSCRIPTS_ENABLED": "true",
"CONTEXTSTREAM_SEARCH_LIMIT": "15",
"CONTEXTSTREAM_SEARCH_MAX_CHARS": "2400"
}
}
}
}
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-mcpas the command. - Node install: use
npx --prefer-online -y @contextstream/mcp-server@latestas the command. - Force local VS Code/Copilot setup with
CONTEXTSTREAM_VSCODE_MCP_MODE=local. - Force hosted remote VS Code/Copilot setup with
CONTEXTSTREAM_VSCODE_MCP_MODE=remote. - Use
mcpServersin Copilot CLI config andserversin VS Code config.
Quick Troubleshooting
- Remove duplicate ContextStream entries across Workspace/User config scopes.
- Check
CONTEXTSTREAM_API_URLandCONTEXTSTREAM_API_KEYare set. - Remove stale version pins like
@contextstream/mcp-server@0.3.xx. - Restart VS Code/Copilot after config changes.
Known Limitations
HTTP transport OAuth and vscode.dev dependency
The hosted HTTP MCP transport (https://mcp.contextstream.io/mcp) uses OAuth authentication that routes through vscode.dev for the redirect flow. This can fail in environments where vscode.dev is blocked (corporate networks, regional restrictions, CDN-level blocks).
Workaround: Use the stdio transport (Rust binary or Node.js) with API key authentication instead:
{
"contextstream": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@contextstream/mcp-server@latest"],
"env": {
"CONTEXTSTREAM_API_KEY": "your-api-key"
}
}
}
SDK version compatibility
@modelcontextprotocol/sdk versions 1.28.0 and above introduce breaking changes. The package.json pins the SDK to >=1.25.1 <1.28.0 to prevent incompatible resolutions. If you experience Zod schema errors on startup, ensure your SDK version is below 1.28.0.
Marketplace Note
The MCP marketplace entry now targets the hosted remote MCP at https://mcp.contextstream.io/mcp?default_context_mode=fast so VS Code can use the native OAuth flow instead of writing a local npm-based stdio config.
Use the Rust or Node local runtime configs above only when you explicitly want local execution, custom/self-hosted endpoints, or editor environments that do not support the hosted remote flow.
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.
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →Categories
Registryactive
Package@contextstream/mcp-server
TransportSTDIO
UpdatedJan 2, 2026
