Skip to main content
MCP server CX Codex

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

Install into Claude Code · Platform CLI All methods and platforms ↓
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/wallet
Open on GitHub

What 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/wallet

Replace <…> 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.

Similar MCP servers

MCP servers catalog →

From the same set2

Project sponsors

Companies that keep this analytics open