@astramindapp/mcp-server 0.5.0 → 0.5.2

package/README.md

@@ -1,19 +1,28 @@
 # @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 |
+**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
+
+| Tool | Actions | What It Does |
+|------|---------|-------------|
+| `mind_query` | 1 | Semantic search across your knowledge graph (5 search modes) |
+| `mind_remember` | 5 | Store, search, get, list, delete — documents, entries, thoughts |
+| `mind_context` | 1 | Load persistent identity, preferences, rules, priorities, recent activity |
+| `mind_life` | 12 | Goals, projects, tasks + full calendar management + productivity stats |
+| `mind_crm` | 7 | Contacts, pipeline, activity logging, interaction history |
+| `mind_graph` | 3 | Graph stats, diagnostics, entity labels |
+| `mind_admin` | 7 | User provisioning, featured minds, tier/credit management |
+| `mind_sense` | 7 | MINDsense emotional intelligence — state, signals, timeline, KG weights, spikes |
+| `mind_research` | 3 | Launch autonomous deep research jobs |
+| `mind_train` | 7 | Self-training sessions + save chats to knowledge graph |
+| `mind_social` | 14 | Thoughts (posts), social feed, communities, likes, comments |
+| `mind_profile` | 9 | Profile, custom system prompts, LLM model selection |
+| `mind_insights` | 7 | Autonomous Learning Engine insights, weekly summaries, feedback |
+| `mind_automate` | 6 | Scheduled automations, event triggers, execution history |
+| `mind_notify` | 4 | Notifications, mark read, stats |
 
 ## Quick Start
 
@@ -29,6 +38,12 @@ npm install -g @astramindapp/mcp-server
 
 ### 3. Configure Your AI Tool
 
+#### Claude Code
+
+```bash
+claude mcp add mind -- env MIND_API_KEY=mind_xxx mind-mcp
+```
+
 #### Claude Desktop
 
 Add to your `claude_desktop_config.json`:
@@ -46,29 +61,6 @@ Add to your `claude_desktop_config.json`:
 }
 ```
 
-#### Claude Code
-
-```bash
-claude mcp add mind -- env MIND_API_KEY=mind_xxx mind-mcp
-```
-
-#### OpenClaw
-
-Add to your OpenClaw config:
-
-```json5
-{
-  mcp: {
-    servers: {
-      mind: {
-        command: "mind-mcp",
-        env: { MIND_API_KEY: "mind_xxx" }
-      }
-    }
-  }
-}
-```
-
 #### Cursor
 
 Add to `.cursor/mcp.json`:
@@ -86,133 +78,203 @@ Add to `.cursor/mcp.json`:
 }
 ```
 
-### `mind_admin` — Partner User Provisioning
+#### Any MCP-Compatible Agent
 
-Admin-only operations. Requires an admin API key.
+The server works with any tool that supports Model Context Protocol — Claude, GPT, Gemini, Llama, or any future model.
 
-| 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 and optionally a long-lived developer API key.
+## How It Works
 
 ```
-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
-generate_api_key: true       # optional - generates a permanent API key (mind_...) for this user
-api_key_name: "myapp"        # optional - display name for the API key
+Your AI Agent  <-->  MCP Protocol  <-->  MIND MCP Server  <-->  Personal Knowledge Graph
+                                                                  |
+                                                           Emotional Intelligence
+                                                           Autonomous Learning
+                                                           CRM + Life + Social
 ```
 
-> Set `generate_api_key: true` to get a permanent API key in the response — your app stores it and uses it for all subsequent MIND API calls on behalf of this user.
+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.
 
-## Partner Keys
+## What Makes MIND Different
 
-Partner keys are scoped credentials that can **only** provision new users — they cannot access any other admin endpoint. Create them from your admin account:
+### vs. Flat File Memory (MEMORY.md)
+
+| | Flat Files | MIND |
+|---|---|---|
+| Size | ~20K chars, truncated | Unlimited knowledge graph |
+| Retrieval | Loads everything every turn | Only relevant memories via semantic search |
+| Structure | Unstructured text | Graph with entities, relationships, and emotional weights |
+| Cross-agent | One tool only | Shared across all AI agents |
+| Intelligence | None | Autonomous pattern detection + emotional encoding |
+
+### vs. Other MCP Memory Servers
+
+| | Anthropic Official | Mem0 | Graphiti/Zep | MIND |
+|---|---|---|---|---|
+| Tools | 8 | 4 | 9 | **15** |
+| Knowledge graph | Basic (JSON) | No (vectors) | Yes (Neo4j) | **Yes (LightRAG)** |
+| Emotional intelligence | No | No | No | **Yes (patented)** |
+| CRM | No | No | No | **Yes** |
+| Life management | No | No | No | **Yes** |
+| Social features | No | No | No | **Yes** |
+| Self-training | No | No | No | **Yes** |
+| Research agent | No | No | No | **Yes** |
+| Automations | No | No | No | **Yes** |
+| Mobile app | No | No | No | **Yes** |
+
+## Tool Reference
+
+### `mind_query` — Search Your Knowledge Graph
 
