Observability

The observability API provides dashboard-grade analytics for a project’s memory engine. All routes are project-scoped and require the same auth as MCP calls.

Summary

curl https://YOUR_API_HOST/v1/projects/my-project/observability/summary \
  -H "Authorization: Bearer mt_live_..."

Returns a 7-day overview: query stats (count, avg latency, mode breakdown), memory stats (total, by kind), search leg performance, and the top-accessed memories.

Query log

curl "https://YOUR_API_HOST/v1/projects/my-project/observability/queries?limit=50&mode=auto" \
  -H "Authorization: Bearer mt_live_..."

param	type	notes
limit	number	1–200, default 50
offset	number	Pagination offset, default 0
mode	string?	Filter by search mode (auto, chunks, summaries, entities, code)
since	number?	Start of time window (ms epoch)
until	number?	End of time window (ms epoch)

Returns recent search queries with their latency, result count, and mode.

Memory health

curl https://YOUR_API_HOST/v1/projects/my-project/observability/memories/health \
  -H "Authorization: Bearer mt_live_..."

Returns a breakdown of memory states by salience and recency:

state	meaning
active	Recently accessed, high salience
idle	Not recently accessed, but salience above threshold
stale	Salience decayed below threshold, candidate for consolidation
dormant	Very low salience, rarely accessed

Timeseries

curl "https://YOUR_API_HOST/v1/projects/my-project/observability/timeseries?metric=queries&bucket=day" \
  -H "Authorization: Bearer mt_live_..."

param	type	notes
metric	"queries" | "latency" | "accesses"	Default "queries"
bucket	"hour" | "day" | "week"	Default "day"
since	number?	Start of time window (ms epoch)
until	number?	End of time window (ms epoch)

Returns { data: [{ bucket_start, value }] } for charting.