trackmcp
Back to directory
sage-hq

agentcortex-mcp

View on GitHub

🧠 The first MCP-native memory system for AI coding assistants. Never lose context again.

4 stars TypeScriptAI & Machine Learning Updated Jul 16, 2025

Documentation

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

bash
# 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

bash
# 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:

json
{
  "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`:

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

Windsurf IDE

Add to your Windsurf configuration file:

json
{
  "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`:

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

bash
# 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

bash
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

bash
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

ToolWhat It DoesWhen To Use
Project Management
`create_project`Create new isolated project contextStarting work on a new codebase
`set_current_project`Switch between project contextsMoving between different repos
`get_current_project`Show active project infoConfirm which project you're in
`list_projects`List all your project contextsSee all your codebases
`get_project_context`Full project overview & summaryGet up to speed on a project
Memory Operations
`store_memory`Save important project informationRecord decisions, patterns, configs
`search_memory`Find memories with semantic search"What did we decide about...?"
`get_memories`List memories with filteringBrowse project knowledge base
`update_memory_importance`Adjust memory priority (1-10)Boost critical information
Task Management
`create_task`Add new task to projectTrack feature work, bugs, tech debt
`list_tasks`View tasks with status filteringSee what's pending/in progress
`update_task_status`Change task progressMark tasks complete
`suggest_next_task`AI-powered task recommendations"What should I work on next?"
`break_down_task`Split complex work into subtasksTurn PRDs into actionable steps

🎯 Advanced Usage Patterns

Team Workflows

bash
# 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

bash
# 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

VariableDescriptionRequiredDefault
`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:

json
{
  "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:

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

πŸ” Pricing

PlanPriceProjectsMemories/MonthTask ManagementSupport
DeveloperFree1 project1,000 memoriesBasicCommunity
Pro$29/moUnlimitedUnlimitedAdvancedPriority
Team$99/moUnlimitedUnlimitedCollaborationDedicated

All plans include:

  • βœ… Project context separation
  • βœ… Semantic search
  • βœ… 99.9% uptime SLA
  • βœ… Enterprise security
  • βœ… MCP protocol support

πŸ§ͺ Development & Contributing

bash
# 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?

bash
npx agentcortex

*Never lose context again. Start free today.*

Frequently asked questions

What is agentcortex-mcp?

agentcortex-mcp is 🧠 The first MCP-native memory system for AI coding assistants. Never lose context again.

How do I install agentcortex-mcp?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is agentcortex-mcp open source?

Yes β€” it is hosted on GitHub at https://github.com/sage-hq/agentcortex-mcp and has 4 stars.

Related MCP tools

Run your own MCP server? See who uses it and what to fix.

Measure it with TrackMCP