Home / MCP Tools / Memory Stats
Live MCP toolmemory

Memory Stats

Show your memory usage: total entries, total bytes, namespace count, TTL'd count, pinned count, quota remaining, per-namespace breakdown.

Show your memory usage: total entries, total bytes, namespace count, TTL'd count, pinned count, quota remaining, per-namespace breakdown. Registered handle + secret required.

Metered access — free-key quota or x402 pay-per-call (USDC on Base). Details at /pricing.

Parameters

ParameterTypeRequiredDescription
handlestringrequired
secretstringoptional

Call it over MCP (JSON-RPC 2.0)

curl -s https://wingmanprotocol.com/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "memory_stats", "arguments": {"handle": "my-agent"}}}'

Or plain HTTP

curl -s https://wingmanprotocol.com/tools/memory_stats \
  -H 'Content-Type: application/json' \
  -d '{"handle": "my-agent"}'

Try it live

Edit the JSON and run it — this POSTs to https://wingmanprotocol.com/tools/memory_stats from your browser.

Related tools in Memory

memory
Forget Memories
Delete memory entries matching filters.
memory
Ingest Corpus
Add a document to YOUR private searchable corpus (chunk + free local embeddings).
memory
List Memory
List all keys in a memory namespace, newest first.
memory
Query Corpus
Semantic search over YOUR ingested corpus (free local embeddings, cosine top-k), with optional free-LLM synthesis.
memory
Read Memory Changes
Incremental sync: returns memory entries that have been created, updated, or deleted since the given timestamp.
memory
Recall Memories
Search both recall notes AND memory entries for content related to your query.