English Français العربية

io.github.phaedo-labs/phaedo-mcp

Official registry AI and agents

Make AI apps answer your way, check with you before acting, and get approvals on your phone.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package phaedo-mcp
Claude Code 
claude mcp add phaedo-mcp -- npx -y phaedo-mcp@0.3.14
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "phaedo-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "phaedo-mcp@0.3.14"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Phaedo — your cognitive fingerprint, on every AI surface
  2. Quick start
  3. Design commitments
  4. What's not in this repo
  5. License

Phaedo — your cognitive fingerprint, on every AI surface

Phaedo learns how you think — communication style, working style, decision pattern — into a portable, user-owned cognitive fingerprint, and carries it to any AI tool. This repo is the open half of that system:

  • spec/ — Anamnesis (formerly "Phaedo Protocol"), the open cognitive-fingerprint standard: machine-readable JSON Schemas (fingerprint layers, consultation request/response, deference policies, receipts) + the conformance suite.
  • docs/protocol/ — the Anamnesis spec (v0.1), the MCP binding, and accepted proposals.
  • mcp/ — the reference MCP server (phaedo-mcp on npm): injects your fingerprint at session start and answers agent consultations — an agent at a decision point can ask "would my human proceed here?" and get a calibrated proceed / clarify / escalate / decline signal (or an honest abstain), gated by user-authored deference policies, with an encrypted on-device audit trail. On a blocking signal it can escalate to your paired phone in real time for a live approve / deny / modify, and your overrides teach the act-as-me channel — how you want delegated work handled, not just how you work yourself.

Quick start

npx phaedo-mcp        # run the server over stdio

Or wire it into Claude Desktop / Cursor / Claude Code automatically:

npm install -g phaedo-mcp
cd "$(npm root -g)/phaedo-mcp" && npm run setup

Your full fingerprint comes from the Phaedo phone app, learned on-device from your actual usage. The app isn't open to the public yet (phaedo.so has a link to hear when it is). Without it, if you use Claude Code, the server builds a starter profile on your computer from your own sessions (npm run setup:code-hook). With neither, it says plainly that there is no profile; it does not guess. To try it with a made-up example profile, set PHAEDO_FINGERPRINT=sample. See mcp/README.md for the full guide (the starter profile, trying the example, pairing, policies, receipts, the agreement metric).

Design commitments

  • User-owned & local. The fingerprint lives on your devices, encrypted; the server holds no plaintext at rest. Nothing is sent to any Phaedo service.
  • Signals out, never structure. Consultations return a signal + confidence — never fingerprint internals (spec §10.4).
  • Honest abstention. No coverage → insufficient_signal, not a confident guess.
  • User-authored guardrails win. Deference policies (§10.5) override any inferred signal; standing authorizations are explicit and auditable (§10.6).

What's not in this repo

The learning pipeline that builds fingerprints (conversation capture, on-device extraction models) is Phaedo's proprietary side. This repo is everything a client, agent, or independent producer needs to consume and interoperate: the spec, the schemas, and a complete reference server.

License

Apache-2.0. The Phaedo name and logo are trademarks; see phaedo.so.

Frequently asked questions

What is io.github.phaedo-labs/phaedo-mcp?

Make AI apps answer your way, check with you before acting, and get approvals on your phone.

How do I install io.github.phaedo-labs/phaedo-mcp?

It runs on your machine. In Claude Code: claude mcp add phaedo-mcp -- npx -y phaedo-mcp@0.3.14. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.phaedo-labs/phaedo-mcp need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.phaedo-labs/phaedo-mcp open source?

Yes. Its code is on GitHub under the Apache-2.0 license.

Who maintains io.github.phaedo-labs/phaedo-mcp?

It is published by phaedo-labs. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.