Wdk MCP

Local-first MCP server for wallet development. Provides seed and wallet management, balance reads, and transaction sending — all on your machine. You can optionally expose the MCP endpoint via ngrok for remote LLMs. Seed phrases never leave your machine. 🔒

Features

Seed management: create, read, update, delete; wallets reference seeds
Wallet management: create, list, read, update, delete; add addresses
Balances: fetch balance for an address via configured network
Transactions: send transactions from a managed wallet
Local-first: state stored in wdk-data.json at the project root
Privacy: seed phrases are not sent to LLMs or remote services
Optional ngrok: expose http://localhost:8080/mcp to remote LLM providers

Requirements

Bun (recommended latest)
Optionally: NGROK_AUTHTOKEN if you want remote access

Setup

# Install dependencies
bun install

# (Optional) set ngrok auth token to expose publicly
export NGROK_AUTHTOKEN="<your-token>"

Run

# Start the MCP server
bun run src/index.ts

Server will listen at http://localhost:8080/mcp.

Web UI (optional)

A lightweight Next.js dashboard is included for managing seeds and wallets. 🖥️

cd src/webui
bun install
bun run dev

Then open http://localhost:3000.

Verify

On startup you should see a banner and a line with: FastMCP server running on http://localhost:8080
Data file path is logged as: Database ready at: <path>/wdk-data.json

Data Model

Stored in wdk-data.json
Top-level keys: seeds, wallets, apiKeys
Designed for local development; simple JSON store

Tools Reference

create_seed: create a new seed entry
list_seeds: list all seeds
get_seed: fetch a seed by id
update_seed: update seed metadata/phrase
delete_seed: remove a seed
create_wallet: create a wallet linked to a seed
list_wallets: list all wallets
get_wallet: fetch a wallet by id
add_wallet_address: attach an address to a wallet
update_wallet: update wallet metadata
delete_wallet: remove a wallet
get_balance: get balance for a specific address
send_transaction: send a transaction from a wallet
set_api_key: store an API key locally
get_api_key: retrieve a stored API key
list_api_keys: list stored API keys
delete_api_key: delete an API key
get_database_stats: basic counts and config path

Limitations

Data store is a plain JSON file and not encrypted at rest (yet) ⚠️
EVM/ETH-focused flows only; other chains not supported out of the box
No bridging or cross-chain protocols
Basic RPC provider configuration; no advanced retry/backoff logic
Minimal validation; use in dev environments only

Notes

Use Bun for all scripts and execution.
If the port 8080 is in use, stop the other process or change the port in src/index.ts.

MCP Servers

WDK MCP