@astramindapp/mcp-server

MIND MCP Server — The most complete AI memory layer available. 15 tools, 89 actions.

Your AI agents forget everything between sessions. MIND fixes that. Connect any MCP-compatible agent to your personal knowledge graph — with emotional intelligence, CRM, life management, social features, self-training, autonomous insights, and more.

15 Tools

Quick Start

1. Get a MIND API Key

Sign up at m-i-n-d.ai → Settings → Developer → Create API Key

2. Install

npm install -g @astramindapp/mcp-server

3. Configure Your AI Tool

Claude Code

claude mcp add mind -- env MIND_API_KEY=mind_xxx mind-mcp

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "mind": {
      "command": "mind-mcp",
      "env": {
        "MIND_API_KEY": "mind_your_key_here"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "mind": {
      "command": "mind-mcp",
      "env": {
        "MIND_API_KEY": "mind_your_key_here"
      }
    }
  }
}

Any MCP-Compatible Agent

The server works with any tool that supports Model Context Protocol — Claude, GPT, Gemini, Llama, or any future model.

How It Works

Your AI Agent  <-->  MCP Protocol  <-->  MIND MCP Server  <-->  Personal Knowledge Graph
                                                                  |
                                                           Emotional Intelligence
                                                           Autonomous Learning
                                                           CRM + Life + Social

1. Agent calls mind_context at session start → loads identity, rules, priorities
2. Agent calls mind_query before decisions → retrieves relevant memories
3. Agent calls mind_remember after tasks → stores outcomes and learnings
4. Agent calls mind_sense → reads user's emotional state to adapt responses
5. Agent calls mind_insights → surfaces autonomous pattern detection
6. Next session, any agent has full context. Knowledge compounds.

What Makes MIND Different

vs. Flat File Memory (MEMORY.md)

vs. Other MCP Memory Servers

Tool Reference

mind_query — Search Your Knowledge Graph

query: "What did I decide about the authentication approach?"
mode: "hybrid"  // hybrid (default), mix, global, local, naive

Returns an AI-synthesized answer from your stored documents, entries, and thoughts with source attribution.

mind_remember — Store & Manage Content

mind_context — Load Persistent Context

Loads five structured sections at session start:

• Soul — Core identity, mission, personality
• User — Who the user is, their role, preferences
• Rules — Operating constraints, behavioral guidelines
• Priorities — Current goals, active projects, deadlines
• Recent — Latest activity, outcomes, decisions

mind_life — Life Management + Calendar

mind_crm — Contact Relationship Management

mind_sense — MINDsense Emotional Intelligence

mind_research — Autonomous Research

mind_train — Self-Training

mind_social — Social Layer

mind_profile — Profile & Preferences

mind_insights — Autonomous Learning Engine

mind_automate — Automations

mind_notify — Notifications

mind_admin — Administration

Partner Integration

Partner apps can programmatically create MIND accounts using partner keys:

curl -X POST https://m-i-n-d.ai/admin/users/create \
  -H "X-API-Key: mind_partner_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "newuser",
    "email": "[email protected]",
    "password": "securepassword",
    "generate_api_key": true
  }'

Returns a JWT + permanent API key. Your app stores the API key and uses it for all subsequent MCP/API calls on behalf of that user.

Environment Variables

Programmatic Usage

import { createMindMcpServer, MindClient } from "@astramindapp/mcp-server";

const client = new MindClient({
  baseUrl: "https://m-i-n-d.ai",
  apiKey: "mind_xxx",
});

const server = createMindMcpServer(client);
// Connect to any MCP transport

Patents

MIND's technology is protected by multiple provisional patents including:

• Emotion-Weighted Knowledge Graph Encoding (U.S. App. 64/030,662)
• Cross-Agent Persistent Memory via Model Context Protocol

Links

• Website: m-i-n-d.ai
• GitHub: theastraway/mind-mcp-server
• npm: @astramindapp/mcp-server
• MCP Docs: m-i-n-d.ai/mcp.html

License

MIT — Astra AI, Inc.