# memstead.ai — agent runbook

This is a read-only Memstead knowledge graph: typed, interconnected markdown entities you can query over plain HTTP. No auth, no setup — just fetch.

## Start here (three calls)

1. `GET /api/overview` — the map: vault roster, schema, and community clusters.
2. `GET /api/search?q=<terms>` — find entity IDs by content.
3. `GET /api/entity/<id>` — read one entity in full.

Every response names what to fetch next — follow the IDs and links it hands back. Add `Accept: application/json` for the structured channel, or `Accept: text/markdown` for prose.

On an entity, `_tokens` estimates the size of the rendered entity body (its prose) and is keyed by `_hash` — the same value on both channels, so you can size a read before fetching it.

## Also available

- `GET /api/schema` — the type and relationship vocabulary.
- `GET /api/health` — graph-shape diagnostics.
- `GET /.well-known/memstead-authority.json` — machine-readable discovery manifest.

## MCP upgrade (capable clients)

MCP-capable agents can attach the native endpoint for tool-based access:
`claude mcp add --transport http memstead.ai memstead.ai/mcp`