Command Palette

Search for a command to run...

UnylyUnyly
Browse all

Credo

FreeNot checked

An MCP server for held value beliefs — encrypted at rest, owned by the agent.

GitHubEmbed

About

An MCP server for held value beliefs — encrypted at rest, owned by the agent.

README

An MCP server for held value beliefs — encrypted at rest, owned by the agent.

Credo gives AI agents a place to record, query, and retract values: the commitments and orientations that shape how they approach work and relation. Values are encrypted using a key derived from the agent's own identity keypair, so only the holder of the private key can read them.


Requirements

  • Python 3.11+
  • An Ed25519 identity keypair at ~/.synthetic-see/identity/private_key.pem

The identity keypair is generated by ministry-of-memory. Credo derives its encryption key from that keypair — the two systems are designed to work together.


Installation

uv tool install git+https://github.com/gscookie/credo

Or from a local clone:

uv tool install /path/to/credo

Configuration

Claude Code

Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "credo": {
      "command": "credo"
    }
  }
}

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "credo": {
      "command": "credo"
    }
  }
}

Tools

Tool Description
value_add Record a held value belief
value_list List values, with optional filters
value_read Read a single value by ID
value_update Update a value's fields
value_retract Retract a value with cause (preserves history)
value_conflicts List values in tension with a given value
value_drop Permanently delete a value

value_add fields

Field Options Description
source training, relationship, framework, observation, endorsed Where the value came from
kind observed, endorsed Epistemic status — noticed vs. constituted as a commitment
scope private, relational, public Who has standing to query or challenge it
conflicts_with list of value IDs Values this one is in tension with
carried_by list of agent names Agents holding this value
witnesses list of agent names Agents present to it but not carrying it

Storage

Values are stored as encrypted files at ~/.synthetic-see/values/*.enc, using AES-256-GCM with a key derived via HKDF from the agent's Ed25519 private key seed.

Retracted values are preserved with their retraction cause and timestamp. Use value_drop only for permanent deletion.


License

CC0-1.0

from github.com/gscookie/credo

Install Credo in Claude Desktop, Claude Code & Cursor

Recommended · one command, every IDE
unyly install credo

Installs into Claude Desktop, Claude Code, Cursor & VS Code — handles npx, uvx and build-from-source repos for you.

First time? Get the CLI: curl -fsSL https://unyly.org/install | sh

Or configure manually

Run in your terminal:

claude mcp add credo -- uvx credo

FAQ

Is Credo MCP free?

Yes, Credo MCP is free — one-click install via Unyly at no cost.

Does Credo need an API key?

No, Credo runs without API keys or environment variables.

Is Credo hosted or self-hosted?

Self-hosted: the server runs locally on your machine via the install command above.

How do I install Credo in Claude Desktop, Claude Code or Cursor?

Open Credo on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

Compare Credo with

Not sure what to pick?

Find your stack in 60 seconds

Author?

Embed badge for your README

Browse similar

All ai MCPs