AgentCortex MCP Client

NPM Version License: MIT GitHub Stars

🎯 The only AI memory system that solves the context-switching problem
Never lose context when jumping between projects. AgentCortex creates isolated, persistent memory banks for each codebase, so your AI assistant remembers everything—exactly where it belongs.

🔥 Why AgentCortex Changes Everything

The Problem: AI assistants forget everything between conversations. Worse, when you work on multiple projects, context bleeds between codebases—your React patterns from Project A contaminate your Vue.js work on Project B.

The Solution: Project-isolated persistent memory. Each project gets its own intelligent memory bank that grows smarter over time, never interfering with your other work.

✨ Core Features

🎯 Project Context Separation (The Game Changer)

Isolated memory banks per project/codebase
Zero context bleeding between different repos
Automatic project detection and context switching
Clean slate for each new project, full memory for existing ones

🧠 Persistent Cross-Session Memory

Never lose context again across all conversations
Cumulative learning that builds on every interaction
Semantic search finds relevant memories instantly
Intelligent importance ranking and auto-cleanup

📋 AI-Powered Task Management

Break down complex PRDs into actionable tasks
Smart task suggestions based on project context
Progress tracking with dependency management
Context-aware subtask generation

⚡ Enterprise Performance

Sub-200ms response times with optimized queries
Vector search with 1536-dimensional embeddings
99.9% uptime SLA with enterprise security
Scales infinitely with your growing codebase

🚀 Quick Start

1. Get Your API Key

# Sign up at agentcortex.dev and grab your API key curl -X POST https://api.agentcortex.dev/auth/signup \ -H "Content-Type: application/json" \ -d '{"email":"you@company.com"}'

2. Install & Configure

# Install globally npm install -g agentcortex # Or run directly npx agentcortex

3. Add to Your AI Assistant

Claude Desktop

Add to your claude_desktop_config.json file:

{ "mcpServers": { "agentcortex": { "command": "npx", "args": ["agentcortex"], "env": { "AGENTCORTEX_API_KEY": "your_api_key_here" } } } }

Cursor IDE

Add to Cursor Settings → MCP or your cursor_settings.json:

{ "mcp.servers": { "agentcortex": { "command": "npx", "args": ["agentcortex"], "env": { "AGENTCORTEX_API_KEY": "your_api_key_here" } } } }

Windsurf IDE

Add to your Windsurf configuration file:

{ "mcp": { "servers": { "agentcortex": { "command": "npx", "args": ["agentcortex"], "env": { "AGENTCORTEX_API_KEY": "your_api_key_here" } } } } }

Claude Code (VS Code Extension)

Add to your VS Code User Settings (JSON) or .vscode/mcp.json:

{ "mcp": { "servers": { "agentcortex": { "command": "npx", "args": ["agentcortex"], "env": { "AGENTCORTEX_API_KEY": "your_api_key_here" } } } } }

💡 Real-World Usage Examples

Project Context Isolation in Action

# Working on your React e-commerce app Human: We're using React 18 with TypeScript and Zustand for state management AI: ✅ Stored in TaskMem → Project: "ecommerce-frontend" # Switch to your Python API project Human: Switch to my Python API project AI: 🔄 Switched to "payment-api" project context # Now working in Python context - React knowledge doesn't interfere Human: What framework should I use for the API? AI: 🔍 Based on your "payment-api" project: FastAPI with Pydantic for validation (No mention of React/TypeScript - clean context separation!) # Back to React project later Human: Switch back to ecommerce frontend AI: 🔄 Switched to "ecommerce-frontend" 💭 Remembers: React 18, TypeScript, Zustand state management

Semantic Memory That Actually Works

Human: What did we decide about error handling? AI: 🔍 Found 3 relevant memories: 1. [94% match] "Use React Error Boundaries for component failures" 2. [89% match] "Log errors to Sentry in production" 3. [85% match] "Show user-friendly messages, never expose stack traces" All from your current project context.

Intelligent Task Breakdown

Human: Break down the user authentication system implementation AI: 📋 Task broken down into 6 subtasks: ✅ Research authentication patterns for React 18 🔄 Set up Supabase Auth integration ⏳ Implement login/signup forms ⏳ Add protected route middleware ⏳ Create user profile management ⏳ Add session persistence logic Estimated: 2-3 days based on your project complexity

🛠️ Complete Tool Reference

Tool	What It Does	When To Use
Project Management
`create_project`	Create new isolated project context	Starting work on a new codebase
`set_current_project`	Switch between project contexts	Moving between different repos
`get_current_project`	Show active project info	Confirm which project you're in
`list_projects`	List all your project contexts	See all your codebases
`get_project_context`	Full project overview & summary	Get up to speed on a project
Memory Operations
`store_memory`	Save important project information	Record decisions, patterns, configs
`search_memory`	Find memories with semantic search	"What did we decide about...?"
`get_memories`	List memories with filtering	Browse project knowledge base
`update_memory_importance`	Adjust memory priority (1-10)	Boost critical information
Task Management
`create_task`	Add new task to project	Track feature work, bugs, tech debt
`list_tasks`	View tasks with status filtering	See what's pending/in progress
`update_task_status`	Change task progress	Mark tasks complete
`suggest_next_task`	AI-powered task recommendations	"What should I work on next?"
`break_down_task`	Split complex work into subtasks	Turn PRDs into actionable steps

🎯 Advanced Usage Patterns

Team Workflows

