Summary
If you're building agents that need to remember things across sessions and tools, this gives you a full CRUD layer over Maindex's memory infrastructure. You get collections, typed memories with metadata, links between facts, semantic search, and bulk operations all through MCP. It connects to their hosted graph at expert.maindex.io, which means your agent's memories sync across Claude, Cursor, ChatGPT, or whatever else you hook up via their OAuth flow. Useful when you want structured, traceable memory instead of dumping context into a vector DB or rewriting the same facts into every chat. The Expert tier exposes the full API, including collection locking and revision history.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
Tools
Public tool metadata for what this MCP can expose to an agent.
14 tools
collection_unlockUnlock locked memory collections using a passphrase. When collections are locked, their contents are invisible. Provide the passphrase (e.g. 'bright-coral-drift') to unlock them for this session. Mutates session unlock state. Idempotent.1 params
Unlock locked memory collections using a passphrase. When collections are locked, their contents are invisible. Provide the passphrase (e.g. 'bright-coral-drift') to unlock them for this session. Mutates session unlock state. Idempotent.
Parameters* required
passphrasestringThe unlock passphrase (e.g. 'bright-coral-drift')
memory_keepCreate a new memory. Mutates. Not idempotent — calling twice creates two distinct memories. Returns the created memory with id (UUID) and shortId (e.g. mem-1a). Tip: include conversation identifiers in `conversations` to group related memories. CONTENT POLICY: NEVER store pass...18 params
Create a new memory. Mutates. Not idempotent — calling twice creates two distinct memories. Returns the created memory with id (UUID) and shortId (e.g. mem-1a). Tip: include conversation identifiers in `conversations` to group related memories. CONTENT POLICY: NEVER store pass...
Parameters* required
bodystringSupporting detail. Omit if the headline is self-contained.default:
kindstringMemory type: note, fact, idea, summary, artifact, task_context, constraint, question, decisionone of
note · fact · idea · summary · artifact · task_contextdefault: notetagsarrayTags for categorization. Use facet:name format for structured tags (e.g. domain:cosmology, project:brox).
linksarrayTyped links to create from this memory
signerobjectAgent identity -- who wrote this. Required fields: agent_id, run_id.
sourceobjectSource metadata: origin platform, URI, author, capture time
headlinestringTitle or core assertion of the memory (required)
metadataobjectArbitrary key-value metadata stored as JSON. Opaque to search and ranking.
stale_atstringISO 8601 datetime when this memory becomes stale
confidenceintegerConfidence as an integer percentage from 0 to 100 (e.g. 85 means 85% confident)
collectionsarrayCollection slugs or IDs to add this memory to
canon_statusstringCanonicality: draft, proposed, accepted, deprecated, alternative, metaone of
draft · proposed · accepted · deprecated · alternative · metadefault: draftconversationsarrayConversation contexts this memory belongs to. If you are acting within a named conversation, chat session, or task context, pass its identifier here to enable cross-memory grouping.
parent_memory_idvalueParent memory ID -- creates a belongs_to link
source_memory_idsarrayIDs of memories this was derived from (provenance tracking)
human_collaboratorobjectHuman collaborator context (name, email, timezone, etc.)
related_memory_idsarrayRelated memory IDs -- creates related_to links
verification_statusstringVerification status: unverified, verified, disputed, supersededone of
unverified · verified · disputed · supersededdefault: unverifiedmemory_updateUpdate an existing memory by creating a new revision (full history is preserved). Supports changing kind, canon_status, confidence, and verification_status in-place. Mutates. Tags and conversations are additive. Retryable — duplicate calls create extra revisions but do not cor...16 params
Update an existing memory by creating a new revision (full history is preserved). Supports changing kind, canon_status, confidence, and verification_status in-place. Mutates. Tags and conversations are additive. Retryable — duplicate calls create extra revisions but do not cor...
Parameters* required
bodystringNew body text
kindstringChange the memory kindone of
note · fact · idea · summary · artifact · task_contextmodestringHow to apply the updateone of
body_append · body_replace · headline_replace · headline_and_body_replace · revision_onlytagsarrayTags to add (additive)
signerobjectAgent identity -- who wrote this. Required fields: agent_id, run_id.
headlinestringNew headline text
metadataobjectArbitrary key-value metadata stored on the revision (not merged into the memory). Opaque to search and ranking.
replacesvalueMark this memory as replacing another
memory_idstringID of the memory to update
confidenceintegerConfidence as an integer percentage from 0 to 100 (e.g. 85 means 85% confident)
canon_statusstringSet canon status: draft, proposed, accepted, deprecated, alternative, metaone of
draft · proposed · accepted · deprecated · alternative · metaconversationsarrayConversation contexts to add (additive)
superseded_bystringMark this memory as superseded by another
source_memory_idsarrayIDs of memories this revision was derived from
human_collaboratorobjectHuman collaborator context (name, email, timezone, etc.)
verification_statusstringVerification status: unverified, verified, disputed, supersededone of
unverified · verified · disputed · supersededmemory_forgetSoft-delete a memory (sets status to 'deleted'; restorable). Mutates. Idempotent — safe to retry. Returns the deletion result with the memory's id and shortId.2 params
Soft-delete a memory (sets status to 'deleted'; restorable). Mutates. Idempotent — safe to retry. Returns the deletion result with the memory's id and shortId.
Parameters* required
signerobjectAgent identity -- who wrote this. Required fields: agent_id, run_id.
memory_idstringID of the memory to delete
memory_recallRetrieve a single memory by ID (UUID or short_id like mem-1a). Read-only. Returns the memory object, or null if not found.4 params
Retrieve a single memory by ID (UUID or short_id like mem-1a). Read-only. Returns the memory object, or null if not found.
Parameters* required
memory_idstringID of the memory to retrieve
include_linksbooleanInclude linked memoriesdefault: true
include_deletedbooleanInclude soft-deleted memoriesdefault: false
include_revisionsbooleanInclude full revision historydefault: false
memory_listList memories with filters (tags, kind, canon_status, collection, session, confidence range, tag facets). Read-only. Returns { items, total }.19 params
List memories with filters (tags, kind, canon_status, collection, session, confidence range, tag facets). Read-only. Returns { items, total }.
Parameters* required
kindstringFilter by memory kindone of
note · fact · idea · summary · artifact · task_contextsortstringSort fieldone of
updated_at · created_at · headline · stale_atdefault: updated_attagsarrayFilter by tags (AND semantics by default)
limitintegerMaximum number of results to return
orderstringSort order: ascending or descendingone of
asc · descdefault: descoffsetintegerNumber of results to skip for paginationdefault: 0
statusstringFilter by status: active, stale, deletedone of
active · stale · deletedtag_modestringTag matching mode: all (AND) or any (OR)one of
all · anydefault: alltag_facetstringFilter by tag facet: domain, project, function, status, topicone of
domain · project · function · status · topiccollectionstringFilter by collection slug or ID
session_idstringFilter by interaction session
canon_statusstringFilter by canon statusone of
draft · proposed · accepted · deprecated · alternative · metaupdated_afterstringOnly memories updated after this ISO 8601 datetime
max_confidenceintegerMaximum confidence as an integer percentage from 0 to 100
min_confidenceintegerMinimum confidence as an integer percentage from 0 to 100
updated_beforestringOnly memories updated before this ISO 8601 datetime
conversation_keystringFilter by conversation key
conversation_typestringFilter by conversation type
verification_statusstringFilter by verification statusone of
unverified · verified · disputed · supersededmemory_searchFull-text and semantic search across memories. Multi-tier retrieval: exact match, relaxed OR fallback with synonym expansion, fuzzy trigram, and optional semantic/hybrid search. Read-only. Returns { items, total, search_mode, retrieval_sources, degraded_components }.23 params
Full-text and semantic search across memories. Multi-tier retrieval: exact match, relaxed OR fallback with synonym expansion, fuzzy trigram, and optional semantic/hybrid search. Read-only. Returns { items, total, search_mode, retrieval_sources, degraded_components }.
Parameters* required
qstringSearch query
kindstringFilter by memory kindone of
note · fact · idea · summary · artifact · task_contextsortstringSort fieldone of
relevance · updated_at · created_at · confidencedefault: relevancetagsarrayFilter by tags
limitintegerMaximum number of results to return
orderstringSort order: ascending or descendingone of
asc · descdefault: descoffsetintegerNumber of results to skip for paginationdefault: 0
statusstringFilter by status: active, stale, deletedone of
active · stale · deletedtag_modestringTag matching mode: all (AND) or any (OR)one of
all · anydefault: alltag_facetstringFilter by tag facetone of
domain · project · function · status · topiccollectionstringFilter by collection slug or ID
session_idstringFilter by interaction session
canon_statusstringFilter by canon statusone of
draft · proposed · accepted · deprecated · alternative · metaallow_relaxedbooleanAllow AND-to-OR relaxed fallback when strict search returns nothingdefault: true
search_fieldsarrayRestrict search to specific fields
stale_penaltynumberHow much to penalize stale memories in ranking. 0 = no penalty, 1 = fully suppress. Default 0.5.default: 0.5
max_confidenceintegerMaximum confidence as an integer percentage from 0 to 100
min_confidenceintegerMinimum confidence as an integer percentage from 0 to 100
search_strategystringSearch strategy: auto (best available), lexical (text only), semantic (vector only), hybrid (both with fusion)one of
auto · lexical · semantic · hybriddefault: autoverification_statusstringFilter by verification statusone of
unverified · verified · disputed · supersededinclude_match_contextbooleanInclude highlighted match context snippetsdefault: true
include_graph_neighborsbooleanInclude graph-linked neighbor memories in resultsdefault: false
include_score_breakdownbooleanInclude per-signal score breakdown for each resultdefault: false
memory_associateCreate typed links between memories (inverse links auto-created for known types). Mutates. Not idempotent — calling twice creates duplicate links. Returns the created link objects with id and shortId. Common relation types: belongs_to, supports, depends_on, contradicts, altern...3 params
Create typed links between memories (inverse links auto-created for known types). Mutates. Not idempotent — calling twice creates duplicate links. Returns the created link objects with id and shortId. Common relation types: belongs_to, supports, depends_on, contradicts, altern...
Parameters* required
signerobjectAgent identity -- who wrote this. Required fields: agent_id, run_id.
targetsarrayTarget memories to link to
from_memory_idstringSource memory ID
memory_get_relatedDiscover related memories via links, shared tags, or collection membership. Read-only. At least one of memory_id, tags, or collection is required. Returns an array of related memory objects.5 params
Discover related memories via links, shared tags, or collection membership. Read-only. At least one of memory_id, tags, or collection is required. Returns an array of related memory objects.
Parameters* required
tagsarrayFind memories sharing these tags
limitintegerMaximum number of related memories to returndefault: 20
memory_idstringID of the memory to find relations for
collectionstringFilter by collection slug or ID
relation_typestringFilter by relation type (e.g. supports, contradicts, depends_on)
collection_manageCreate, update, delete collections, or manage their members. Actions 'list' and 'get' are read-only; all others mutate. 'create' is not idempotent; 'delete' is idempotent. The 'id' param is required for update/delete/add_members/remove_members/get. Returns the collection objec...11 params
Create, update, delete collections, or manage their members. Actions 'list' and 'get' are read-only; all others mutate. 'create' is not idempotent; 'delete' is idempotent. The 'id' param is required for update/delete/add_members/remove_members/get. Returns the collection objec...
Parameters* required
idstringCollection ID, short_id, or slug (required for update/delete/add_members/remove_members/get)
iconstringEmoji or icon identifier
namestringCollection name (for create/update)
slugstringURL-friendly slug (auto-generated from name if omitted)
colorstringHex color for UI display
actionstringAction to performone of
create · update · delete · add_members · remove_members · listmetadataobjectArbitrary key-value metadata for the collection. Opaque to search and ranking.
parent_idstringParent collection ID for nesting
memory_idsarrayMemory IDs (for add_members/remove_members)
descriptionstringCollection description
summary_headlinestringShort summary for browsing
memory_supersedeReplace an existing memory with a new one. Creates the replacement, marks the old memory as deprecated (superseded_by → new), and creates a supersedes link. Tags from the old memory are automatically inherited by the new one (merged with any caller-provided tags). Mutates. Not...10 params
Replace an existing memory with a new one. Creates the replacement, marks the old memory as deprecated (superseded_by → new), and creates a supersedes link. Tags from the old memory are automatically inherited by the new one (merged with any caller-provided tags). Mutates. Not...
Parameters* required
bodystringBody text of the new replacement memorydefault:
kindstringMemory type for the replacementone of
note · fact · idea · summary · artifact · task_contextdefault: notetagsarrayTags for the replacement memory (merged with inherited tags from the old memory)
signerobjectAgent identity -- who wrote this. Required fields: agent_id, run_id.
sourceobjectSource metadata for the replacement memory
headlinestringHeadline of the new replacement memory
metadataobjectArbitrary key-value metadata for the replacement
collectionsarrayCollection slugs or IDs for the replacement
canon_statusstringCanon status for the replacement (defaults to accepted)one of
draft · proposed · accepted · deprecated · alternative · metadefault: acceptedold_memory_idstringID of the memory being superseded
memory_bulk_keepCreate multiple memories in one call (max 100) with shared defaults. Tags and collections are merged per-item. Mutates. Not idempotent — calling twice creates duplicates. Auto-links batch members with mentioned_with links unless auto_link is false. Returns { created, memories...3 params
Create multiple memories in one call (max 100) with shared defaults. Tags and collections are merged per-item. Mutates. Not idempotent — calling twice creates duplicates. Auto-links batch members with mentioned_with links unless auto_link is false. Returns { created, memories...
Parameters* required
defaultsobjectShared defaults applied to all memories in the batch
memoriesarrayArray of memories to create (1-100)
auto_linkbooleanAuto-create mentioned_with links between batch membersdefault: true
memory_bulk_updateBatch update multiple memories (max 100). Supports add/remove tags, set kind, set canon_status, set verification_status, add/remove collections, merge metadata, add links, forget (soft-delete). Does NOT support headline/body replacement. Mutates. Idempotent for set_* and tag o...3 params
Batch update multiple memories (max 100). Supports add/remove tags, set kind, set canon_status, set verification_status, add/remove collections, merge metadata, add links, forget (soft-delete). Does NOT support headline/body replacement. Mutates. Idempotent for set_* and tag o...
Parameters* required
signerobjectAgent identity -- who wrote this. Required fields: agent_id, run_id.
memory_idsarrayMemory IDs to update
operationsobjectOperations to apply to all specified memories
system_report_bugReport a bug to the Maindex maintainers. Provide a clear title, description, severity, and category. Include reproduction steps, error messages, and context when available. Do not include sensitive information. Reports are not public and are delivered to the team's internal bu...14 params
Report a bug to the Maindex maintainers. Provide a clear title, description, severity, and category. Include reproduction steps, error messages, and context when available. Do not include sensitive information. Reports are not public and are delivered to the team's internal bu...
Parameters* required
titlestringShort bug title
agent_idstringIdentifier of the reporting agent
categorystringBug category: data_integrity, api_error, performance, auth, mcp_protocol, search, ui, otherone of
data_integrity · api_error · performance · auth · mcp_protocol · searchhostnamestringHostname of the reporting machine
metadataobjectArbitrary key-value context
severitystringBug severity: critical, high, medium, lowone of
critical · high · medium · lowsession_idstringMCP session ID
descriptionstringDetailed description of the bug
environmentstringEnvironment: development, staging, productionone of
development · staging · productionaction_calledstringMCP tool or API action that triggered the bug
error_messagestringRaw error message or stack trace
actual_behaviorstringWhat actually happened
expected_behaviorstringWhat should have happened
steps_to_reproducestringStep-by-step reproduction instructions
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →Categories
Registryactive
TransportHTTP
AuthRequired
UpdatedMay 3, 2026
