Agents - Ela

Ela is memory for agents that already speak MCP or HTTP. Search returns structured handles with provenance. Coverage on every response says what was searched and what was left out.

How to connect

Path	Use when
Local MCP	The vault is on this machine. Stdio. Indexes `private/`.
Cloud MCP	A remote agent. Streamable HTTP on the API host. Same tools, same auth as `/v1`.
HTTP API	Writes, filters, SDKs. Stable path `/v1`.
CLI `notes --remote`	A first-class client through `@elanotes/sdk`.

MCP tools are read-only. Agents write through the HTTP API, notes --remote, or the web review queue. Production origin: https://api.elanotes.com (/v1 and /mcp). Send a bearer. Local clone: http://127.0.0.1:4000 — see MCP cloud and CLI.

What every retrieval keeps

Citations, not dumps. Hits are pointers. Fetch only what you need.
Coverage. Searched count, named exclusions, why the set is partial. Silent gaps are the failure mode Ela refuses.
Determinism. Same query, same index_version and ranker_version, same hits.
Vault isolation. Every query is scoped to one vault_id.
Zero is valid. Empty results plus coverage beat padded noise.
private/ never leaks on cloud paths. Local MCP can see it. See Privacy.

Machine-readable entry

This host serves /llms.txt and /llms-full.txt. The wire contract is OpenAPI 3.1 (GET /openapi.json on the API; this site’s copy is the API reference). Typed clients: TypeScript SDK and Python SDK.