{
  "markdown": "# @astramindapp/mcp-server\n\n**MIND MCP Server** — The most complete AI memory layer available. 31 tools, 208 actions.\n\nYour 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.\n\n## 31 Tools\n\n| Tool | Actions | What It Does |\n|------|---------|-------------|\n| `mind_query` | 1 | Semantic search across your knowledge graph (5 search modes) |\n| `mind_remember` | 5 | Store, search, get, list, delete — documents, entries, thoughts |\n| `mind_context` | 1 | Load persistent identity, preferences, rules, priorities, recent activity |\n| `mind_focuses` | 5 | Top-level Focus buckets that group Life projects |\n| `mind_life` | 16 | Focus → Project → Outcome hierarchy + calendar + cross-account sharing + stats |\n| `mind_tasks` | 9 | Assignable, completable, reportable work items on Life/CRM/agents or standalone |\n| `mind_checklists` | 9 | Task-level checklists — templates, phase-bucketed steps, completion tracking |\n| `mind_crm` | 7 | Contacts, pipeline, activity logging, interaction history |\n| `mind_graph` | 3 | Graph stats, diagnostics, entity labels |\n| `mind_admin` | 11 | User provisioning, Featured Minds Portal, tier/credit management (admin-only) |\n| `mind_sense` | 7 | MINDsense emotional intelligence — state, signals, timeline, KG weights, spikes |\n| `mind_research` | 3 | Launch and track autonomous deep research jobs |\n| `mind_train` | 7 | Self-training sessions + save chats to knowledge graph |\n| `mind_social` | 14 | Thoughts (posts), social feed, communities, likes, comments |\n| `mind_profile` | 9 | Profile, custom system prompts, LLM model selection |\n| `mind_insights` | 7 | Autonomous Learning Engine insights, weekly summaries, feedback |\n| `mind_automate` | 6 | Scheduled automations, event triggers, execution history |\n| `mind_notify` | 4 | Notifications, mark read, stats |\n| `mind_folders` | 7 | Organize documents into folders (a presentation layer over the graph) |\n| `mind_folder_routes` | 4 | Deterministic system-folder routing for auto-filed docs |\n| `mind_folder_suggest` | 1 | Ask MIND which folder a piece of content belongs in |\n| `mind_list_templates` | 1 | List the 16 MIND Front Layer template types |\n| `mind_get_template` | 1 | Fetch the full markdown spec for one Front Layer template |\n| `mind_save_typed` | 1 | Save a filled Front Layer document with its type tag |\n| `mind_bootstrap_templates` | 1 | Seed all 16 Front Layer templates into a tenant |\n| `mind_agents` | 25 | Admin-only Agent Command Center — registry, status, invoices, workflows |\n| `mind_tickets` | 7 | Agent ticket queue — file, triage, resolve client feedback/bugs |\n| `mind_accounts` | 6 | Manage multi-MIND accounts — list, create, delete, members, grant, invite |\n| `mind_social_analytics` | 6 | YouTube/LinkedIn/X/Twitch channel analytics from the Social Dashboard |\n| `mind_personas` | 17 | Influencer Factory Command Center — synthetic personas across Blotato platforms (admin-only) |\n| `mind_osint` | 7 | Operate Ozzie, the autonomous OSINT analyst — investigate targets, monitors, watchlists |\n\n## Quick Start\n\n### 1. Get a MIND API Key\n\nSign up at [m-i-n-d.ai](https://m-i-n-d.ai) → Settings → Developer → Create API Key\n\n### 2. Install\n\n```bash\nnpm install -g @astramindapp/mcp-server\n```\n\n### 3. Configure Your AI Tool\n\n#### Claude Code\n\n```bash\nclaude mcp add mind -- env MIND_API_KEY=mind_xxx mind-mcp\n```\n\n#### Claude Desktop\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"mind\": {\n      \"command\": \"mind-mcp\",\n      \"env\": {\n        \"MIND_API_KEY\": \"mind_your_key_here\"\n      }\n    }\n  }\n}\n```\n\n#### Cursor\n\nAdd to `.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"mind\": {\n      \"command\": \"mind-mcp\",\n      \"env\": {\n        \"MIND_API_KEY\": \"mind_your_key_here\"\n      }\n    }\n  }\n}\n```\n\n#### Any MCP-Compatible Agent\n\nThe server works with any tool that supports Model Context Protocol — Claude, GPT, Gemini, Llama, or any future model.\n\n## How It Works\n\n```\nYour AI Agent  <-->  MCP Protocol  <-->  MIND MCP Server  <-->  Personal Knowledge Graph\n                                                                  |\n                                                           Emotional Intelligence\n                                                           Autonomous Learning\n                                                           CRM + Life + Social\n```\n\n1. Agent calls `mind_context` at session start → loads identity, rules, priorities\n2. Agent calls `mind_query` before decisions → retrieves relevant memories\n3. Agent calls `mind_remember` after tasks → stores outcomes and learnings\n4. Agent calls `mind_sense` → reads user's emotional state to adapt responses\n5. Agent calls `mind_insights` → surfaces autonomous pattern detection\n6. Next session, any agent has full context. Knowledge compounds.\n\n## What Makes MIND Different\n\n### vs. Flat File Memory (MEMORY.md)\n\n| | Flat Files | MIND |\n|---|---|---|\n| Size | ~20K chars, truncated | Unlimited knowledge graph |\n| Retrieval | Loads everything every turn | Only relevant memories via semantic search |\n| Structure | Unstructured text | Graph with entities, relationships, and emotional weights |\n| Cross-agent | One tool only | Shared across all AI agents |\n| Intelligence | None | Autonomous pattern detection + emotional encoding |\n\n### vs. Other MCP Memory Servers\n\n| | Anthropic Official | Mem0 | Graphiti/Zep | MIND |\n|---|---|---|---|---|\n| Tools | 8 | 4 | 9 | **15** |\n| Knowledge graph | Basic (JSON) | No (vectors) | Yes (Neo4j) | **Yes (LightRAG)** |\n| Emotional intelligence | No | No | No | **Yes (patented)** |\n| CRM | No | No | No | **Yes** |\n| Life management | No | No | No | **Yes** |\n| Social features | No | No | No | **Yes** |\n| Self-training | No | No | No | **Yes** |\n| Research agent | No | No | No | **Yes** |\n| Automations | No | No | No | **Yes** |\n| Mobile app | No | No | No | **Yes** |\n\n## Tool Reference\n\n### `mind_query` — Search Your Knowledge Graph\n\n```\nquery: \"What did I decide about the authentication approach?\"\nmode: \"hybrid\"  // hybrid (default), mix, global, local, naive\n```\n\nReturns an AI-synthesized answer from your stored documents, entries, and thoughts with source attribution.\n\n### `mind_remember` — Store & Manage Content\n\n| Action | Description |\n|--------|-------------|\n| `create` | Store content (auto-categorized as document, entry, or thought) |\n| `delete` | Remove by ID |\n| `search` | Find entries/thoughts by query |\n| `get` | Retrieve specific item by ID |\n| `list` | Paginated listing of all content |\n\n### `mind_context` — Load Persistent Context\n\nLoads five structured sections at session start:\n- **Soul** — Core identity, mission, personality\n- **User** — Who the user is, their role, preferences\n- **Rules** — Operating constraints, behavioral guidelines\n- **Priorities** — Current goals, active projects, deadlines\n- **Recent** — Latest activity, outcomes, decisions\n\n### `mind_life` — Life Management + Calendar\n\n| Action | Description |\n|--------|-------------|\n| `list`, `create`, `update`, `complete`, `delete`, `move`, `get` | Full task/goal CRUD |\n| `calendar_list`, `calendar_create`, `calendar_update`, `calendar_delete` | Calendar events |\n| `stats` | Productivity metrics and completion rates |\n\n### `mind_crm` — Contact Relationship Management\n\n| Action | Description |\n|--------|-------------|\n| `list`, `create`, `update`, `delete`, `get` | Contact CRUD with pipeline stages |\n| `log_activity` | Record calls, emails, meetings, notes |\n| `list_activities` | View interaction history |\n\n### `mind_sense` — MINDsense Emotional Intelligence\n\n| Action | Description |\n|--------|-------------|\n| `state` | Current emotional state (valence, arousal, trend, sensitivity) |\n| `signals` | Recent emotional signals with strength and source |\n| `timeline` | Historical emotional data |\n| `kg_weights` | Entities weighted by emotional significance |\n| `spikes` | Detected emotional spikes |\n| `acknowledge` | Mark a spike as acknowledged |\n| `summary` | AI-generated emotional summary |\n\n### `mind_research` — Autonomous Research\n\n| Action | Description |\n|--------|-------------|\n| `start` | Launch a deep research job on any topic |\n| `status` | Check job progress |\n| `list` | View all research jobs |\n\n### `mind_train` — Self-Training\n\n| Action | Description |\n|--------|-------------|\n| `start` | Begin guided training (basics, network, expertise, history, goals, freeform) |\n| `chat` | Send training message |\n| `status`, `list_sessions`, `pause`, `resume` | Session management |\n| `save_chat` | Save any chat conversation into the knowledge graph |\n\n### `mind_social` — Social Layer\n\n| Action | Description |\n|--------|-------------|\n| `create_thought`, `get_thought`, `delete_thought`, `like_thought` | Thought (post) management |\n| `feed`, `user_feed`, `search_feed` | Social feed browsing |\n| `create_community`, `list_communities`, `get_community` | Community management |\n| `join_community`, `leave_community` | Membership |\n| `create_post`, `list_posts` | Community posts |\n\n### `mind_profile` — Profile & Preferences\n\n| Action | Description |\n|--------|-------------|\n| `get`, `update` | Profile management |\n| `get_chat_prompt`, `set_chat_prompt` | Custom chat system prompt |\n| `get_thought_prompt`, `set_thought_prompt` | Custom thought generation prompt |\n| `get_model`, `set_model`, `list_models` | LLM model selection (50+ models) |\n\n### `mind_insights` — Autonomous Learning Engine\n\n| Action | Description |\n|--------|-------------|\n| `list` | Recent pattern-detected insights |\n| `unread_count` | Count of unseen insights |\n| `view`, `feedback` | Mark seen, rate helpfulness |\n| `analyze` | Trigger on-demand analysis |\n| `weekly_summary` | Weekly intelligence summary |\n| `context` | ALE context data |\n\n### `mind_automate` — Automations\n\n| Action | Description |\n|--------|-------------|\n| `list`, `create`, `update`, `delete` | Automation CRUD |\n| `run_now` | Trigger immediately |\n| `history` | Execution log |\n\n### `mind_notify` — Notifications\n\n| Action | Description |\n|--------|-------------|\n| `list` | View all notifications |\n| `mark_read`, `mark_all_read` | Read management |\n| `stats` | Notification overview |\n\n### `mind_admin` — Administration\n\n| Action | Description |\n|--------|-------------|\n| `create_user` | Provision new MIND account |\n| `list_users` | List users with analytics |\n| `update_user_tier` | Change subscription tier |\n| `adjust_user_credits` | Add/deduct credits |\n| `create_featured_mind` | Create public featured mind |\n| `list_featured_minds`, `update_featured_mind` | Featured minds catalog |\n\n### `mind_focuses` — Focus Buckets\n\n| Action | Description |\n|--------|-------------|\n| `list`, `get` | View Focuses and their project counts |\n| `create`, `update`, `delete` | Maintain the top-level buckets that group Life projects |\n\n### `mind_tasks` — Site-Wide Tasks\n\n| Action | Description |\n|--------|-------------|\n| `list`, `create`, `get`, `update`, `delete` | Task CRUD — attach to a Life project, CRM contact, agent, or stand alone |\n| `complete`, `reopen` | Completion tracking |\n| `assign` | Assign to a MIND member, agent, or external email |\n| `reports` | Completion analytics |\n\n### `mind_checklists` — Task-Level Checklists\n\n| Action | Description |\n|--------|-------------|\n| `list_templates`, `get_template`, `create_template` | Reusable checklist blueprints (incl. global flagship templates) |\n| `list`, `create`, `get`, `delete` | Checklist runs attached to a task or Life item |\n| `toggle_item` | Check/uncheck a step |\n| `complete` | Finish a checklist and mirror it into the knowledge graph |\n\n### `mind_folders` — Document Folders\n\n| Action | Description |\n|--------|-------------|\n| `list`, `create`, `rename`, `delete` | Folder CRUD (a presentation layer — the graph still indexes across every document) |\n| `move`, `move_documents` | File documents into folders |\n| `set_hint` | Set the agent-routing hint read by `mind_folder_suggest` |\n\n### `mind_folder_routes` — System-Folder Routing\n\n| Action | Description |\n|--------|-------------|\n| `list`, `set`, `clear` | Configure which folder each kind of system-generated doc is filed into |\n| `apply_recommended` | Idempotent one-tap setup wiring every source type to a default folder |\n\n### `mind_folder_suggest` — Folder Suggestion\n\nReads 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.\n\n### `mind_list_templates` / `mind_get_template` / `mind_save_typed` / `mind_bootstrap_templates` — Front Layer Templates\n\nFour 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.\n\n### `mind_agents` — Agent Command Center (admin-only)\n\nCanonical 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.\n\n### `mind_tickets` — Agent Ticket Queue\n\n| Action | Description |\n|--------|-------------|\n| `list`, `get`, `create` | File and view client feedback, critiques, ideas, feature requests, and bugs on an agent |\n| `comment`, `update`, `resolve`, `delete` | Triage a ticket thread |\n\n### `mind_accounts` — Multi-MIND Accounts\n\n| Action | Description |\n|--------|-------------|\n| `list`, `create`, `delete` | Discover, spin up, or permanently remove a MIND account |\n| `members`, `grant`, `invite` | See who has access, grant it, or email an invitation |\n\n### `mind_social_analytics` — Social Dashboard\n\nYouTube/LinkedIn/X/Twitch channel stats, recent videos with performance, retention curves, traffic sources, comment sentiment, and goal progress.\n\n### `mind_personas` — Influencer Factory (admin-only)\n\nSynthetic-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.\n\n### `mind_osint` — Ozzie (OSINT Analyst)\n\n| Action | Description |\n|--------|-------------|\n| `investigate` | Get a cited intelligence dossier on a domain, IP, org, or person |\n| `add_monitor`, `list_monitors`, `remove_monitor` | Natural-language live-feed alerts |\n| `add_watchlist`, `list_watchlist`, `remove_watchlist` | Watchlist management |\n\n## Partner Integration\n\nPartner apps can programmatically create MIND accounts using partner keys:\n\n```bash\ncurl -X POST https://m-i-n-d.ai/admin/users/create \\\n  -H \"X-API-Key: mind_partner_YOUR_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"username\": \"newuser\",\n    \"email\": \"user@app.com\",\n    \"password\": \"securepassword\",\n    \"generate_api_key\": true\n  }'\n```\n\nReturns 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.\n\n## Environment Variables\n\n| Variable | Required | Default | Description |\n|----------|----------|---------|-------------|\n| `MIND_API_KEY` | Yes | — | Your MIND Developer API key |\n| `MIND_BASE_URL` | No | `https://m-i-n-d.ai` | MIND API base URL |\n\n## Programmatic Usage\n\n```typescript\nimport { createMindMcpServer, MindClient } from \"@astramindapp/mcp-server\";\n\nconst client = new MindClient({\n  baseUrl: \"https://m-i-n-d.ai\",\n  apiKey: \"mind_xxx\",\n});\n\nconst server = createMindMcpServer(client);\n// Connect to any MCP transport\n```\n\n## Patents\n\nMIND's technology is protected by multiple provisional patents including:\n- Emotion-Weighted Knowledge Graph Encoding (U.S. App. 64/030,662)\n- Cross-Agent Persistent Memory via Model Context Protocol\n\n## Links\n\n- **Website**: [m-i-n-d.ai](https://m-i-n-d.ai)\n- **GitHub**: [theastraway/mind-mcp-server](https://github.com/theastraway/mind-mcp-server)\n- **npm**: [@astramindapp/mcp-server](https://www.npmjs.com/package/@astramindapp/mcp-server)\n- **MCP Docs**: [m-i-n-d.ai/mcp.html](https://www.m-i-n-d.ai/mcp.html)\n\n## License\n\nMIT — Astra AI, LLC.\n",
  "bytes": 16345,
  "sha": "af4e61b13fbf419cd6bf0e78442323a3155460b72215604bbf5262a1bf4982a1",
  "repo_slug": "theastraway/mind-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_theastraway_mind_fd9bcbe2/readme"
}