brain_get_modifications

io.github.lonniev/personalbrain-mcp · Verify this server

The brain's authoritative, uncached change-log. Requires npub for credit billing. Unlike get_thought_graph and search (Azure-cached, stale for recent writes), this feed reflects every operation promptly — CREATED (101), DELETED (102), CHANGED_NAME (103), SET_TYPE (203), MOVED_LINK (402), etc. — with old→new values and timestamps. Use it for two things: 1. **Confirm a write landed** — after a mutation, query with start_time set to just before it and check for the matching entry. This is the authoritative read-after-write check (stronger than the cached graph, and it confirms deletes and type/link changes the graph hides). The heavy mutating tools also expose a ``confirm=True`` flag that does this for you. 2. **Discover recent / peer activity** — "what changed since T" so an agent can pick up where others left off. ⚠️ ``userId`` is the TheBrain *account* owner, shared by every agent using this operator's key — it distinguishes human-desktop vs API activity, NOT one agent from another. Peer discovery here is by time + content, not by author.