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 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>"
<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).
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 |
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 |
{
"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 |
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 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>"
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.
