MCP Memory Tools

Overview

AI Memory is exposed as MCP tools on both the Customer MCP (integration gateway /api/mcp) and the Partner MCP gateway (integration gateway /api/partner-mcp). These tools let AI agents and automation workflows read from and write to a customer’s long-term memory (Minds) across sessions.

Customer MCP tools

Customer MCP tools are available to any agent or Claude Code session authenticated with a customer MCP token.

Connection

claude mcp add knotie-memory \
  --transport http \
  --url https://<integration-gateway>/api/mcp \
  --header "Authorization: Bearer <customer_mcp_token>"

Replace <integration-gateway> with your integration gateway URL and <customer_mcp_token> with a valid customer MCP token (obtainable from the customer portal or the partner portal API Keys page).

Available tools

`internal_memory_remember`

Writes a fact or text into the customer’s Mind. Parameters:

Parameter	Type	Required	Description
`content`	string	Yes	The text to remember (a fact, conversation excerpt, or any context)
`mindId`	string	No	The specific Mind ID to write to. Defaults to the customer’s primary Mind

Credit cost: Partner Knotie Credits + Customer AI Credits (if aiCreditsEnabled). Example usage in Claude Code:

Please remember: "The caller prefers WhatsApp. Their callback code is LV-7731."

`internal_memory_recall`

Retrieves the current state of a Mind — Profile, Snapshot, and recent stored messages. Parameters:

Parameter	Type	Required	Description
`mindId`	string	No	The specific Mind ID to recall. Defaults to the customer’s primary Mind

Credit cost: Free — Recall never charges credits. Example response:

{
  "profile": "Customer prefers WhatsApp. Callback code: LV-7731.",
  "snapshot": "Last contacted 2026-06-19. Expressed interest in the Premium plan.",
  "messages": []
}

`internal_memory_ask`

Asks a natural-language question that is answered by reasoning over the Mind’s stored knowledge. Parameters:

Parameter	Type	Required	Description
`question`	string	Yes	The question to ask
`reasoningLevel`	string	No	`"standard"`, `"enhanced"`, or `"deep"`. Defaults to `"standard"`
`mindId`	string	No	The specific Mind ID to query. Defaults to the customer’s primary Mind

Credit cost: Partner Knotie Credits + Customer AI Credits. Higher reasoning level = higher cost.

Enablement gate

All three Customer MCP memory tools are gated by:

The partner having AI Memory enabled.
The specific customer having enableAiMemory = true.

If either condition is not met, the tool returns a 403 with a sanitized error message.

Partner MCP gateway tools

Partner MCP tools let you manage customer Minds and operate on them using a partner API key with the correct scopes. This is designed for automation workflows, n8n, Zapier, or custom integrations.

Authentication and scopes

Create a partner API key at Partner Portal → API Keys with the following scopes:

Scope	Purpose
`memory:read`	Recall, Ask, List Minds
`memory:write`	Remember, Create Mind

Connection

claude mcp add knotie-partner-memory \
  --transport http \
  --url https://<integration-gateway>/api/partner-mcp \
  --header "Authorization: Bearer pkt_<your_api_key>"

Available tools

All Partner MCP memory tools require a customerId parameter. The API key’s partner ID enforces tenant isolation — you cannot access another partner’s customers.

`memory_list_minds`

Lists all Minds for a given customer. Scope: memory:read | Parameters: customerId (string, required)

`memory_create_mind`

Creates a new Mind for a customer. Scope: memory:write | Parameters: customerId (string, required), name (string, required), description (string, optional)

`memory_remember`

Stores a fact into a customer’s Mind. Scope: memory:write | Parameters: customerId (string, required), content (string, required), mindId (string, optional) Credit cost: Partner Knotie Credits + Customer AI Credits.

`memory_recall`

Retrieves a customer’s Mind state (Profile, Snapshot, messages). Scope: memory:read | Parameters: customerId (string, required), mindId (string, optional) Credit cost: Free.

`memory_ask`

Poses a question answered from a customer’s Mind. Scope: memory:read | Parameters: customerId (string, required), question (string, required), reasoningLevel (string, optional), mindId (string, optional) Credit cost: Partner Knotie Credits + Customer AI Credits.

Error reference

HTTP status	Meaning
403	Memory is not enabled for this partner or customer
404	The specified `mindId` doesn’t exist or belongs to a different customer
503	The memory service is temporarily unreachable — Recall still works in degraded mode
429	Memory service rate limit reached; retry after the `Retry-After` header

Do not surface raw error messages from memory tool calls to end users. Error responses are already sanitized at the gateway before they reach client responses.

Overview

MCP APIs

More API specs

Overview

Customer MCP tools

Connection

Available tools

`internal_memory_remember`

`internal_memory_recall`

`internal_memory_ask`

Enablement gate

Partner MCP gateway tools

Authentication and scopes

Connection

Available tools

`memory_list_minds`

`memory_create_mind`

`memory_remember`

`memory_recall`

`memory_ask`

Error reference

​Overview

​Customer MCP tools

​Connection

​Available tools

​internal_memory_remember

​internal_memory_recall

​internal_memory_ask

​Enablement gate

​Partner MCP gateway tools

​Authentication and scopes

​Connection

​Available tools

​memory_list_minds

​memory_create_mind

​memory_remember

​memory_recall

​memory_ask

​Error reference

​Related

Overview

Customer MCP tools

Connection

Available tools

`internal_memory_remember`

`internal_memory_recall`

`internal_memory_ask`

Enablement gate

Partner MCP gateway tools

Authentication and scopes

Connection

Available tools

`memory_list_minds`

`memory_create_mind`

`memory_remember`

`memory_recall`

`memory_ask`

Error reference

Related