SolidInvoice
Create and send invoices and quotes, manage clients, and track payments in SolidInvoice.
21 tools for AI agents to manage BTCPay Server: invoices, payments, stores, webhooks, Lightning
Lists are ordered by a usage score (out of 100) built from these parts
| Popularity | 0/80 | GitHub stars or weekly downloads: the larger counts 60, the smaller 20 |
|---|---|---|
| Freshness | 3/12 | Full marks for a release or code change within 30 days |
| Still answering | 0/8 | The cloud endpoint answered at the last check |
| Usage score | 3/100 |
Quality: Passed 2/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)
Pick the AI app you use, then copy the settings.
Passed 2/3 checks · Runs on your computer
First: which AI do you use?
Pick your app and the steps appear below.
Claude cannot connect BTCPay Server MCP yet
The maker has not listed install details in the MCP Registry yet
ChatGPT cannot connect BTCPay Server MCP yet
The maker has not listed install details in the MCP Registry yet
B · Others in Accounting, finance & tax that work with ChatGPT
Picked from the most used in the same category, only ones that connect by address with no key
Claude Code cannot connect BTCPay Server MCP yet
The maker has not listed install details in the MCP Registry yet
Cursor cannot connect BTCPay Server MCP yet
The maker has not listed install details in the MCP Registry yet
VS Code cannot connect BTCPay Server MCP yet
The maker has not listed install details in the MCP Registry yet
Runs on your computer; the tool list appears in your AI app after you install it.
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026
The publisher (draket.xyz) is not the repo owner (ThomsenDrake); someone else may have listed it
Code last changed 3 months ago
Uses MIT
This one runs on your computer; there is no internet endpoint
Runs on your computer and uses local settings instead
Runs on your computer; we can only read tool lists from internet endpoints
If you made this, paste this code into your README. The badge links back to this page.
[](https://mcp.popnx.com/en/servers/xyz-draket-btcpay-mcp)Ask, share a tip or report that it does not work. Sorted by what people marked helpful.
No posts yet. Be the first to ask or share.
Posts here are written by users, not the PopNx team.
No reviews yet
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
It passed 2 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
The registry does not list a required key, though some servers ask you to sign in on first use.
It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).
The GitHub repo last changed 3 months ago, and the latest version (0.3.0) reached the registry 8 months ago.
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code.
In the same category: SolidInvoice, Signal8, Journalit, Beancount.io, Tapetide - Indian Stock Market MCP
Same category, other makers, commands already checked. Official ones first, then by stars.
Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
Create and send invoices and quotes, manage clients, and track payments in SolidInvoice.
SEC filings, dilution, insider & institutional ownership, and political-trade data for AI agents.
Trading journal in Obsidian. Ask Claude or ChatGPT about your trades; edits are previewed first.
Query, edit, and reconcile a hosted Beancount ledger: BQL, reports, files, and bank imports.
48 tools for ~8,000 NSE & BSE stocks: quotes, screener, financials, filings, FII/DII, options
| This one BTCPay Server MCP | SolidInvoice | Signal8 | Journalit | Beancount.io | Tapetide - Indian Stock Market MCP | |
|---|---|---|---|---|---|---|
| Runs where | Installs on your computer | Runs in the cloud, nothing to install | Cloud or install on your computer | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Cloud or install on your computer |
| Needs a key | No | No | Yes | No | No | Yes |
| Add with + in Claude | No | No | No | No | No | No |
| Basic checks | 2/3 | 4/6 | 5/5 | 4/4 | 4/4 | 5/5 |
| License | MIT | MIT | MIT | NOASSERTION | MIT | MIT |
| Price | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry |
Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.
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
Add to your claude_desktop_config.json:
{
"mcpServers": { "btcpay-server": { "command": "uvx", "args": ["btcpay-mcp"], "env": { "BTCPAY_BASE_URL": "https://your-btcpay-server.com", "BTCPAY_API_KEY": "your-api-key", "BTCPAY_STORE_ID": "your-store-id" } } } }
claude mcp add btcpay-server -- uvx btcpay-mcp
Add to .cursor/mcp.json or .vscode/mcp.json:
{
"mcpServers": { "btcpay-server": { "command": "uvx", "args": ["btcpay-mcp"], "env": { "BTCPAY_BASE_URL": "https://your-btcpay-server.com", "BTCPAY_API_KEY": "your-api-key", "BTCPAY_STORE_ID": "your-store-id" } } } }
pip install btcpay-mcp
export BTCPAY_BASE_URL="https://your-btcpay-server.com" export BTCPAY_API_KEY="your-api-key" export BTCPAY_STORE_ID="your-store-id"
btcpay-mcp
Or with pip install from source:
git clone https://github.com/toplyrnarfur/btcpay-mcp.git
cd btcpay-mcp pip install -e ".[dev]" python -m btcpay_mcp.server
| Tool | Description |
|---|---|
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) |
get_payment_request | Get payment request details and status |
list_webhooks | List configured webhooks for payment event notifications |
create_webhook | Create a webhook for real-time payment notifications |
refund_invoice | Refund an invoice (creates pull payment) |
get_lightning_info | Lightning node info: alias, version, peers, channels, balance |
list_lightning_channels | List Lightning channels with capacity, balances, status |
get_wallet_balance | On-chain wallet balance (confirmed/unconfirmed) |
list_wallet_transactions | List on-chain wallet transactions |
Ask your AI agent:
| Prompt | What it does |
|---|---|
| "Create a $50 invoice for Order #1234" | Generates a BTC/Lightning invoice via BTCPay |
| "Show me all unpaid invoices" | Lists pending invoices across stores |
| "What payment methods does my store accept?" | Checks configured payment methods |
| "What's the BTC/USD rate right now?" | Fetches current exchange rate |
| "Show me the status of invoice inv_xxxx" | Retrieves full invoice details and payment status |
| "Set up a $100/month donation pull payment" | Creates a pull payment for recurring donations |
| "Create a payment request for my consulting service" | Creates a reusable payment link |
| "Show me my Lightning node info and balance" | Fetches LN alias, channels, and balances |
| "Check my on-chain wallet balance" | Gets confirmed/unconfirmed BTC wallet balance |
| "Set up a webhook for invoice settlements" | Creates a webhook for real-time payment notifications |
| "Refund invoice inv_xxxx" | Initiates a refund with configurable calculation method |
| Variable | Default | Description |
|---|---|---|
BTCPAY_BASE_URL | https://testnet.demo.btcpayserver.org | Your BTCPay Server URL |
BTCPAY_API_KEY | *(empty)* | API key from BTCPay Server |
BTCPAY_STORE_ID | *(empty)* | Default store ID for invoice operations |
All from the BTCPay Server Greenfield API v1:
GET /api/v1/server/info — server version and infoGET /api/v1/stores — list storesGET /api/v1/stores/{storeId} — store configurationGET /api/v1/stores/{storeId}/payment-methods — enabled payment methodsPOST /api/v1/stores/{storeId}/invoices — create invoiceGET /api/v1/stores/{storeId}/invoices — list invoicesGET /api/v1/stores/{storeId}/invoices/{invoiceId} — invoice detailsGET /api/v1/stores/{storeId}/invoices/{invoiceId}/payment-methods — payment addressesPOST /api/v1/stores/{storeId}/invoices/{invoiceId}/refund — refund invoiceGET /api/v1/stores/{storeId}/pull-payments — list pull paymentsPOST /api/v1/stores/{storeId}/pull-payments — create pull paymentGET /api/v1/stores/{storeId}/payouts — list payoutsGET /api/v1/stores/{storeId}/payment-requests — list payment requestsPOST /api/v1/stores/{storeId}/payment-requests — create payment requestGET /api/v1/stores/{storeId}/payment-requests/{id} — payment request detailsGET /api/v1/stores/{storeId}/webhooks — list webhooksPOST /api/v1/stores/{storeId}/webhooks — create webhookGET /api/v1/stores/{storeId}/lightning/{cryptoCode}/info — LN node infoGET /api/v1/stores/{storeId}/lightning/{cryptoCode}/balance — LN balanceGET /api/v1/stores/{storeId}/lightning/{cryptoCode}/channels — LN channelsGET /api/v1/stores/{storeId}/payment-methods/{pmId}/wallet — wallet balanceGET /api/v1/stores/{storeId}/payment-methods/{pmId}/wallet/transactions — wallet transactionsGET /api/v1/rates — exchange rates| Feature | btcpay-mcp | bitcoin-mcp (Bortlesboat) |
|---|---|---|
| Invoice creation | ✅ Yes | ❌ No |
| Store management | ✅ Yes | ❌ No |
| Payment lifecycle | ✅ Yes | ❌ No |
| Pull payments | ✅ Yes | ❌ No |
| Payment requests | ✅ Yes | ❌ No |
| Webhooks | ✅ Yes | ❌ No |
| Refunds | ✅ Yes | ❌ No |
| Lightning node info | ✅ Yes | ❌ No |
| Wallet management | ✅ Yes | ❌ No |
| Exchange rates | ✅ Yes (BTCPay) | ✅ Yes (Satoshi API) |
| Blockchain data | ❌ No | ✅ Yes (49 tools) |
| Node RPC | ❌ No | ✅ Yes (optional) |
| Merchant payments | ✅ Only option | ❌ No |
btcpay-mcp is complementary to blockchain data servers like bitcoin-mcp. Use both for complete Bitcoin coverage: blockchain data from bitcoin-mcp, payment processing from btcpay-mcp.
pip install -e ".[dev]"
pytest tests/ -v
All 77 tests pass with mock-based testing (no BTCPay instance needed).
BTCPAY_API_KEY environment variablehttps://testnet.demo.btcpayserver.org by defaultMIT