MIND MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MIND MCP Serversearch my knowledge graph for notes on authentication"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@astramindapp/mcp-server
MIND MCP Server — The most complete AI memory layer available. 44 tools, 384 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, site-wide assignable tasks, social features, self-training, autonomous insights, an admin-only Agent Command Center with per-agent ticket queues, an admin-only Featured Minds Portal (curate the public marketplace at m-i-n-d.ai from any MCP client — model, public chat prompt, temperature, brand fields, write-through to the linked user's profile), and more.
Self-describing. Every connecting client receives a full integration briefing in the MCP initialize response, and can read the complete playbook from the mind://integration-guide resource — so any agent knows what MIND is, which integration path fits its runtime (MCP server / OpenClaw plugin / REST API), how to authenticate, and the session protocol, without being told.
44 Tools
Tool | Actions | What It Does |
| 1 | Semantic search across your knowledge graph (5 search modes) |
| 5 | Store, search, get, list, delete — |
| 7 | Organize documents into folders — list, create, rename, move, delete, file documents |
| 4 | Configure deterministic system-folder routing — which folder each kind of system-generated doc (life items, CRM, chat saves, tasks, training, trader signals, cloud imports) is filed into automatically |
| 1 | Ask MIND which folder a piece of content belongs in, via its routing_hint + a cheap LLM picker |
| 4 | Create and manage share links for one MIND document — create (default), list, list_all, revoke |
| 1 | Load persistent identity, preferences, rules, priorities, recent activity |
| 16 | Goals, projects, tasks + full calendar management + productivity stats |
| 5 | Focus → Project buckets — the top-level groupings above Life Projects |
| 7 | Contacts, pipeline, activity logging, interaction history |
| 9 | Site-wide tasks — assignable, completable work items on projects, contacts, or agents, plus completion reports |
| 3 | Graph stats, diagnostics, entity labels |
| 11 | Admin-only. User provisioning + the Featured Minds Portal: full CRUD over the public marketplace (get_full / update / update_owner_profile / reorder / delete), tier/credit management |
| 7 | MINDsense emotional intelligence — state, signals, timeline, KG weights, spikes |
| 7 | Operate Ozzie — the autonomous OSINT analyst — for cited intelligence dossiers on a domain/IP/org/person, plus live-feed alerts and watchlists |
| 3 | Launch autonomous deep research jobs |
| 7 | Self-training sessions + save chats to knowledge graph |
| 14 | Public feed posts, social feed, communities, likes, comments — ⚠️ posting writes to the user's PUBLIC feed, only call on explicit user request |
| 6 | YouTube/LinkedIn/X/Twitch channel stats, recent video performance, retention/traffic/sentiment, goal progress |
| 9 | Profile, custom system prompts, LLM model selection |
| 25 | TraderMIND — the agentic trading engine: live feed, MIND Vision forecasts (latest cone + resolved history + per-bar scores), candles, cycles, calibration honesty curve, engine health, save/star/like + undo, notes + structured feedback the engine learns from, full trading-journal CRUD, personalized insights. Engine reads + counts are public (work even with no/invalid key); only the act-as-you actions authenticate as the key's owner |
| 7 | Autonomous Learning Engine insights, weekly summaries, feedback |
| 6 | Scheduled automations, event triggers, execution history |
| 4 | Notifications, mark read, stats |
| 25 | Admin-only. Agent Command Center — list/search/get/create/update/delete agents, heartbeats, probes, activity log, import from MIND, seed canonical fleet, link invoices, transfer ownership + share agents with other accounts |
| 7 | Admin-only. Agent ticket queue — file, view, answer (comment), triage, resolve, and delete client feedback / bugs / ideas on any agent |
| 17 | Admin-only. Influencer Factory Command Center — synthetic-persona CRUD, face anchor + variants, ElevenLabs voice, per-platform bios, Blotato account registration |
| 6 | Multi-MIND accounts — list MINDs you can access, create new ones, delete MINDs you own, manage owners/viewers, send email invitations |
| 1 | List the 16 Front Layer typed-document templates |
| 1 | Fetch the full spec for one Front Layer template |
| 1 | Save a filled-out Front Layer document with its type tag |
| 1 | Seed all 16 Front Layer templates into a MIND tenant |
| 6 | MIND Mind Map (m-i-n-d.ai/#/mind-map) — visual canvases: list/get/create/update/delete, read a public shared map. Sharing, collaborators and AI generation from a prompt/project stay in the web app (JWT-only, human-only) |
| 37 | MoneyMIND (m-i-n-d.ai/#/moneyMIND) — accounts, transactions + splits + rules, budgets, recurring bills, net worth, savings goals, credit, alerts, bill negotiation, bank statements |
| 19 | 13-week cash-flow planner (m-i-n-d.ai/#/budget) — cells, rows, quarters, variance, roll-forward, autofill/build from bank statements |
| 14 | Airtable-style tables (m-i-n-d.ai/#/sheets) — tables, columns, rows, CSV export |
| 14 | MIND Email Manager (m-i-n-d.ai/#/email) — inbox, threads, search, AI draft, ⚠️ send (outward), voice/tone preferences |
| 13 | Kanon checklists (kanon.theastraway.com) attached to Life items or tasks — templates, runs, toggle_item, progress rollups |
| 12 | MIND Sign e-signature (m-i-n-d.ai/#/mindsign) — envelopes, fields, ⚠️ send/resend (outward), void, audit, certificate |
| 9 | Invoice Agent (m-i-n-d.ai/#/invoiceagent) — create/update, ask a question about an invoice, ⚠️ invite (outward), received invoices |
| 9 | MIND Books accounting (m-i-n-d.ai/#/mind-books) — vendors, customers, chart of accounts, bills, invoices overview |
| 8 | Tempo time tracking — start/stop, manual entries, summaries |
| 7 | Quill lead-capture forms (m-i-n-d.ai/#/forms) — build, read submissions, public read by slug |
| 8 | Personal bookshelf (m-i-n-d.ai/#/library) — authors, books, chapter content, AI reading companion |
Related MCP server: Memsolus MCP Server
Quick Start
Fastest: one-paste remote connect (Claude Code / Claude Desktop / claude.ai)
No install, no API key handling — paste one command, click Connect in the browser, done:
claude mcp add --transport http mind https://www.m-i-n-d.ai/mcpClaude opens the m-i-n-d.ai consent page, you click Connect, and MIND is live. Auth, key minting, and refresh are all handled by OAuth.
No browser OAuth in your host? Use a key on the same URL
Every host that lets you add a custom MCP server with a header can use MIND with no OAuth and no npm install: same remote server URL, just swap in a key.
Server URL:
https://www.m-i-n-d.ai/mcpHeader:
Authorization: Bearer mind_<your key>Mint a key: https://www.m-i-n-d.ai → Settings → Developer → API Keys
Agents: if AuthenticateMcpServer or the host's connect card fails, ask the
user for a MIND API key and rewire the same URL with that header — do not
fall back to the local npm server just because OAuth didn't work.
Local stdio install: browser-connect setup wizard
For tools that run MCP servers locally (Claude Desktop, Cursor, Windsurf, VS Code Copilot), run the setup wizard — it opens your browser, you click Connect on m-i-n-d.ai, and it receives your API key automatically and writes every tool config for you:
npx -y --package=@astramindapp/mcp-server mind-mcp-setupNo manual key copying. The wizard auto-detects your installed AI tools and configures each one.
Manual alternative: paste an API key
If you'd rather mint a key yourself: sign up at www.m-i-n-d.ai → Settings → Developer → Create API Key, then:
npx -y --package=@astramindapp/mcp-server mind-mcp-setup --key mind_xxxor install globally and configure by hand:
npm install -g @astramindapp/mcp-serverClaude Code (local stdio with a manual key)
claude mcp add mind -- env MIND_API_KEY=mind_xxx mind-mcpClaude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"mind": {
"command": "mind-mcp",
"env": {
"MIND_API_KEY": "mind_your_key_here"
}
}
}
}The config file lives at ~/Library/Application Support/Claude/claude_desktop_config.json
on macOS, or %APPDATA%\Claude\claude_desktop_config.json on Windows. Fully quit and
reopen Claude Desktop after editing — it only reads this file on launch.
Cursor
Add to .cursor/mcp.json:
{
"mcpServers": {
"mind": {
"command": "mind-mcp",
"env": {
"MIND_API_KEY": "mind_your_key_here"
}
}
}
}Any MCP-Compatible Agent
The server works with any tool that supports Model Context Protocol — Claude, GPT, Gemini, Llama, or any future model.
How It Works
Your AI Agent <--> MCP Protocol <--> MIND MCP Server <--> Personal Knowledge Graph
|
Emotional Intelligence
Autonomous Learning
CRM + Life + SocialAgent calls
mind_contextat session start → loads identity, rules, prioritiesAgent calls
mind_querybefore decisions → retrieves relevant memoriesAgent calls
mind_rememberafter tasks → stores outcomes and learningsAgent calls
mind_sense→ reads user's emotional state to adapt responsesAgent calls
mind_insights→ surfaces autonomous pattern detectionNext session, any agent has full context. Knowledge compounds.
What Makes MIND Different
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 | 24 |
Knowledge graph | Basic (JSON) | No (vectors) | Yes (Neo4j) | Yes (per-user MIND graph) |
Emotional intelligence | No | No | No | Yes (patent-pending) |
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
query: "What did I decide about the authentication approach?"
mode: "hybrid" // hybrid (default), mix, global, local, naiveReturns RETRIEVED CONTEXT from your stored documents, entries, and feed posts with source attribution — raw graph context for the calling model to synthesize, not a finished answer. Uses no MIND LLM and costs 0 credits. Pass retrieve_only=false for a MIND-written answer (spends credits).
mind_remember — Store & Manage Content
Action | Description |
| Store content. PRIVATE: |
| Remove by ID |
| Find entries / feed posts by query |
| Retrieve specific item by ID |
| Paginated listing of all content |
mind_folders — Organize Documents into Folders
Folders are a presentation layer over the document tray — the knowledge graph still indexes and retrieves across every document regardless of folder.
Action | Description |
| All folders, each with its document count |
| Create a folder (optionally nested under a parent) |
| Change a folder's name |
| Re-nest a folder under a different parent |
| Remove a folder — its documents and subfolders move up a level; nothing is deleted |
| File one or more documents into a folder |
mind_context — Load Persistent Context
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
mind_life — Life Management + Calendar
Action | Description |
| Full task/goal CRUD |
| Delete up to 200 life items in one call ( |
| Calendar events |
| Productivity metrics and completion rates |
mind_crm — Contact Relationship Management
Action | Description |
| Contact CRUD with pipeline stages |
| Record calls, emails, meetings, notes |
| View interaction history |
mind_tasks — Site-Wide Tasks
Assignable, completable, reportable work items. A task can attach to a Life
project (parent_type: "life_item"), a CRM contact ("contact"), an agent
("agent"), or stand alone. Assign tasks to a MIND member, an agent, or an
external email address.
Action | Description |
| List/filter tasks by status, priority, parent, assignee, or overdue |
| Create a task — attach to a project/contact/agent, assign, set a due date |
| Task CRUD |
| Mark a task done or reopen it |
| (Re)assign to a member/agent/external; optionally fire the agent |
| Completion analytics — counts, overdue, by-assignee, 8-week throughput |
mind_tasks({ action: "create", title: "Follow up with Acme",
parent_type: "contact", parent_id: "<contact_id>",
assignee_type: "agent", assignee_id: "fundraising-agent",
dispatch_agent: true, due_date: "2026-06-01" })
mind_tasks({ action: "reports" })mind_sense — MINDsense Emotional Intelligence
Action | Description |
| Current emotional state (valence, arousal, trend, sensitivity) |
| Recent emotional signals with strength and source |
| Historical emotional data |
| Entities weighted by emotional significance |
| Detected emotional spikes |
| Mark a spike as acknowledged |
| AI-generated emotional summary |
mind_research — Autonomous Research
Action | Description |
| Launch a deep research job on any topic |
| Check job progress |
| View all research jobs |
mind_train — Self-Training
Action | Description |
| Begin guided training (basics, network, expertise, history, goals, freeform) |
| Send training message |
| Session management |
| Save any chat conversation into the knowledge graph |
mind_social — Social Layer
Action | Description |
| Public feed post management — ⚠️ |
| Social feed browsing |
| Community management |
| Membership |
| Community posts |
mind_profile — Profile & Preferences
Action | Description |
| Profile management |
| Custom chat system prompt |
| Custom feed-post generation prompt (used when the user asks MIND to draft a post) |
| LLM model selection (50+ models) |
mind_insights — Autonomous Learning Engine
Action | Description |
| Recent pattern-detected insights |
| Count of unseen insights |
| Mark seen, rate helpfulness |
| Trigger on-demand analysis |
| Weekly intelligence summary |
| ALE context data |
mind_automate — Automations
Action | Description |
| Automation CRUD |
| Trigger immediately |
| Execution log |
mind_notify — Notifications
Action | Description |
| View all notifications |
| Read management |
| Notification overview |
mind_admin — Administration & Featured Minds Portal
Requires an admin-scoped MIND API key. Powers everything at https://m-i-n-d.ai/#/admin/featuredmindsportal — the same surface any MCP client (Claude Code, Cursor, Windsurf, n8n via MCP, custom agents) can drive end-to-end.
User provisioning + tier/credits
Action | Description |
| Provision new MIND account; optionally generate an API key |
| List users with analytics, filterable by activity window and |
| Change subscription tier (free / pro / enterprise) |
| Add (+) or deduct (–) credits |
Featured Minds Portal — full CRUD
The catalog (featured_minds collection) and the linked owner profile (user_profiles) edited together so changes hit https://m-i-n-d.ai/m/{username} immediately.
Action | Description |
| Promote a user's MIND into the featured catalog |
| List every featured mind with |
| Bundled view in one round-trip: featured_mind doc + linked user_profile + available_models catalog (what the portal side sheet loads) |
| Catalog fields: |
| Write-through to user_profiles for the linked user: |
| Bulk display_order via |
| Remove from catalog. The user's underlying MIND is preserved. |
Recipe — change a featured MIND's model + prompt from MCP
mind_admin({ action: "list_featured_minds" })
// → grab the mind_id you want
mind_admin({ action: "get_featured_mind_full", mind_id: "<id>" })
// → see current owner_profile + the full available_models catalog
mind_admin({
action: "update_featured_mind_owner_profile",
mind_id: "<id>",
preferred_llm_model: "anthropic/claude-sonnet-4.6",
chat_temperature: 0.7,
public_mind_prompt: "You are Anthony's public MIND. Answer in his voice."
})
// → next anonymous chat at /m/{username} uses the new model + prompt + tempmind_agents — Agent Command Center (Admin)
Canonical registry of every agent across the workspace fleet — running on a VPS, planned, archived. Solves the recurring "every Claude Code session re-discovers my agents from scratch" problem. Backed by /admin/agents on the MIND backend. Requires an admin API key.
Action | Description |
| List/search agents with filters ( |
| Detail for one agent + last 20 activities inline |
| Register a new agent record (slug must be unique) |
| Partial update — name, description, status, cadence, host, responsibilities, etc. |
| Soft-archive (default) or |
| Push a heartbeat from the agent's runtime (updates |
| Active liveness probe (HTTP |
| Append a manual activity entry (notes, status changes, errors) |
| Paginated activity history for one agent |
| Shortcut update — flip status to running/paused/planned/archived/error |
| Shortcut update — record what the agent is doing right now |
| Enrich agent records from MIND |
| Idempotent upsert of the canonical seed list (additive; |
| Move the agent to another MIND account's board ( |
| Grant another account access — |
| List every account the agent is shared with |
| Drop a share grant by |
// Before scaffolding a new agent — check what exists
mind_agents({ action: "list" })
// After non-trivial work — keep the registry honest
mind_agents({
action: "heartbeat",
slug: "social-media-manager",
current_job: "drafting LinkedIn carousel for Friday"
})
// Promote a planned agent to running
mind_agents({ action: "set_status", slug: "audit-agent", status: "running" })
// Hand an agent to a teammate's board, or share it read-only
mind_agents({ action: "transfer_owner", slug: "audit-agent", owner_username: "jane" })
mind_agents({ action: "share", slug: "audit-agent", grantee_username: "sam", share_role: "viewer" })// Search the fleet by free text — slug, name, description, or tags
mind_agents({ action: "list", list_query: "atlas" })UI: visit https://m-i-n-d.ai/agents (admin-only) to browse the fleet visually.
mind_tickets — Agent Ticket Queue (Admin)
Every agent in the Command Center carries a ticket queue — client feedback, critique, ideas, feature requests, and bugs. A consulting client an agent is shared with files tickets; the agent's owner triages and resolves them. Every ticket auto-assigns to the Ernie triage agent and mirrors into MIND Life as a task. Backed by /admin/agents/{slug}/tickets. Requires an admin API key. agent_slug is required on every call.
Action | Description |
| Every ticket on an agent + open/total stats; optional |
| One ticket plus its full comment thread |
| File a new ticket ( |
| Answer a ticket — add a reply to its comment thread ( |
| Triage — change |
| Shortcut — mark the ticket |
| Remove the ticket, its comments, and its mirrored Life task |
kind: feedback · critique · idea · feature · bug
status: open → triaged → in_progress → resolved → closed
priority: low · medium · high · urgent
// File a bug against an agent
mind_tickets({ action: "create", agent_slug: "social-media-manager",
kind: "bug", priority: "high",
title: "Carousel export drops the last slide",
body: "Repro: 7-slide deck exports as 6." })
// Answer it, then resolve it
mind_tickets({ action: "comment", agent_slug: "social-media-manager",
ticket_id: "<id>", body: "Fixed in the export batch size — verified." })
mind_tickets({ action: "resolve", agent_slug: "social-media-manager", ticket_id: "<id>" })mind_accounts — Multi-MIND Accounts
A "MIND" is a knowledge-graph account. One person can own — or be granted access to — many MINDs (work, research, a client's, a shared team MIND) and switch between them. This tool lets an agent discover and manage them. Backed by /developer/v1/accounts on the MIND backend.
Action | Description |
| Every MIND your API key's owner can access, with role (owner/viewer) and which is active |
| Spin up a brand-new MIND you own (pass |
| Permanently delete a MIND you own — account, grants, and invitations (pass |
| Owners, viewers, and pending invitations of a MIND you own (pass |
| Give an existing MINDapp user owner/viewer access ( |
| Email an invitation to co-own or view a MIND ( |
// Discover every MIND you can reach
mind_accounts({ action: "list" })
// Create a dedicated MIND for a new workstream
mind_accounts({ action: "create", label: "Acme Corp Research" })
// Grant a teammate read-only access
mind_accounts({
action: "grant",
mind_username: "acme_research_a1b2c3",
grantee_username: "teammate",
role: "viewer"
})Note: owner = full access, viewer = read-only. Requires MULTI_MIND_ACCOUNTS_ENABLED on the MIND backend; list returns enabled: false when the feature is off.
Partner Integration
Partner apps can programmatically create MIND accounts using partner keys:
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
Variable | Required | Default | Description |
| Yes | — | Your MIND Developer API key |
| No |
| MIND API base URL |
Programmatic Usage
import { createMindMcpServer, MindClient } from "@astramindapp/mcp-server";
const client = new MindClient({
baseUrl: "https://www.m-i-n-d.ai",
apiKey: "mind_xxx",
});
const server = createMindMcpServer(client);
// Connect to any MCP transportPatents
MIND's core technology — including emotion-weighted knowledge graph encoding and cross-agent persistent memory via the Model Context Protocol — is the subject of pending patent applications. Patents pending.
Troubleshooting
"Connect" opened the MIND website instead of connecting — this was a bug in the non-www endpoint, fixed July 2026. Use
https://www.m-i-n-d.ai/mcp(with thewww) and retry.No "Connectors" option in my tool — use the Claude Code one-liner above if you're on Claude Code, or the local npm install (
npm install -g @astramindapp/mcp-server) for any other MCP-compatible tool.npxsays "could not determine executable to run" / hangs —npx -y <pkg>only runs the bin named after the package's last path segment (mcp-server), sonpx -y @astramindapp/mcp-serveralone fails, and adding@latestplus a trailingmind-mcp-setupjust passes it as an argument instead of selecting that bin — usenpx -y --package=@astramindapp/mcp-server mind-mcp-setup(ormind-mcp), which works on every version, or install globally first (npm install -g @astramindapp/mcp-server).I have multiple MIND accounts — add the connector once per account under a different name (e.g.
mind-personal,mind-work); each Connect click lets you pick the account on the consent screen.
Links
Website: www.m-i-n-d.ai
GitHub: theastraway/mind-mcp-server
MCP Docs: m-i-n-d.ai/mcp.html
License
MIT — Astra AI, Inc.
This server cannot be deployed
Maintenance
Related MCP Connectors
Persistent memory and knowledge graphs for AI agents. Hybrid search, context checkpoints, and more.
Persistent memory for AI agents. Semantic search, memory graph, W3C DID identity.
Persistent memory and knowledge management for AI agents with semantic search and 50+ tools.
Persistent memory for AI agents. EU-hosted, privacy-first, hybrid recall, contradiction detection.
Related MCP Servers
- FlicenseNot gradedqualityFmaintenanceProvides AI agents with persistent memory and knowledge management through a comprehensive knowledge graph platform. Enables storing, searching, and managing entities, relationships, and observations with advanced features like trending analysis and smart ranking.3-

Memsolus MCP Serverofficial
AlicenseAqualityDmaintenanceProvides persistent long-term memory for AI agents through semantic search and automated knowledge graph extraction. It enables agents to store, recall, and reason over facts, preferences, and relationships across multiple conversations and sessions.1414 npmMIT- AlicenseAqualityDmaintenanceEnables AI agents with persistent semantic memory, including semantic recall, knowledge graphs, and instant domain expertise via pre-built Intelligence Packs.1038 npmMIT
- AlicenseNot gradedqualityCmaintenanceProvides persistent knowledge graph memory for AI agents, enabling them to store, recall, and query facts about people, projects, and relationships across sessions.MIT