# Phaedrus

> Phaedrus is an open-source MCP server for knowledge and memory. Local research-feed server for literature-watch findings and draft-only revenue ideas. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Linux, CLI, self-hosted
- **Website:** https://qompass.ai/solutions/phaedrus/
- **Repository:** https://github.com/qompassai/phaedrus
- **MCP Registry name:** ai.qompass/phaedrus
- **Categories:** knowledge and memory, analytics and data
- **Listing updated:** 2026-11-14

## About

Phaedrus is a single Rust binary that works on plain files, with no database and no network listener. It speaks MCP over stdio and reads a data root holding a curated findings store, a watchlist and a scan inbox, set with --root or RESEARCH_ROOT.

Writes are narrow by design. research_submit files a candidate finding, roadmap item or test proposal into the scan inbox without touching the curated store. revenue_candidate_draft only drafts an opportunity_submit payload for lupin, a sister revenue-alignment server that owns its own ledger and is read-only from here. capability_context exposes lupin's capability registry as planning vocabulary.

It comes from Qompass AI. The release is an MCPB bundle for Linux x64 under Apache-2.0.

## Features

- **Curated findings store:** Reads individual findings or lists them by system.
- **Watchlist:** Lists per-system venues and terms being watched.
- **Feed summary:** Counts findings by system and kind and reports parse health.
- **Inbox submissions:** Files candidates into the scan inbox without altering curated data.
- **Draft-only revenue seam:** Drafts payloads for lupin and never writes its files.
- **File-based and offline:** Runs as one binary over stdio with no database.

## Good for

- Review curated literature-watch findings for a system
- Check which venues and terms are on the watchlist
- Submit a candidate finding or test proposal for review
- Draft a revenue opportunity from a finding

## Install

### Claude Code (Terminal)

```sh
claude mcp add phaedrus -- npx -y https://github.com/qompassai/phaedrus/releases/download/v1.0.0/phaedrus-mcp-1.0.0-linux-x64.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "phaedrus": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/qompassai/phaedrus/releases/download/v1.0.0/phaedrus-mcp-1.0.0-linux-x64.mcpb"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "phaedrus": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/qompassai/phaedrus/releases/download/v1.0.0/phaedrus-mcp-1.0.0-linux-x64.mcpb"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "phaedrus": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/qompassai/phaedrus/releases/download/v1.0.0/phaedrus-mcp-1.0.0-linux-x64.mcpb"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "phaedrus": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/qompassai/phaedrus/releases/download/v1.0.0/phaedrus-mcp-1.0.0-linux-x64.mcpb"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "phaedrus": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/qompassai/phaedrus/releases/download/v1.0.0/phaedrus-mcp-1.0.0-linux-x64.mcpb"
      ]
    }
  }
}
```

## Tools

- `capability_context`: Returns lupin's capability registry as planning vocabulary, optionally filtered.
- `feed_summary`: Returns counts of findings by system and kind, systems watched and parse health.
- `finding_get`: Returns one curated finding by id.
- `finding_list`: Lists curated findings, optionally by system.
- `research_submit`: Files a candidate into the scan inbox.
- `revenue_candidate_draft`: Drafts an opportunity_submit payload for a revenue-shaped finding.
- `watchlist_list`: Lists the watchlist of venues and terms.

## FAQ

### Does it need a database?

No. It works on plain files under a data root.

### Can it modify the curated store?

No. research_submit only writes to the scan inbox.

### What platforms are released?

The release bundle is built for Linux x64.

### What licence applies?

Apache-2.0.

### Is Phaedrus free?

Yes. Phaedrus is open source, so you can use and self-host it for free.

### How do I add Phaedrus to Claude Code?

Run this command in your terminal: claude mcp add phaedrus -- npx -y https://github.com/qompassai/phaedrus/releases/download/v1.0.0/phaedrus-mcp-1.0.0-linux-x64.mcpb

### What are the best alternatives to Phaedrus?

The closest alternatives to Phaedrus are Codebase Memory, XERJ, Agent-Native Analytics, Claude Code Ultimate Guide and Google Ads + Meta Ads + SEO/GEO MCP.

## Alternatives

- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.

---
Source: https://ai-powered.com/mcp/phaedrus
