BTCPay Server MCP
Connects Claude directly to your BTCPay Server instance through the Greenfield REST API. You get 21 tools covering the full merchant payment stack: create and track invoices, manage stores and payment methods, set up pull payments for donations or subscriptions, configure webhooks for payment notifications, and handle refunds. Also exposes Lightning node operations (channels, balances, peer info) and on-chain wallet management. This fills the merchant payment gap that blockchain data servers don't touch. If you're running BTCPay and want your AI to handle payment processing tasks instead of just querying the blockchain, this is the only MCP server built for that workflow.
- tools
- 21
- last updated
- Mar 29, 2026
Tools
21 toolsPublic tool metadata for what this MCP can expose to an agent.
get_server_infoBTCPay Server version, sync status, supported methods
BTCPay Server version, sync status, supported methods
No parameter schema in public metadata yet.
list_storesList all stores accessible with the API key
List all stores accessible with the API key
No parameter schema in public metadata yet.
get_store_infoStore configuration: currency, speed policy, checkout type
Store configuration: currency, speed policy, checkout type
No parameter schema in public metadata yet.
get_store_payment_methodsEnabled payment methods: on-chain, Lightning, etc.
Enabled payment methods: on-chain, Lightning, etc.
No parameter schema in public metadata yet.
create_invoiceCreate a new invoice (amount, currency, order ID, description)
Create a new invoice (amount, currency, order ID, description)
No parameter schema in public metadata yet.
get_invoiceInvoice status, payments received, metadata, timing
Invoice status, payments received, metadata, timing
No parameter schema in public metadata yet.
list_invoicesList invoices with optional status filter
List invoices with optional status filter
No parameter schema in public metadata yet.
get_exchange_rateCurrent BTC/fiat exchange rate from BTCPay
Current BTC/fiat exchange rate from BTCPay
No parameter schema in public metadata yet.
list_pull_paymentsList pull payments (donations, subscriptions, payroll)
List pull payments (donations, subscriptions, payroll)
No parameter schema in public metadata yet.
create_pull_paymentCreate pull payment for donations, subscriptions, or payroll
Create pull payment for donations, subscriptions, or payroll
No parameter schema in public metadata yet.
list_payoutsList actual payout transactions (claims against pull payments)
List actual payout transactions (claims against pull payments)
No parameter schema in public metadata yet.
list_payment_requestsList payment requests (reusable payment links)
List payment requests (reusable payment links)
No parameter schema in public metadata yet.
create_payment_requestCreate a payment request (persistent payment page)
Create a payment request (persistent payment page)
No parameter schema in public metadata yet.
get_payment_requestGet payment request details and status
Get payment request details and status
No parameter schema in public metadata yet.
list_webhooksList configured webhooks for payment event notifications
List configured webhooks for payment event notifications
No parameter schema in public metadata yet.
create_webhookCreate a webhook for real-time payment notifications
Create a webhook for real-time payment notifications
No parameter schema in public metadata yet.
refund_invoiceRefund an invoice (creates pull payment)
Refund an invoice (creates pull payment)
No parameter schema in public metadata yet.
get_lightning_infoLightning node info: alias, version, peers, channels, balance
Lightning node info: alias, version, peers, channels, balance
No parameter schema in public metadata yet.
list_lightning_channelsList Lightning channels with capacity, balances, status
List Lightning channels with capacity, balances, status
No parameter schema in public metadata yet.
get_wallet_balanceOn-chain wallet balance (confirmed/unconfirmed)
On-chain wallet balance (confirmed/unconfirmed)
No parameter schema in public metadata yet.
list_wallet_transactionsList on-chain wallet transactions
List on-chain wallet transactions
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageReadme
btcpay-mcp
MCP server for BTCPay Server — let AI agents create invoices, manage stores, track payments, and check exchange rates through the Greenfield REST API.
21 tools · MIT licensed · Zero hardcoded credentials
The only MCP server for BTCPay Server. While other Bitcoin MCP servers cover blockchain data and node RPC,
btcpay-mcpis the first to expose full merchant payment processing — invoice creation, store management, pull payments, payment requests, Lightning operations, wallet management, webhooks, and exchange rates — to AI agents.
pip install btcpay-mcp
Quick Start
Claude Desktop
Add to your claude_desktop_config.json:
Details
- Repository
- github.com/thomsendrake/btcpay-mcp
- Website
- pypi.org/project/btcpay-mcp
- Registry
- MCP registry, active