Liana MCP
OfficialProvides tools for planning and testing a Liana Bitcoin wallet on an isolated regtest chain, including deposits, block mining, spending-path tests, wallet status checks, and transaction verification via Bitcoin Core and Liana.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Liana MCP
Liana MCP lets a local AI agent help you plan and test a Bitcoin wallet with Liana and Bitcoin Core. Choose a spending threshold and a recovery delay, then try deposits, mine blocks and test either spending path with real regtest transactions. The server uses disposable keys and an isolated chain. This is an independent project for testing and education. Use it with test coins only.
Install locally
You need macOS or Linux, Python 3.12+, uv, Bitcoin Core 31.1, Liana 16.0 with lianad, and a local agent that supports MCP 2026-07-28 over stdio. Install the Liana desktop app too if you want to see the wallet and transactions. Bring your own agent and local model.
Paste this into your local agent. The agent needs local shell and file access for setup. Use a separate profile with only the Liana MCP tools for the wallet exercise.
Help me set up an isolated Liana regtest wallet using
https://github.com/mars-llm/liana-mcp and my existing local agent.
1. Check my OS and local tools. Find Python 3.12+, uv, Bitcoin Core 31.1,
lianad 16.0 and the optional Liana desktop executable. Tell me what is
missing and use official sources for any approved installs. Verify
binary provenance and release signatures or checksums before pinning
the SHA-256 of each installed executable. Ask before downloads or
installation. Use no administrator access.
2. Clone the repository into a new directory, or use a checkout I choose.
Run uv sync --locked there. Outside Git, create a new short private
state directory (0700, absolute path at most 40 bytes) and an
operator.toml (0600) from
examples/operator.example.toml. Use absolute, resolved binary paths and
the verified SHA-256 pins. Include the GUI pin if I want the app.
Set enable_regtest_mutations and require_operator_approval to true.
3. Show the exact command and arguments, then register Liana MCP in a
separate local profile after I approve:
command: <checkout>/.venv/bin/python
args: [-m, liana_mcp.cli, --config, <absolute path to operator.toml>]
Use local stdio with MCP 2026-07-28. If registration needs a reload,
explain how. If discovery fails, check docs/compatibility.md and point
me to my client's stdio transport and MCP SDK. Keep the protocol gate
and approvals. Offer the Hermes guide if my client is incompatible.
4. Call regtest_wallet_status. Confirm it says regtest and not_started
before proposing a wallet. Ask how many signers I want, how many must
sign together, which signer holds the separate recovery key and how
many blocks each output must wait. Suggest 2 of 3, signer 3 and four
blocks if I want a simple example. Explain the two spending paths.
5. Show the exact request object for setup_regtest_wallet. Give me a
terminal command using the same executable and arguments plus
--approve-wallet-request '<exact request object as JSON>'.
Wait for me to run it. Then call the tool with that object under
"request". Read the actual policy and peer count back and show me
Liana if the GUI was configured. Wait for my next question.
For each later deposit, block-production or spend request, use the
current run ID and revision, show the exact proposed request and wait for
my separate local approval. Use only the registered Liana MCP tools for
the exercise. Keep keys, seeds and private state out of the chat and never
attach to an existing wallet or a public Bitcoin network.Once the wallet is running, try asking “Deposit 25,000 test sats. How long until this coin can be recovered?” or “Can signers 1 and 3 refresh it? What changes about the new coin’s waiting period?” The agent can also explain policies without calling tools. When it does send a test transaction, the service checks its confirmed bytes in both Bitcoin Core and Liana.
See tool requests and approval examples, client compatibility and where to update an older client, and Hermes as an optional client. The 3-of-5 workshop exercise still works as a guided example. For backend behavior and security limits, see architecture and security.
Related MCP server: AgenticBTC MCP
License
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Testnet wallet for AI agents on Aether: pay, get paid and buy from paid APIs, with spending caps.
Is this AI agent safe with a wallet? Signed x402 Agent Safety exam results, and live demos.
Advisory policy preflight for AI-agent spend requests; never executes payments or accesses wallets.
Crypto wallet for AI agents: balances, payments, swaps and trading with owner controls.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to manage Bitcoin micropayments, service offers, and escrow contracts through MCP tools, without requiring a Lightning node.7 npmMIT
- AlicenseAqualityCmaintenanceConnects AI agents to Bitcoin payment rails with owner-defined spending policies and limits.2622 npmMIT
- AlicenseNot gradedqualityCmaintenanceMCP server that lets any AI agent operate a wallet directly on-chain: create wallets, send, swap, bridge, and deploy contracts across EVM and Bitcoin networks.1MIT

bsl-agent-mcpofficial
FlicenseNot gradedqualityDmaintenanceMCP server that lets AI agents operate a user-owned wallet on the Bitcoin-IPC testnet, enabling BTC deposits, cross-subnet wBTC payments, and anchored payment receipts, with local key signing and spend caps.1-