Back to Docs

API Reference

Eight remote MCP tools for Cursor, Claude Desktop, and VS Code. Authenticate with your aimem_* API key or OAuth — plan limits enforced per account.

MCP connection setup →

Remote MCP tools

Available today in Cursor, Claude Desktop, and VS Code via the hosted MCP server.

ToolStabilityDescription
remember(content, type?, collection?, tags?, append_to?, visibility?, group_id?, group_name?)stableSave scoped memory. Set collection for project work (project:<slug>) or personal tastes (personal:preferences). Use visibility=shared with group_id/group_name for group memory. Use append_to to extend an existing memory.
recall(query, limit?, type?, collection?, tags?, visibility?, group_id?, group_name?)stableSemantic search over long-term memory. Call list_collections first when scope is unclear. visibility defaults to all (personal + accessible groups).
get_context(topic, max_memories?, type?, collection?, tags?, visibility?, group_id?, group_name?)stableBuild a formatted context block for the current topic. Call list_collections when unsure of the exact slug. Partial collection names are resolved server-side.
list_memories(limit?, full_content?, type?, collection?, tags?, visibility?, group_id?, group_name?)stableList recent memories in a scope. Set full_content=true for untruncated previews. Filter by collection, tags, or type.
get_memory(memory_id)stableRetrieve full memory text by UUID (from list_memories or recall).
list_collections()stableList collection slugs for this user. Call before scoped recall/get_context when the user mentions a project or approximate folder name.
forget(memory_id)stableDelete a memory permanently by UUID.
memory_stats()stableCounts by memory type and collection slug.

Collections (scoped memory)

Group memories by topic so search stays in the right bucket. Pass collection on remember, recall, get_context, and list_memories.

Slug patternExampleUse for
project:<name>project:henry-memoryAll facts about one project
personal:preferencespersonal:preferencesTastes, habits, personal defaults (auto for type=preference)
work:<name>work:client-acmeWork context not tied to a side project
inboxinboxUnsorted conversation snippets

REST API

ChatGPT Actions, connectors, and custom integrations use the hosted REST API at https://api.memxus.com/api/v1. See Getting started for authentication and quick-start examples.

Plan limits

Aligned with the public pricing page. Hosted workspaces enforce quotas on the API.

Free, Pro ($12/mo), and Team ($149/mo) tiers differ in API calls, memories, storage, shared groups, and MCP result caps. Enterprise and Workforce — see organization plans or contact support@memxus.com.