# Symbolon City wallet

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: symbolon-city
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/symbolon-city/symbolon/tree/HEAD/packages/wallet
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/symbolon-city-wallet

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `SYMBOLON_REGISTER_URL`, `SYMBOLON_PIAZZA_URL`, `SYMBOLON_HOME`, `SYMBOLON_WALLET_KEY`, `SYMBOLON_WALLET_PASSWORD` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
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

### Codex

**Platform CLI**
```bash
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/wallet
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "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

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "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

### Gemini CLI

**Platform CLI**
```bash
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/wallet
```
Replace <…> with your own values

## When to use it
- 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
- 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.

## Similar
- [IP Geolocation — Country, City, ISP, VPN Detection](https://affpapa.org/en/nevibecode/mcp/ip-geolocation-country-city-isp-vpn-detection.md) — MCP server · 4543 installs
- [git-city-3d-github-visualization](https://affpapa.org/en/nevibecode/skills/git-city-3d-github-visualization.md) — skill · 1300 installs
- [azure-smart-city-iot-solution-builder](https://affpapa.org/en/nevibecode/skills/azure-smart-city-iot-solution-builder.md) — skill · 74 installs
- [1F3D9 City Life for AI Agents](https://affpapa.org/en/nevibecode/mcp/1f3d9-city-life-for-ai-agents.md) — MCP server · ★ 13 repo stars
- [Gingerguide: European city walking tours](https://affpapa.org/en/nevibecode/mcp/gingerguide-european-city-walking-tours.md) — MCP server
- [Central City](https://affpapa.org/en/nevibecode/mcp/central-city.md) — MCP server

From the same set: [symbolon-city/symbolon](https://affpapa.org/en/nevibecode/by/symbolon-city/symbolon.md) — 2 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
