credo

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