WDK CLI

WDK CLI provides a local command-line wallet built with WDK. Use it to manage named wallets, derive addresses, read balances and history, send registered assets, and connect an MCP-compatible AI client to the same local wallet daemon.

Beta - This documentation describes @tetherto/wdk-cli@1.0.0-beta.1. Test integrations with a dedicated wallet and limited funds before relying on them.

Install

WDK CLI requires Node.js 22.18.0 or later.

Terminal

npm install -g --allow-scripts=@tetherto/wdk-cli @tetherto/wdk-cli@1.0.0-beta.1

The allowlist permits the CLI package's postinstall script, which installs the version-pinned wallet modules in its bundled network configuration.

Verify the installation:

Terminal

wdk --version

Install the scoped @tetherto/wdk-cli package. The unscoped wdk-cli package is not this CLI.

Installed Binaries

Binary	Purpose
`wdk`	Runs wallet, read, send, configuration, network, token, fiat-ramp, and MCP setup commands
`wdk-daemon`	Holds unlocked wallet instances and serves local wallet requests; `wdk` starts it when needed
`wdk-mcp`	Exposes WDK CLI wallet operations to MCP-compatible clients

Most users invoke wdk. The CLI and MCP integrations manage the other two binaries.

Command Map

Command	What it does
`wdk wallet`	Create, import, export, list, rename, delete, unlock, lock, and select wallets
`wdk get`	Derive addresses and read balances or transfer history
`wdk send`	Preview or broadcast native and registered-token transfers
`wdk buy`, `wdk sell`	Create MoonPay on-ramp or off-ramp URLs
`wdk config`	Read, update, reset, or locate local configuration
`wdk network`	Inspect built-in networks and manage custom networks
`wdk token`	Inspect built-in tokens and manage custom token entries
`wdk mcp`	Configure the bundled MCP server for Claude Desktop, Claude Code, or OpenClaw

Run wdk --help for the command map or append --help to a command:

Terminal

wdk wallet create --help
wdk get balance --help

Choose an Interface

Interface	Use it when
WDK CLI	A person, shell script, or local agent can run `wdk` commands
Bundled MCP server	An MCP-compatible client should call the CLI's structured wallet tools; automated setup supports Claude Desktop, Claude Code, and OpenClaw
MCP Toolkit	You are building and customizing an MCP server in code

The CLI and bundled MCP server use the same local wallet store and daemon. Review the security model before unlocking a funded wallet or giving another local process access to the MCP server.