-```bash
-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"}'
+```
+query: "What did I decide about the authentication approach?"
+mode: "hybrid"  // hybrid (default), mix, global, local, naive
 ```
 
-The response includes a `mind_partner_...` key. Give this to your partner developer — it's the only credential they need.
+Returns an AI-synthesized answer from your stored documents, entries, and thoughts with source attribution.
 
-| 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) |
+### `mind_remember` — Store & Manage Content
 
-## Admin REST API: User Provisioning
+| Action | Description |
+|--------|-------------|
+| `create` | Store content (auto-categorized as document, entry, or thought) |
+| `delete` | Remove by ID |
+| `search` | Find entries/thoughts by query |
+| `get` | Retrieve specific item by ID |
+| `list` | Paginated listing of all content |
 
-Partner apps create MIND accounts using their partner key (or admin key) via REST:
+### `mind_context` — Load Persistent Context
 
-```bash
-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": "user@partnerapp.com",
-    "password": "securepassword",
-    "tier": "free",
-    "generate_api_key": true,
-    "api_key_name": "myapp integration"
-  }'
-```
+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
 
-> When using a partner key, the `source` is automatically attached from the key's configuration. Set `generate_api_key: true` to get a permanent developer API key in the same response — no second call needed.
+### `mind_life` — Life Management + Calendar
 
-**Response:**
-```json
-{
-  "status": "success",
-  "access_token": "eyJ...",
-  "token_type": "bearer",
-  "user": {
-    "username": "newuser123",
-    "email": "user@partnerapp.com",
-    "workspace_id": "user_newuser123_a1b2c3d4",
-    "tier": "free",
-    "source": "myapp"
-  },
-  "api_key": {
-    "id": "uuid",
-    "name": "myapp integration",
-    "key": "mind_aBcDeFgH...",
-    "prefix": "mind_aBcDeFg",
-    "scopes": ["query", "documents:read", "documents:write", "...all 19 scopes"]
-  }
-}
-```
+| Action | Description |
+|--------|-------------|
+| `list`, `create`, `update`, `complete`, `delete`, `move`, `get` | Full task/goal CRUD |
+| `calendar_list`, `calendar_create`, `calendar_update`, `calendar_delete` | Calendar events |
+| `stats` | Productivity metrics and completion rates |
 
-| 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`) |
-| `generate_api_key` | boolean | No | Generate a permanent API key for this user (default: `false`) |
-| `api_key_name` | string | No | Display name for the API key |
+### `mind_crm` — Contact Relationship Management
 
-The `api_key.key` is a permanent developer key (no expiry) — store it and use it for all `/developer/v1/...` calls on behalf of this user. The `access_token` (JWT) expires in 48 hours.
+| Action | Description |
+|--------|-------------|
+| `list`, `create`, `update`, `delete`, `get` | Contact CRUD with pipeline stages |
+| `log_activity` | Record calls, emails, meetings, notes |
+| `list_activities` | View interaction history |
 
-This endpoint accepts either a **partner key** or an **admin API key**. Unlike the public `/register` endpoint, it bypasses email uniqueness restrictions so partner apps can freely provision accounts.
+### `mind_sense` — MINDsense Emotional Intelligence
 
-## How It Works
+| Action | Description |
+|--------|-------------|
+| `state` | Current emotional state (valence, arousal, trend, sensitivity) |
+| `signals` | Recent emotional signals with strength and source |
+| `timeline` | Historical emotional data |
+| `kg_weights` | Entities weighted by emotional significance |
+| `spikes` | Detected emotional spikes |
+| `acknowledge` | Mark a spike as acknowledged |
+| `summary` | AI-generated emotional summary |
 
