BTCPay Server MCP
by thomsendrakecommunityv0.3.0
The btcpay-mcp server allows AI agents to create invoices, manage stores, track payments, and check exchange rates through the BTCPay Server Greenfield REST API.
From the registry: 21 tools for AI agents to manage BTCPay Server: invoices, payments, stores, webhooks, Lightning
Install & configure
Prerequisites
- requiredBTCPay API keyGenerate an API key in your BTCPay Server (Account/Store → API Keys)https://btcpayserver.org/
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `btcpay-mcp` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **BTCPay API key** — Generate an API key in your BTCPay Server (Account/Store → API Keys) (https://btcpayserver.org/)
Canonical MCP server config (stdio transport):
- command: `uvx`
- args: ["btcpay-mcp"]
- required environment variables:
- `BTCPAY_BASE_URL`: Your BTCPay Server URL (example: `https://your-btcpay-server.com`)
- `BTCPAY_API_KEY`: BTCPay API key (example: `<placeholder>`)
- `BTCPAY_STORE_ID`: Default store ID (example: `<placeholder>`)
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Tools (21)
get_server_info
BTCPay Server version, sync status, supported methods
list_stores
List all stores accessible with the API key
get_store_info
Store configuration: currency, speed policy, checkout type
get_store_payment_methods
Enabled payment methods: on-chain, Lightning, etc.
create_invoice
Create a new invoice (amount, currency, order ID, description)
get_invoice
Invoice status, payments received, metadata, timing
list_invoices
List invoices with optional status filter
get_exchange_rate
Current BTC/fiat exchange rate from BTCPay
list_pull_payments
List pull payments (donations, subscriptions, payroll)
create_pull_payment
Create pull payment for donations, subscriptions, or payroll
list_payouts
List actual payout transactions (claims against pull payments)
list_payment_requests
List payment requests (reusable payment links)
create_payment_request
Create a payment request (persistent payment page)
Environment variables
BTCPAY_BASE_URLrequiredYour BTCPay Server URLBTCPAY_API_KEYrequiredAPI key from BTCPay ServerBTCPAY_STORE_IDrequiredDefault store ID for invoice operationsPrerequisites
- • Python 3.10+
Details
- Language
- Python
- License
- MIT
- Released
- Mar 29, 2026
- Last commit
- Mar 27, 2026
- Registry name
- xyz.draket/btcpay-mcp
Categories
Related Servers
edgar.tools SEC Intelligence
SEC filing intelligence — insider sentiment, material events, financial ratios, disclosure search.
2.5k
Edgartools
Open-source SEC EDGAR toolkit — 11 tools, 7 prompts, every filing type. No API key required.
2.5k
Mcp Stripe
MCP server for Stripe — global payments API (PaymentIntents, Checkout, Billing, Refunds)
1.6k