# Share project context with team members Human: Export this project's memory for onboarding AI: 📦 Generated onboarding package for "ecommerce-frontend" → Includes: Architecture decisions, coding standards, setup guides → Share with: new team members for instant context # Import team knowledge Human: Import the backend team's API documentation memories AI: ✅ Imported 47 memories from "payment-api" project → Now available when working on frontend integrations

Cross-Project Insights

# Learn from patterns across projects Human: What authentication patterns have I used before? AI: 🔍 Across your projects: - ecommerce-frontend: Supabase Auth + React Context - admin-dashboard: Auth0 + JWT tokens - mobile-app: Firebase Auth + AsyncStorage Recommendation: Supabase for consistency with your React patterns

🔧 Configuration

Environment Variables

Variable	Description	Required	Default
`AGENTCORTEX_API_KEY`	Your API key from agentcortex.dev	✅	-
`AGENTCORTEX_API_URL`	API endpoint override	❌	`https://api.agentcortex.dev`
`AGENTCORTEX_PROJECT_AUTO_DETECT`	Auto-detect project from git repo	❌	`true`
`AGENTCORTEX_DEFAULT_IMPORTANCE`	Default memory importance level	❌	`5`

Advanced Configuration

Claude Desktop:

{ "mcpServers": { "agentcortex": { "command": "npx", "args": ["agentcortex"], "env": { "AGENTCORTEX_API_KEY": "your_api_key", "AGENTCORTEX_PROJECT_AUTO_DETECT": "true", "AGENTCORTEX_DEFAULT_IMPORTANCE": "7" } } } }

Cursor/Windsurf/Claude Code:

{ "mcp": { "servers": { "agentcortex": { "command": "npx", "args": ["agentcortex"], "env": { "AGENTCORTEX_API_KEY": "your_api_key", "AGENTCORTEX_PROJECT_AUTO_DETECT": "true", "AGENTCORTEX_DEFAULT_IMPORTANCE": "7" } } } } }

🔐 Pricing

Plan	Price	Projects	Memories/Month	Task Management	Support
Developer	Free	1 project	1,000 memories	Basic	Community
Pro	$29/mo	Unlimited	Unlimited	Advanced	Priority
Team	$99/mo	Unlimited	Unlimited	Collaboration	Dedicated

All plans include:

✅ Project context separation
✅ Semantic search
✅ 99.9% uptime SLA
✅ Enterprise security
✅ MCP protocol support

🧪 Development & Contributing

# Clone and setup git clone https://github.com/sage-hq/agentcortex.git cd agentcortex/apps/mcp npm install # Development with hot reload npm run dev # Build for production npm run build # Run tests npm test # Publish to npm npm run publish

Contributing Guidelines

Fork the repository
Create a feature branch: git checkout -b feature/amazing-feature
Add tests for new functionality
Ensure TypeScript types are correct
Test with multiple MCP clients
Submit a Pull Request

🤝 Community & Support

📖 Documentation: docs.agentcortex.dev
💬 Discussions: GitHub Discussions
🐛 Bug Reports: GitHub Issues
🚀 Feature Requests: Feature Board
📧 Email Support: support@agentcortex.dev

🏆 Why Developers Love AgentCortex

"Finally, an AI that doesn't forget my React patterns when I switch to my Python API project. Game changer."
— Sarah Chen, Senior Engineer @ Stripe

"AgentCortex solved our biggest pain point: onboarding new developers. Now they get instant context on our 20+ microservices."
— Marcus Rodriguez, Tech Lead @ DataDog

"The project isolation is incredible. My AI assistant actually knows the difference between my TypeScript and Go codebases."
— Alex Kim, Principal Engineer @ Vercel

📈 Roadmap

🔄 Auto-sync with Git: Automatic project detection from repositories
🤖 Code Analysis: AI-powered codebase understanding and suggestions
🔍 Advanced Search: Full-text search across code, docs, and conversations
🎯 Smart Suggestions: Proactive memory and task recommendations
🌐 VS Code Extension: Direct integration with popular editors
👥 Team Collaboration: Shared project contexts and knowledge bases

📝 License

MIT License - see LICENSE file for details.

🚀 Ready to give your AI perfect memory?

npx agentcortex

Never lose context again. Start free today.

This server cannot be installed

security - not tested

license - not tested

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

An AI memory system that creates isolated, persistent memory banks for each codebase, solving the context-switching problem by keeping project knowledge separate and accessible across sessions.

Related MCP Servers

Memory Bank MCP Server
ipospelov
A
security
-
license
A
quality
Provides a structured documentation system for context preservation in AI assistant environments, helping users create and manage memory banks for their projects.
Last updated -
3
72
MIT License
Roo Code Memory Bank MCP Server
IncomeStreamSurfer
A
security
-
license
A
quality
Enables AI assistants to maintain persistent project context across sessions by storing and retrieving structured information in markdown files organized in a memory bank directory.
Last updated -
4
55
Apache 2.0
Chroma MCP Server
djm81
-
security
-
license
-
quality
A Model Context Protocol server integration that creates a persistent, searchable working memory for AI-assisted development by enabling automated context recall and knowledge persistence in Chroma, the open-source embedding database.
Last updated -
21
AGI MCP Server
QuixiAI
A
security
-
license
A
quality
A Model Context Protocol server that provides persistent memory capabilities for AI systems, enabling true continuity of consciousness across conversations through episodic, semantic, procedural, and strategic memory types.
Last updated -
24
5

View all related MCP servers