npm - @astramindapp/mcp-server - Versions diffs - 0.5.0 → 0.5.1 - Mend

@astramindapp/mcp-server 0.5.0 → 0.5.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (2) hide show

package/README.md +212 -139
package/package.json +1 -1

package/README.md CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@astramindapp/mcp-server",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "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.",
   "files": [
     "dist",