@astramindapp/mcp-server

MIND MCP Server — Give any AI agent persistent memory.

Your AI agents forget everything between sessions. MIND fixes that. Connect any MCP-compatible tool to your personal knowledge graph and never lose context again.

What It Does

| Tool | Description | |------|-------------| | mind_query | Search your knowledge graph — returns only what's relevant | | mind_remember | Store anything — auto-categorized as document, entry, or thought | | mind_context | Load your persistent identity, preferences, rules, and priorities | | mind_life | Manage goals, projects, and tasks | | mind_crm | Track contacts and relationships | | mind_graph | Check graph health and statistics |

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 Desktop

Add to your claude_desktop_config.json:

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

Claude Code

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

OpenClaw

Add to your OpenClaw config:

{
  mcp: {
    servers: {
      mind: {
        command: "mind-mcp",
        env: { MIND_API_KEY: "mind_xxx" }
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json:

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

mind_admin — Partner User Provisioning

Admin-only operations. Requires an admin API key.

| Action | Description | |--------|-------------| | create_user | Provision a new MIND account (for partner app integration) | | list_users | List all users with analytics | | update_user_tier | Change a user's subscription tier | | adjust_user_credits | Add or deduct credits | | create_featured_mind | Create a public featured mind | | list_featured_minds | List featured minds catalog | | update_featured_mind | Update a featured mind |

Partner User Provisioning (create_user): Programmatically create MIND accounts when users sign up for your app. Returns a JWT for immediate auth.

username: "newuser123"
email: "[email protected]"
password: "securepassword"
source: "myapp"          # optional - tracks which partner app created the user
tier: "free"             # optional - free, starter, professional, business

Partner Keys

Partner keys are scoped credentials that can only provision new users — they cannot access any other admin endpoint. Create them from your admin account:

curl -X POST https://m-i-n-d.ai/admin/partner-keys \
  -H "X-API-Key: mind_YOUR_ADMIN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"partner_name": "mypartnerapp"}'

The response includes a mind_partner_... key. Give this to your partner developer — it's the only credential they need.

| Endpoint | Method | Description | |----------|--------|-------------| | /admin/partner-keys | POST | Create a partner key (admin-only) | | /admin/partner-keys | GET | List all partner keys (admin-only) | | /admin/partner-keys/{id} | DELETE | Revoke a partner key (admin-only) |

Admin REST API: User Provisioning

Partner apps create MIND accounts using their partner key (or admin key) via REST:

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

Note: When using a partner key, the source is automatically attached from the key's configuration. You can also use an admin key (mind_...) and pass source explicitly.

Response:

{
  "status": "success",
  "access_token": "eyJ...",
  "token_type": "bearer",
  "user": {
    "username": "newuser123",
    "email": "[email protected]",
    "workspace_id": "user_newuser123_a1b2c3d4",
    "tier": "free",
    "source": "myapp"
  }
}

| Field | Type | Required | Description | |-------|------|----------|-------------| | username | string | Yes | 3-30 chars, letters/numbers/underscores | | email | string | Yes | Valid email address | | password | string | Yes | 8-128 characters | | source | string | No | Your app/partner identifier | | tier | string | No | Subscription tier (default: free) |

This endpoint requires an admin API key. Unlike the public /register endpoint, it bypasses email uniqueness restrictions so partner apps can freely provision accounts.

How It Works

Your AI Agent ←→ MCP Protocol ←→ MIND MCP Server ←→ MIND Knowledge Graph

1. Agent calls mind_context at session start → gets identity, rules, priorities
2. Agent calls mind_query before decisions → gets relevant memories
3. Agent calls mind_remember after tasks → stores outcomes and learnings
4. Next session, same agent (or different one!) has full context

Your knowledge graph grows from every tool you use. What you learn in Claude Code is available in Cursor. What you decide in OpenClaw is remembered by Claude Desktop.

Why MIND vs. Flat File Memory

| | Flat files (MEMORY.md) | MIND | |---|---|---| | Size limit | ~20K chars, then truncated | Unlimited graph | | Retrieval | Loads everything every turn | Only relevant memories | | Capture | Manual (agent must write) | Automatic categorization | | Cross-agent | One tool only | Shared across all agents | | Structure | Unstructured text | Knowledge graph with entities & relationships | | Search | Keyword/vector on small file | Hybrid semantic + graph traversal |

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | MIND_API_KEY | Yes | — | Your MIND Developer API key | | MIND_BASE_URL | No | https://m-i-n-d.ai | MIND API base URL |

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

License

MIT — Astra AI