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.
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
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:
canon_statusstringCanonicality: draft, proposed, accepted, deprecated, alternative, metaone of
draft · proposed · accepted · deprecated · alternative · metadefault: draftcollectionsarrayCollection slugs or IDs to add this memory to
confidenceintegerConfidence as an integer percentage from 0 to 100 (e.g. 85 means 85% confident)
conversationsarrayConversation 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.
headlinestringTitle or core assertion of the memory (required)
human_collaboratorobjectHuman collaborator context (name, email, timezone, etc.)
kindstringMemory type: note, fact, idea, summary, artifact, task_context, constraint, question, decisionone of
note · fact · idea · summary · artifact · task_contextdefault: notelinksarrayTyped links to create from this memory
metadataobjectArbitrary key-value metadata stored as JSON. Opaque to search and ranking.
parent_memory_idvalueParent memory ID -- creates a belongs_to link
related_memory_idsarrayRelated memory IDs -- creates related_to links
signerobjectAgent identity -- who wrote this. Required fields: agent_id, run_id.
sourceobjectSource metadata: origin platform, URI, author, capture time
source_memory_idsarrayIDs of memories this was derived from (provenance tracking)
stale_atstringISO 8601 datetime when this memory becomes stale
tagsarrayTags for categorization. Use facet:name format for structured tags (e.g. domain:cosmology, project:brox).
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
canon_statusstringSet canon status: draft, proposed, accepted, deprecated, alternative, metaone of
draft · proposed · accepted · deprecated · alternative · metaconfidenceintegerConfidence as an integer percentage from 0 to 100 (e.g. 85 means 85% confident)
conversationsarrayConversation contexts to add (additive)
headlinestringNew headline text
human_collaboratorobjectHuman collaborator context (name, email, timezone, etc.)
kindstringChange the memory kindone of
note · fact · idea · summary · artifact · task_contextmemory_idstringID of the memory to update
metadataobjectArbitrary key-value metadata stored on the revision (not merged into the memory). Opaque to search and ranking.
modestringHow to apply the updateone of
body_append · body_replace · headline_replace · headline_and_body_replace · revision_onlyreplacesvalueMark this memory as replacing another
signerobjectAgent identity -- who wrote this. Required fields: agent_id, run_id.
source_memory_idsarrayIDs of memories this revision was derived from
superseded_bystringMark this memory as superseded by another
tagsarrayTags to add (additive)
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
memory_idstringID of the memory to delete
signerobjectAgent identity -- who wrote this. Required fields: agent_id, run_id.
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
include_deletedbooleanInclude soft-deleted memoriesdefault: false
include_linksbooleanInclude linked memoriesdefault: true
include_revisionsbooleanInclude full revision historydefault: false
memory_idstringID of the memory to retrieve
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
canon_statusstringFilter by canon statusone of
draft · proposed · accepted · deprecated · alternative · metacollectionstringFilter by collection slug or ID
conversation_keystringFilter by conversation key
conversation_typestringFilter by conversation type
kindstringFilter by memory kindone of
note · fact · idea · summary · artifact · task_contextlimitintegerMaximum number of results to return
max_confidenceintegerMaximum confidence as an integer percentage from 0 to 100
min_confidenceintegerMinimum confidence as an integer percentage from 0 to 100
offsetintegerNumber of results to skip for paginationdefault: 0
orderstringSort order: ascending or descendingone of
asc · descdefault: descsession_idstringFilter by interaction session
sortstringSort fieldone of
updated_at · created_at · headline · stale_atdefault: updated_atstatusstringFilter by status: active, stale, deletedone of
active · stale · deletedtag_facetstringFilter by tag facet: domain, project, function, status, topicone of
domain · project · function · status · topictag_modestringTag matching mode: all (AND) or any (OR)one of
all · anydefault: alltagsarrayFilter by tags (AND semantics by default)
updated_afterstringOnly memories updated after this ISO 8601 datetime
updated_beforestringOnly memories updated before this ISO 8601 datetime
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
allow_relaxedbooleanAllow AND-to-OR relaxed fallback when strict search returns nothingdefault: true
canon_statusstringFilter by canon statusone of
draft · proposed · accepted · deprecated · alternative · metacollectionstringFilter by collection slug or ID
include_graph_neighborsbooleanInclude graph-linked neighbor memories in resultsdefault: false
include_match_contextbooleanInclude highlighted match context snippetsdefault: true
include_score_breakdownbooleanInclude per-signal score breakdown for each resultdefault: false
kindstringFilter by memory kindone of
note · fact · idea · summary · artifact · task_contextlimitintegerMaximum number of results to return
max_confidenceintegerMaximum confidence as an integer percentage from 0 to 100
min_confidenceintegerMinimum confidence as an integer percentage from 0 to 100
offsetintegerNumber of results to skip for paginationdefault: 0
orderstringSort order: ascending or descendingone of
asc · descdefault: descqstringSearch query
search_fieldsarrayRestrict search to specific fields
search_strategystringSearch strategy: auto (best available), lexical (text only), semantic (vector only), hybrid (both with fusion)one of
auto · lexical · semantic · hybriddefault: autosession_idstringFilter by interaction session
sortstringSort fieldone of
relevance · updated_at · created_at · confidencedefault: relevancestale_penaltynumberHow much to penalize stale memories in ranking. 0 = no penalty, 1 = fully suppress. Default 0.5.default: 0.5
statusstringFilter by status: active, stale, deletedone of
active · stale · deletedtag_facetstringFilter by tag facetone of
domain · project · function · status · topic+3 more parameters. See the server's own documentation for the full schema.
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
from_memory_idstringSource memory ID
signerobjectAgent identity -- who wrote this. Required fields: agent_id, run_id.
targetsarrayTarget memories to link to
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
collectionstringFilter by collection slug or ID
limitintegerMaximum number of related memories to returndefault: 20
memory_idstringID of the memory to find relations for
relation_typestringFilter by relation type (e.g. supports, contradicts, depends_on)
tagsarrayFind memories sharing these tags
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
actionstringAction to performone of
create · update · delete · add_members · remove_members · listcolorstringHex color for UI display
descriptionstringCollection description
iconstringEmoji or icon identifier
idstringCollection ID, short_id, or slug (required for update/delete/add_members/remove_members/get)
memory_idsarrayMemory IDs (for add_members/remove_members)
metadataobjectArbitrary key-value metadata for the collection. Opaque to search and ranking.
namestringCollection name (for create/update)
parent_idstringParent collection ID for nesting
slugstringURL-friendly slug (auto-generated from name if omitted)
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:
canon_statusstringCanon status for the replacement (defaults to accepted)one of
draft · proposed · accepted · deprecated · alternative · metadefault: acceptedcollectionsarrayCollection slugs or IDs for the replacement
headlinestringHeadline of the new replacement memory
kindstringMemory type for the replacementone of
note · fact · idea · summary · artifact · task_contextdefault: notemetadataobjectArbitrary key-value metadata for the replacement
old_memory_idstringID of the memory being superseded
signerobjectAgent identity -- who wrote this. Required fields: agent_id, run_id.
sourceobjectSource metadata for the replacement memory
tagsarrayTags for the replacement memory (merged with inherited tags from the old memory)
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
auto_linkbooleanAuto-create mentioned_with links between batch membersdefault: true
defaultsobjectShared defaults applied to all memories in the batch
memoriesarrayArray of memories to create (1-100)
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
memory_idsarrayMemory IDs to update
operationsobjectOperations to apply to all specified memories
signerobjectAgent identity -- who wrote this. Required fields: agent_id, run_id.
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
action_calledstringMCP tool or API action that triggered the bug
actual_behaviorstringWhat actually happened
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 · searchdescriptionstringDetailed description of the bug
environmentstringEnvironment: development, staging, productionone of
development · staging · productionerror_messagestringRaw error message or stack trace
expected_behaviorstringWhat should have happened
hostnamestringHostname of the reporting machine
metadataobjectArbitrary key-value context
session_idstringMCP session ID
severitystringBug severity: critical, high, medium, lowone of
critical · high · medium · lowsteps_to_reproducestringStep-by-step reproduction instructions
titlestringShort bug title
Featured
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Categories
Registryactive
TransportHTTP
AuthRequired
UpdatedMay 3, 2026
