AgentCortex MCP

AgentCortex MCP Client

🎯 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 - permissive license

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
A
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
62
Python
MIT License
Roo Code Memory Bank MCP Server
IncomeStreamSurfer
A
security
A
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
53
JavaScript
Apache 2.0
Memory MCP
HamzaFarhan
-
security
F
license
-
quality
A knowledge-graph-based memory system for AI agents that enables persistent information storage between conversations.
Last updated -
4
Python
Chroma MCP Server
djm81
-
security
F
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 -
16
Python

View all related MCP servers