Package Exports

@astramindapp/mcp-server
@astramindapp/mcp-server/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@astramindapp/mcp-server) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

@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

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: "user@partnerapp.com"
password: "securepassword"
source: "myapp"          # optional - tracks which partner app created the user
tier: "free"             # optional - free, starter, professional, business

Admin REST API: User Provisioning

Partner apps can also create MIND accounts directly via REST:

curl -X POST https://m-i-n-d.ai/admin/users/create \
  -H "X-API-Key: mind_YOUR_ADMIN_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "newuser123",
    "email": "user@partnerapp.com",
    "password": "securepassword",
    "source": "myapp",
    "tier": "free"
  }'

Response:

{
  "status": "success",
  "access_token": "eyJ...",
  "token_type": "bearer",
  "user": {
    "username": "newuser123",
    "email": "user@partnerapp.com",
    "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

Agent calls mind_context at session start → gets identity, rules, priorities
Agent calls mind_query before decisions → gets relevant memories
Agent calls mind_remember after tasks → stores outcomes and learnings
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