memory.inspect · Cortex MCP Docs

Description

Fetches a single episode by id with its summary, source, and timestamp. Useful for hydrating a search hit, surfacing provenance, or letting the user verify exactly what Cortex remembers.

Input schema

Field	Type	Required	Description
`episode_id`	`string`	yes	Episode ID to inspect.

Output shape

typescript

{
  ok: boolean;
  episode?: { id: string; summary: string; source: string; occurred_at?: string };
  error?: string;
}

Example call

JSON-RPC tools/call request body (omit the JSON-RPC envelope when using an SDK; the SDK adds it for you):

jsontools/call params

{
  "name": "memory.inspect",
  "arguments": { "episode_id": "ep_01HXR4N9TZ5W2QF6KMVDX8Y3GP" }
}

Example response

Tool results are always wrapped as content[0].text with a stringified JSON body. The shape below is what you get back from JSON.parse(result.content[0].text):

jsonparsed result body

{
  "ok": true,
  "episode": {
    "id": "ep_01HXR4N9TZ5W2QF6KMVDX8Y3GP",
    "summary": "Sarah moved to a new role at Acme; she'll lead the API team.",
    "source": "manual",
    "occurred_at": "2026-05-27T14:31:00Z"
  }
}

Errors this tool can return

Code	Meaning
`invalid_arguments`	Tool input failed Zod validation.
`unauthorized`	Missing or invalid bearer token.

See the full error catalog for resolution steps on each code, plus the standard transport-layer responses (401, 429).