@astramindapp/mcp-server

MIND MCP Server — The most complete AI memory layer available. 31 tools, 208 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.

31 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

mind_focuses — Focus Buckets

mind_tasks — Site-Wide Tasks

mind_checklists — Task-Level Checklists

mind_folders — Document Folders

mind_folder_routes — System-Folder Routing

mind_folder_suggest — Folder Suggestion

Reads every folder's routing hint and uses a cheap LLM to pick the best match for a piece of content. Returns folder_id=null when nothing clearly applies.

mind_list_templates / mind_get_template / mind_save_typed / mind_bootstrap_templates — Front Layer Templates

Four tools for MIND's 16 Front Layer document types (SOUL, IDENTITY, BELIEFS, USER, AGENTS, TOOLS, SENSES, SKILLS, BEHAVIOR, LESSON, DECISION, POLICY, WORKFLOW, PREFERENCE, GOAL, RELATIONSHIP): list the types, fetch a template's full spec, save a filled document with the correct type tag, or seed all 16 templates into a new tenant.

mind_agents — Agent Command Center (admin-only)

Canonical registry of every Astra AI agent — status, current job, ownership/sharing (transfer_owner, share, list_shares, revoke_share), heartbeats, activity logs, and linked invoices/workflows. 25 actions.

mind_tickets — Agent Ticket Queue

mind_accounts — Multi-MIND Accounts

mind_social_analytics — Social Dashboard

YouTube/LinkedIn/X/Twitch channel stats, recent videos with performance, retention curves, traffic sources, comment sentiment, and goal progress.

mind_personas — Influencer Factory (admin-only)

Synthetic-persona creators that publish across Blotato platforms: persona CRUD, AI-generated or user-uploaded face anchors, image-to-image face variants, ElevenLabs voice library/cloning, per-platform bios, and Blotato account registration.

mind_osint — Ozzie (OSINT Analyst)

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": "user@app.com",
    "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, LLC.