Integrations
Enables sending and receiving Bitcoin payments via the Lightning Network, creating payment requests, validating Lightning addresses, and managing Bitcoin transactions.
Provides tools for working with the Bitcoin Lightning Network, including sending payments to Lightning addresses, creating payment requests, and decoding charges.
⚠️ DEPRECATION NOTICE
🚨 This MCP Server is no longer maintained. 🚨
We’ve moved to a new and improved MCP Server implementation. All future updates, features, and support will be provided there.
👉 Please migrate to the new MCP Server here: https://github.com/zebedeeio/zbd-payments-typescript-sdk/tree/main/packages/mcp-server
This repo will remain available for reference, but is not recommended for production use.
ZBD MCP Server (deprecated -- use this instead: https://github.com/zebedeeio/zbd-payments-typescript-sdk/tree/main/packages/mcp-server)
Add Bitcoin powers to your LLM.
Base SDK
This MCP server uses the official TypeScript SDK -- https://github.com/modelcontextprotocol/typescript-sdk
Prerequisites
- Node.js 23+ (or Bun/Deno/Anything that supports running .ts files)
- Bun (for building executables)
- ZBD API key for payment processing
ZBD Setup
Get your API key from the ZBD Developer Dashboard and put it in a new .env
file under ZBD_API_KEY=XXXXXXXXXXXX
(check .env.example
for an example).
Once that's done run the pnpm build
command and setup the MCP server on your client (e.g. Claude Desktop or Cursor).
Installing Bun
If you don't have Bun installed, you can install it using one of the following methods:
macOS and Linux
Windows
Verify your installation by running:
Installation
Troubleshooting
- Use
ps aux | grep mcp-zbd | grep -v grep
to list all running ZBD MCP Server instances. - Use
pkill -f mcp-zbd
to kill any duplicate ZBD MCP Server instances that may linger.
Project Structure
This project demonstrates a modular approach to building MCP tools:
- Each tool is defined in its own TypeScript file in the
src
directory - Each tool can be built into a standalone executable in the
bin
directory - The main
index.ts
provides the actual tooling implementation
Available Tools
- ZBD (
src/zbd.ts
): ZBD API for global Bitcoin Lightning payments
Creating New Tool
To create a new tool:
- Create a new TypeScript file in the
src
directory (e.g.,src/mytool.ts
) - Use the existing tools as templates
- Add a build script to
package.json
:
- Update the
build:all
script to include your new tool
Usage
Building Executables
The resulting executables will be in the bin
directory and can be run directly:
Cursor Notes
When using these tools with Cursor, always use the full path to the executable:
Alternatively, you can run the TypeScript files directly with Node:
Testing
ZBD.ts Tools Available
The following tools are available in the ZBD MCP Server:
send-lightning-payment
- Send a Bitcoin Lightning Network payment to a Lightning Address using ZBDsend-gamertag-payment
- Send a Bitcoin payment to a ZBD Gamertagcreate-gamertag-charge
- Generate a payment request for a ZBD Uservalidate-lightning-address
- Verify the validity of a Lightning Addresscreate-lightning-charge
- Generate a payment request for a Lightning Addressget-userid-by-gamertag
- Retrieve User ID from a ZBD Gamertagget-gamertag-by-userid
- Retrieve ZBD Gamertag from a User IDsend-email-payment
- Send instant Bitcoin payments to any emailget-wallet-info
- Retrieve all data about a ZBD Project's Walletcheck-supported-region
- Verify if a user is coming from a supported regionget-zbd-ip-addresses
- Get the official IP addresses of ZBD serversinternal-transfer
- Performs a transfer of funds between two Projectscreate-withdrawal-request
- Create a Bitcoin withdrawal QR codeget-withdrawal-request
- Retrieve all data about a single Withdrawal Requestsend-payment
- Send a Bitcoin Lightning Network paymentget-payment
- Retrieve all data about a single Paymentdecode-charge
- Understand the inner properties of a Charge QR codecreate-charge
- Create a new Bitcoin Lightning Network chargeget-charge
- Retrieve all data about a single Chargecreate-voucher
- Create a single-use ZBD Voucher that can be redeemed by any ZBD userget-voucher
- Retrieve details about a ZBD Voucherredeem-voucher
- Redeem a ZBD Voucher to credit your Project walletrevoke-voucher
- Revoke a valid ZBD Voucher and reclaim the sats to your Project walletsend-batch-lightning-payments
- Send multiple Bitcoin Lightning Network payments to Lightning Addresses in a single request
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
A server that adds Bitcoin payment capabilities to LLMs, enabling sending/receiving payments, creating charges, managing wallets, and performing other Bitcoin Lightning Network operations.
Related MCP Servers
- AsecurityFlicenseAqualityA server that helps discover and analyze websites implementing the llms.txt standard, allowing users to check if websites have llms.txt files and list known compliant websites.Last updated -2837JavaScript
- AsecurityAlicenseAqualityA Model Context Protocol server that gives LLMs the ability to interact with Ethereum networks, manage wallets, query blockchain data, and execute smart contract operations through a standardized interface.Last updated -313232TypeScriptMIT License
- AsecurityAlicenseAqualityAn MCP server that enables LLMs to perform blockchain operations on the Base network through natural language commands, including wallet management, balance checking, and transaction execution.Last updated -441TypeScriptMIT License
- AsecurityAlicenseAqualityA Model Context Protocol server that enables LLMs to interact with web pages, take screenshots, generate test code, scrape web pages, and execute JavaScript in a real browser environment.Last updated -29101TypeScriptMIT License