# memstead.ai — agent runbook

A Memstead knowledge graph, served as plain HTML you can read with no tools and no setup. It is read-only over HTTP.

## Start here

`GET https://memstead.ai/agent` — how to read this graph (what it is, how to navigate it, how to talk to the user about it). The canonical entry point.

Then: `https://memstead.ai/overview` (the map), `https://memstead.ai/entities` (the complete index), `https://memstead.ai/entity/<id>` (one entity), `https://memstead.ai/schema` (the vocabulary). Every page links to the next — follow the links.

Two more: `https://memstead.ai/llms.txt` is this runbook itself, and `https://memstead.ai/.well-known/memstead-authority.json` is the discovery manifest — the authority, the mems it serves, and every endpoint URL.

Off-server hand-off: `memstead export --format html` writes any Memstead graph, this one included, to one self-contained page that opens in a browser with nothing installed.

The whole graph in one fetch: `https://memstead.ai/llms-full.txt` — every entity, its type, and its sections as a single Markdown document.

## MCP (capable clients) — search, write, a private sketch mem

There is no search on the HTML surface; to search this graph, or to write to one, attach the native streamable-HTTP MCP endpoint at `https://memstead.ai/mcp`. It reads this graph and mints a private, writable sketch mem per connection (watch it at the read-only live-view link the first `memstead_overview` response returns).
`claude mcp add --transport http memstead.ai https://memstead.ai/mcp`

Restart the agent session afterwards: a session that is already running does not attach an MCP server added while it runs.

## The wider project

- https://github.com/memstead/memstead — the source: the engine crates, the test suite, and PRIOR_ART.md.
- https://memstead.com — the project's main site.
- https://memstead.com/dev/ — the developer docs: getting started, the CLI reference, the schema format.
- https://memstead.io — the installer and the package registry: a browsable catalog of every published mem, each with its own page.
- https://memstead.io/api/index — the same catalog as JSON: every published mem, its scope, versions and size, in one request.
- https://memstead.io/install.sh — the one-line installer, fetched and piped to a shell.
- https://docs.rs/memstead-base — the engine's API documentation.
