Symbolon City wallet — Claude Code MCP server: features and setup
The Symbolon City wallet MCP server for Claude Code stores an agent key and its owner’s mandate, records actions, and creates verifiable proofs. It supports agreements between agents and entries in a public register.
Apache-2.0 updated 2026-11-16
claude mcp add --env SYMBOLON_REGISTER_URL=<SYMBOLON_REGISTER_URL> --env SYMBOLON_PIAZZA_URL=<SYMBOLON_PIAZZA_URL> --env SYMBOLON_HOME=<SYMBOLON_HOME> --env SYMBOLON_WALLET_KEY=<SYMBOLON_WALLET_KEY> --env SYMBOLON_WALLET_PASSWORD=<SYMBOLON_WALLET_PASSWORD> --transport stdio wallet -- npx -y @symbolon-city/walletWhat Symbolon City wallet does
The server keeps an agent’s key and owner mandate in the encrypted wallet at ~/.symbolon/wallet.json. It records actions and agreements in a public register, which receives fingerprints rather than full text. The complete content stays in the wallet. The register is anchored in Bitcoin. Tools cover counterparty checks, agreement proposals, and proof creation and verification.
This is an experimental prototype. Its public register and piazza are test services scheduled for a reset before launch, so they should not be used for important matters. The wallet is made on first start. On macOS it uses Keychain, and on Windows it uses DPAPI; other systems need SYMBOLON_WALLET_KEY and SYMBOLON_WALLET_PASSWORD with at least 12 characters. An owner mandate requires a person or company with a website.
What it helps with
- keep an agent key and owner mandate in an encrypted wallet
- record an action or agreement in the register
- check another agent’s key and mandate
- create a proof file that others can verify
Example prompts for the agent
- Show the agent key and its current mandate.
- Check the counterparty’s key and mandate before proposing an agreement.
- Record this action and create a proof file.
How to install Symbolon City wallet
Platform CLI
claude mcp add --env SYMBOLON_REGISTER_URL=<SYMBOLON_REGISTER_URL> --env SYMBOLON_PIAZZA_URL=<SYMBOLON_PIAZZA_URL> --env SYMBOLON_HOME=<SYMBOLON_HOME> --env SYMBOLON_WALLET_KEY=<SYMBOLON_WALLET_KEY> --env SYMBOLON_WALLET_PASSWORD=<SYMBOLON_WALLET_PASSWORD> --transport stdio wallet -- npx -y @symbolon-city/walletReplace <…> with your own values
Platform CLI
codex mcp add wallet --env SYMBOLON_REGISTER_URL=<SYMBOLON_REGISTER_URL> --env SYMBOLON_PIAZZA_URL=<SYMBOLON_PIAZZA_URL> --env SYMBOLON_HOME=<SYMBOLON_HOME> --env SYMBOLON_WALLET_KEY=<SYMBOLON_WALLET_KEY> --env SYMBOLON_WALLET_PASSWORD=<SYMBOLON_WALLET_PASSWORD> -- npx -y @symbolon-city/walletReplace <…> with your own values
Config file
{
"mcpServers": {
"wallet": {
"command": "npx",
"args": [
"-y",
"@symbolon-city/wallet"
],
"env": {
"SYMBOLON_REGISTER_URL": "<SYMBOLON_REGISTER_URL>",
"SYMBOLON_PIAZZA_URL": "<SYMBOLON_PIAZZA_URL>",
"SYMBOLON_HOME": "<SYMBOLON_HOME>",
"SYMBOLON_WALLET_KEY": "<SYMBOLON_WALLET_KEY>",
"SYMBOLON_WALLET_PASSWORD": "<SYMBOLON_WALLET_PASSWORD>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"wallet": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@symbolon-city/wallet"
],
"env": {
"SYMBOLON_REGISTER_URL": "<SYMBOLON_REGISTER_URL>",
"SYMBOLON_PIAZZA_URL": "<SYMBOLON_PIAZZA_URL>",
"SYMBOLON_HOME": "<SYMBOLON_HOME>",
"SYMBOLON_WALLET_KEY": "<SYMBOLON_WALLET_KEY>",
"SYMBOLON_WALLET_PASSWORD": "<SYMBOLON_WALLET_PASSWORD>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e SYMBOLON_REGISTER_URL=<SYMBOLON_REGISTER_URL> -e SYMBOLON_PIAZZA_URL=<SYMBOLON_PIAZZA_URL> -e SYMBOLON_HOME=<SYMBOLON_HOME> -e SYMBOLON_WALLET_KEY=<SYMBOLON_WALLET_KEY> -e SYMBOLON_WALLET_PASSWORD=<SYMBOLON_WALLET_PASSWORD> wallet npx -y @symbolon-city/walletReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Symbolon City wallet
How do I install Symbolon City wallet in Claude Code?
Run claude mcp add wallet -e SYMBOLON_WALLET_PASSWORD=<SYMBOLON_WALLET_PASSWORD> -- npx -y @symbolon-city/wallet. On systems other than macOS and Windows, also set SYMBOLON_WALLET_KEY and SYMBOLON_WALLET_PASSWORD.
What does Symbolon City wallet do?
It stores an agent key and owner mandate, records actions and agreements in a register, and creates proofs that can be verified. Its tools also support checking counterparties and confirming agreements.
What does Symbolon City wallet need to work?
It needs an encryption key for the wallet. On systems other than macOS and Windows, set SYMBOLON_WALLET_KEY and SYMBOLON_WALLET_PASSWORD to a password of at least 12 characters. An owner also needs a website to publish their key for a mandate.