Phaedrus

Phaedrus

An MCP server for the research feed: a curated literature-watch findings store and watchlist, plus a one-way, draft-only revenue seam into lupin (the revenue-alignment server, which owns its own ledger).

Phaedrus is a single Rust binary. It speaks MCP over stdio (NDJSON JSON-RPC) to the client and works on plain files under a data root — no database, no network listener.

How it runs

• Data root (findings store, watchlist, scan inbox): --root <path> or the RESEARCH_ROOT environment variable (default ~/workspace/research-feed-20261019).
• Lupin root (read-only — capability context and draft generation): --lupin-root <path> or LUPIN_ROOT (default ~/workspace/revenue-alignment-20261019).
• Writes are deliberately narrow: research_submit files a candidate into the scan inbox and never touches the curated store, and revenue_candidate_draft only drafts a lupin opportunity_submit payload — this server never writes lupin's files.

Tools

Tool	What it returns
capability_context	Lupin's capability registry (read-only) as planning vocabulary: capability ids + names, optionally keyword-filtered
feed_summary	Counts: findings by system/kind, systems watched, parse health
finding_get	One curated finding by id
finding_list	Curated findings, optionally filtered by system
research_submit	File a candidate (finding, roadmap item, or test proposal) into the scan inbox; never writes the curated store
revenue_candidate_draft	A draft lupin opportunity_submit payload for a revenue-shaped finding (drafts only)
watchlist_list	The watchlist (per-system venues and terms)

Client config

{
  "mcpServers": {
    "phaedrus": {
      "command": "/path/to/phaedrus",
      "args": []
    }
  }
}

Registry

server.json in this repo is the MCP Registry record for ai.qompass/phaedrus. The server is distributed as an MCPB bundle attached to the GitHub releases (Linux x64).

License

Apache-2.0 — see LICENSE.