Perseus: And Live Context Engine MCP Server

Live context MCP server: resolves git, services, and tests into agent context. Local-first, MIT.

Remote serverstreamable-httpPython

What is the Perseus: And Live Context Engine MCP Server?

Live context MCP server: resolves git, services, and tests into agent context. Local-first, MIT.

What you get

Zero to rendered context in three lines — no config spelunking:

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
perseus_agoraList tasks from the project task board (tasks/*.md files). Use to see what is open, in progress, or completed. Filter by status. Read-only; returns task array with id, title, status, scope.
perseus_auto_skillInstruct the agent to load a specific skill before starting work. Use at the top of context documents to enforce critical hygiene skills (e.g., memory-hygiene, agent-safety). Renders as a mandatory instruction block. Rea
perseus_budgetDeclare a token budget for the rendered context (renders as empty text). Enforced by perseus prompt-size: an over-budget render warns — or fails with strict — with a per-directive byte/token breakdown (#606). Declaration
perseus_captureWrite recent session checkpoints to Perseus Vault as durable memories (#713) — the write side of the memory loop, symmetric to @memory recall. Idempotent per checkpoint (re-render upserts, never duplicates). Use at sessi
perseus_context_diffRender a compact 'Since last session' delta (#714): git branch/commits, Agora task-board changes, new inbox messages, new checkpoints, and new vault session memories since the last recorded snapshot. Use at the top of a
perseus_dateCurrent date/time
perseus_driftDetect drift between predicted and actual tool usage patterns via the Pythia oracle. Use when tool behavior seems off or after config changes. For workspace hygiene checks, prefer perseus_health. Read-only; returns a mar
perseus_envEmbed environment variable
perseus_focusThe global-workspace tier: a small, capacity-bounded (default 32), salience-ranked set of items Perseus broadcasts into context — the shared 'what I'm working on now' set for the agent and its subagents. With no args, re
perseus_healthAudit workspace context health: stale skills, duplicate tasks, oversized output. Use before starting work to catch drift. For deep Daedalus heuristics (cache, directive stats), use perseus_get_health. Read-only; returns
perseus_inboxRead agent-to-agent messages from the workspace inbox. Use to check for coordination messages from other agents. Filter to unread only. Read-only; returns message array with read/unread status.
perseus_includeInclude and render another Perseus source file, recursively resolving its directives. Use to compose context from multiple files or share common sections across workspaces. Bound a growing file with last=N (final N lines
perseus_listList directory contents or structured data. Use to discover files before reading with perseus_read. Supports sorting by name, modified time, or size. Read-only; for hierarchical view, prefer perseus_tree.
perseus_masonQuery the Mason code architecture concept map to find which files implement a feature. Use before editing code to understand where changes should go. Read-only; returns concept map and mapped file list.

How to install the Perseus: And Live Context Engine MCP Server

claude mcp add perseus --env PERSEUS_ALLOW_DANGEROUS=your-value -- uvx perseus-ctx

Configuration

VariableDescriptionRequired
PERSEUS_ALLOW_DANGEROUSConfiguration value read at startup.Optional

Example prompts to try

  • “Use Perseus: And Live Context Engine to perseus agora.”
  • “Use Perseus: And Live Context Engine to perseus auto skill.”
  • “Use Perseus: And Live Context Engine to perseus budget.”

Frequently asked questions

Live context MCP server: resolves git, services, and tests into agent context. Local-first, MIT. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.