MCP

Persome exposes local capture context, durable personal memory, model structure, and explicit correction through the Model Context Protocol. MCP runs either in the daemon over streamable HTTP or as a per-client stdio process.

Start

persome start
# http://127.0.0.1:8742/mcp

# or
persome mcp

Example stdio client configuration:

{
  "mcpServers": {
    "persome": {
      "command": "persome",
      "args": ["mcp"]
    }
  }
}

Core tools

Tool	Purpose
list_memories	List durable Markdown memory files.
read_memory	Read one memory file with time, tag, and tail filters.
search	Search durable memory with BM25 and optional dense retrieval.
read_receipt	Resolve a memory entry to its provenance.
recent_activity	Read recent durable event entries.
behavior_patterns	Read modeled behavioral patterns and their support.
get_model_snapshot	Return the versioned Point/Line/Face/Volume/Root model snapshot.
entity_graph	Read the entity/relation graph; retained as a compatibility model view.
verify_fact	Check a claim against current and superseded memory.
remember	Append an explicit, auditable memory.
correct_memory	Supersede or revoke memory through the correction workflow.

Capture and state tools

Tool	Purpose
current_context	Return recent capture headlines, full text, and timeline blocks.
search_captures	Search the local capture index.
read_recent_capture	Read an exact returned file_stem or nearest recent capture, with screenshot opt-in.
attention_trajectory	Read the derived attention path used by state formation.
get_schema	Return the Markdown memory schema.

Transport

[mcp]
auto_start = true
transport = "streamable-http"
host = "127.0.0.1"
port = 8742

• streamable-http is the daemon default at /mcp.
• sse is a legacy transport.
• stdio is started explicitly with persome mcp.

Security and privacy

• The HTTP transport is loopback-only by default.
• MCP returns local personal data, including raw screen text from capture tools; only connect trusted clients.
• The MCP server does not forward results to a model provider by itself. A connected agent may do so, and Persome Chat sends invoked tool results to its configured ANTHROPIC_BASE_URL.
• Screenshots are excluded unless a tool call explicitly requests one.
• get_model_snapshot redacts detectable secrets and local paths by default.
• Write tools are explicit and auditable; the removed computer-use tools are not part of this server.

The same loopback ASGI app serves /model and the Chat REST routes. The Runtime does not ship a browser Chat page; persome chat is its interactive client.