Skip to main content
Glama

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.

Related MCP server: Roo Code Memory Bank MCP Server

✨ 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

  1. Fork the repository

  2. Create a feature branch: git checkout -b feature/amazing-feature

  3. Add tests for new functionality

  4. Ensure TypeScript types are correct

  5. Test with multiple MCP clients

  6. Submit a Pull Request

🀝 Community & Support

πŸ† 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.

-
security - not tested
A
license - permissive license
-
quality - not tested

Resources

Looking for Admin?

Admins can modify the Dockerfile, update the server description, and track usage metrics. If you are the server author, to access the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/sage-hq/agentcortex-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server