retospect/precis-mcp

precis-mcp

A Model Context Protocol server that gives language-model agents a small, uniform API for reading, writing, and searching across papers, documents, personal state, code, and cached tool calls. Small-model-friendly (7B-class agents are the design target); stores content in PostgreSQL with pgvector.

Status. v8.8.5 — see CHANGELOG.md for the live story. v5.2.6 on PyPI is the last v1-line release.

README is stale beyond this banner. Things the architecture section + verb table below still capture correctly: seven-verb surface, kind= dispatch, pgvector hybrid search, content kinds vs tool kinds. Things you should treat the ref-kinds list as a sample of, not a catalogue:

• The todo tree (Slices 1–5). kind='todo' is now a hierarchical task graph with parent_id, level gradient (strategic|tactical|recurring|subtask), PRIO column on refs, meta.auto_check wait-for-condition leaves, meta.schedule recurring spawn (Watches umbrella), and review tiers (nursery SQL-only hourly, structural 6h opus, deep_review weekly opus).
• kind='job' as child of kind='todo'. Slice 5: every new job requires parent_id pointing at a todo. The dispatch worker is the canonical path from meta.executor on a todo to a queued job.
• Worker consolidation. Two long-running worker daemons (precis worker --profile=system everywhere, --profile=agent on gateway) handle every pass betwe