Credo
FreeNot checkedAn MCP server for held value beliefs — encrypted at rest, owned by the agent.
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
Install Credo in Claude Desktop, Claude Code & Cursor
unyly install credoInstalls 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 credoFAQ
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
Fetch
Web content fetching and conversion for efficient LLM usage.
AWS KB Retrieval
Retrieval from AWS Knowledge Base using Bedrock Agent Runtime.
by modelcontextprotocolSpring AI MCP Server
Provides auto-configuration for setting up an MCP server in Spring Boot applications.
llm-analysis-assistant
A very streamlined mcp client that supports calling and monitoring stdio/sse/streamableHttp, and can also view request responses through the /logs page. It also
by xuzexin-hzCompare Credo with
Not sure what to pick?
Find your stack in 60 seconds
Author?
Embed badge for your README
Browse similar
All ai MCPs
