zano-mcp

MCP server for the Zano blockchain. Wraps Zano's daemon, wallet, and trade JSON-RPC APIs as MCP tools.

Installation

{
  "mcpServers": {
    "zano": {
      "command": "npx",
      "args": ["-y", "zano-mcp"],
      "env": {
        "ZANO_DAEMON_URL": "http://127.0.0.1:11211/json_rpc"
      }
    }
  }
}

Public node (zero setup):

{
  "mcpServers": {
    "zano": {
      "command": "npx",
      "args": ["-y", "zano-mcp"],
      "env": {
        "ZANO_DAEMON_URL": "http://37.27.100.59:10500/json_rpc"
      }
    }
  }
}

Full config (daemon + wallet + trade):

{
  "mcpServers": {
    "zano": {
      "command": "npx",
      "args": ["-y", "zano-mcp"],
      "env": {
        "ZANO_DAEMON_URL": "http://127.0.0.1:11211/json_rpc",
        "ZANO_WALLET_URL": "http://127.0.0.1:11212/json_rpc",
        "ZANO_TRADE_TOKEN": "your_trade_api_token"
      }
    }
  }
}

Configuration

All environment variables are optional with sensible defaults.

| Variable | Default | Description | |----------|---------|-------------| | ZANO_DAEMON_URL | http://127.0.0.1:11211/json_rpc | Daemon RPC endpoint | | ZANO_WALLET_URL | (none) | Wallet RPC endpoint. If unset, wallet tools are not registered | | ZANO_WALLET_AUTH | (none) | JWT secret for wallet RPC auth | | ZANO_TRADE_URL | https://api.trade.zano.org | Trade API base URL | | ZANO_TRADE_TOKEN | (none) | Trade API auth token. If unset, only public trade tools | | ZANO_NETWORK | mainnet | mainnet or testnet | | ZANO_LOG_LEVEL | info | debug, info, warn, error |

CLI args override env vars: --daemon-url, --wallet-url, --network, etc.

Feature Gating

Tools are conditionally registered based on what's configured:

| Config present | Tools available | |---------------|----------------| | Always | Daemon tools (15) + Public trade tools (2) | | ZANO_WALLET_URL | + Wallet (12) + Asset (7) + Swap (3) tools | | ZANO_TRADE_TOKEN | + Authenticated trade tools (7) |

Available Tools

Daemon Tools (15)

| Tool | Description | |------|-------------| | get_network_info | Network status (height, difficulty, hashrate, connections) | | get_height | Current blockchain height | | get_block_by_height | Block header at a given height | | get_block_by_hash | Block header by hash | | get_last_block | Latest block header | | get_block_details | Full block with transaction list | | get_transaction | Transaction details by hash | | get_transactions | Batch transaction lookup | | get_pool_info | Mempool status | | get_asset_info | Asset metadata by ID | | get_assets_list | All registered assets | | resolve_alias | Address for a Zano alias | | get_alias_by_address | Alias for an address | | search_blockchain | Search by hash/alias | | validate_signature | Verify a signed message |

Wallet Tools (12) - requires ZANO_WALLET_URL

| Tool | Description | |------|-------------| | get_balance | Wallet balance (all assets, human-readable) | | get_address | Wallet public address | | get_wallet_status | Sync status, watch-only flag | | transfer | Send ZANO or assets (human-readable amounts) | | get_recent_transactions | Recent transaction history | | search_transactions | Search by various criteria | | sign_message | Sign arbitrary data | | save_wallet | Persist wallet state | | make_integrated_address | Create with payment ID | | split_integrated_address | Decode integrated address | | get_mining_history | PoS staking rewards | | sweep_below | Consolidate small outputs |

Asset Tools (7) - requires ZANO_WALLET_URL

| Tool | Description | |------|-------------| | deploy_asset | Create a new asset | | emit_asset | Mint additional supply | | burn_asset | Burn tokens | | update_asset | Update metadata | | transfer_asset_ownership | Change asset owner | | whitelist_asset | Add to wallet whitelist | | remove_asset_from_whitelist | Remove from whitelist |

Swap Tools (3) - requires ZANO_WALLET_URL

| Tool | Description | |------|-------------| | create_swap_proposal | Create an ionic swap proposal | | get_swap_info | View proposal details | | accept_swap | Accept and execute a swap |

Trade Tools (2 public + 7 authenticated)

Public (always available):

| Tool | Description | |------|-------------| | get_trading_pair | Pair info by ID | | get_order_book | Order book with depth/spread |

Authenticated (requires ZANO_TRADE_TOKEN):

| Tool | Description | |------|-------------| | dex_authenticate | Authenticate with Trade API | | create_order | Create buy/sell order | | cancel_order | Cancel an order | | get_my_orders | Your active orders + tips | | apply_order | Match with another order | | confirm_trade | Confirm a trade | | get_active_trade | Get trade by order IDs |

Resources

| URI | Description | |-----|-------------| | zano://network/info | Current network configuration | | zano://assets/whitelist | Official asset whitelist |

Prompts

| Prompt | Description | |--------|-------------| | check-network | Generate a network status report | | analyze-order-book | Analyze order book for a pair | | explain-transaction | Explain a transaction in plain language | | swap-calculator | Calculate swap parameters |

Requirements

• Node.js >= 18
• A running Zano daemon (local or public node)
• Wallet RPC running if you want wallet/asset/swap tools
• Trade API token if you want authenticated DEX operations

Development

git clone https://github.com/PRavaga/zano-mcp.git
cd zano-mcp
npm install
ZANO_DAEMON_URL=http://37.27.100.59:10500/json_rpc npm run dev

License

MIT