🔐 MCP Tools - Memwal Only

Only on memwal (picked server-side by MEMORY_ENGINE=memwal).

memory_analyze - extract facts from text

Arg	Required	Description
text	Yes	Free-form text to extract memorable facts from
occurredAt	No	ISO-8601 timestamp of when the event happened

Analyzes text with the relayer, extracts discrete facts, and stores each as its own memory with its own IPFS CID. Returns { factCount, succeeded, failed, memories: [RememberResult, …] }. Facts are tagged ['analyzed'].

memory_verify - integrity check

Arg	Required	Description
ref	Yes	Memory id, IPFS CID, or Walrus blob id

Pinned records are fetched from the gateway and compared byte-for-byte (method: 'gateway-fetch'); unpinned records are re-hashed locally (method: 'local-hash'). Returns { id, cid, pinned, verified, method }.

memory_restore_index - repair the relayer index

Arg	Required	Description
maxBlobs	No	Max on-chain blobs to inspect, 1–1000 (default 200)

Asks the relayer to rebuild missing vector-index entries for this namespace from on-chain data. Use if recall seems to miss older memories. Returns { restored, skipped, total, calls }.

memory_repin_pending - retry failed pins

No args. Retries pinning for memories whose pin failed at store time (pendingPins in status). Returns { repinned, remaining }.

memory_snapshot_index / memory_rebuild_local - snapshot the local index

Same shape as the batched pair, but memwal-specific: pins the entire local index (records, tags, CIDs) to IPFS. Snapshots are namespace- and network-checked and plaintext.

Tool	Arg
memory_snapshot_index	- → { cid, pinned, entries, gatewayUrl? }
memory_rebuild_local	{ snapshotCid } → { added, total }

memory_blob_ids - Walrus-native ids

Arg	Required	Description
ref	Yes	Memory id, IPFS CID, or Walrus blob id

Returns { memwalBlobId, recordBlobIds } - the encrypted memwal blob plus blobs backing the pinned IPFS record (empty when unpinned). Needed for Sui ecosystem tooling.