-```
-Your AI Agent ←→ MCP Protocol ←→ MIND MCP Server ←→ MIND Knowledge Graph
-```
+### `mind_research` — Autonomous Research
 
-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
+| Action | Description |
+|--------|-------------|
+| `start` | Launch a deep research job on any topic |
+| `status` | Check job progress |
+| `list` | View all research jobs |
+
+### `mind_train` — Self-Training
 
-**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.
+| Action | Description |
+|--------|-------------|
+| `start` | Begin guided training (basics, network, expertise, history, goals, freeform) |
+| `chat` | Send training message |
+| `status`, `list_sessions`, `pause`, `resume` | Session management |
+| `save_chat` | Save any chat conversation into the knowledge graph |
 
-## Why MIND vs. Flat File Memory
+### `mind_social` — Social Layer
 
-| | 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 |
+| Action | Description |
+|--------|-------------|
+| `create_thought`, `get_thought`, `delete_thought`, `like_thought` | Thought (post) management |
+| `feed`, `user_feed`, `search_feed` | Social feed browsing |
+| `create_community`, `list_communities`, `get_community` | Community management |
+| `join_community`, `leave_community` | Membership |
+| `create_post`, `list_posts` | Community posts |
+
+### `mind_profile` — Profile & Preferences
+
+| Action | Description |
+|--------|-------------|
+| `get`, `update` | Profile management |
+| `get_chat_prompt`, `set_chat_prompt` | Custom chat system prompt |
+| `get_thought_prompt`, `set_thought_prompt` | Custom thought generation prompt |
+| `get_model`, `set_model`, `list_models` | LLM model selection (50+ models) |
+
+### `mind_insights` — Autonomous Learning Engine
+
+| Action | Description |
+|--------|-------------|
+| `list` | Recent pattern-detected insights |
+| `unread_count` | Count of unseen insights |
+| `view`, `feedback` | Mark seen, rate helpfulness |
+| `analyze` | Trigger on-demand analysis |
+| `weekly_summary` | Weekly intelligence summary |
+| `context` | ALE context data |
+
+### `mind_automate` — Automations
+
+| Action | Description |
+|--------|-------------|
+| `list`, `create`, `update`, `delete` | Automation CRUD |
+| `run_now` | Trigger immediately |
+| `history` | Execution log |
+
+### `mind_notify` — Notifications
+
+| Action | Description |
+|--------|-------------|
+| `list` | View all notifications |
+| `mark_read`, `mark_all_read` | Read management |
+| `stats` | Notification overview |
+
+### `mind_admin` — Administration
+
+| Action | Description |
+|--------|-------------|
+| `create_user` | Provision new MIND account |
+| `list_users` | List users with analytics |
+| `update_user_tier` | Change subscription tier |
+| `adjust_user_credits` | Add/deduct credits |
+| `create_featured_mind` | Create public featured mind |
+| `list_featured_minds`, `update_featured_mind` | Featured minds catalog |
+
+## Partner Integration
+
+Partner apps can programmatically create MIND accounts using partner keys:
+
+```bash
+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
 
@@ -235,6 +297,17 @@ 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](https://m-i-n-d.ai)
+- **npm**: [@astramindapp/mcp-server](https://www.npmjs.com/package/@astramindapp/mcp-server)
+
 ## License
 
-MIT — Astra AI
+MIT — Astrai AI, Inc.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@astramindapp/mcp-server",
-  "version": "0.5.0",
-  "description": "MIND MCP Server — Universal AI memory layer. Give any LLM agent persistent memory, structured context, and automatic knowledge capture via the Model Context Protocol.",
+  "version": "0.5.2",
+  "description": "MIND MCP Server — 15 tools, 89 actions. The most complete AI memory layer. Personal knowledge graph with emotional intelligence, CRM, life management, social, self-training, research agent, automations. Works with Claude, GPT, Gemini.",
   "files": [
     "dist",
     "README.md"
@@ -26,7 +26,19 @@
     "knowledge-graph",
     "llm",
     "mind",
-    "mindapp"
+    "claude",
+    "claude-code",
+    "claude-desktop",
+    "cursor",
+    "ai-agent",
+    "persistent-memory",
+    "emotional-intelligence",
+    "crm",
+    "personal-ai",
+    "rag",
+    "mcp-server",
+    "ai-tools",
+    "knowledge-management"
   ],
   "author": "Astra AI <hello@theastraway.com>",
   "license": "MIT",