# btcpay-mcp

Source: https://glimind.com/server/pypi%2Fbtcpay-mcp
Registry id: `pypi/btcpay-mcp`
Status: unknown

## Install

```json
{
  "mcpServers": {
    "btcpay-mcp": {
      "command": "uvx",
      "args": [
        "btcpay-mcp"
      ]
    }
  }
}
```

Claude Code:

```sh
claude mcp add btcpay-mcp -- uvx btcpay-mcp
```

## Tools (21)

- `create_invoice`: Create a new invoice (amount, currency, order ID, description)
- `create_payment_request`: Create a payment request (persistent payment page)
- `create_pull_payment`: Create pull payment for donations, subscriptions, or payroll
- `create_webhook`: Create a webhook for real-time payment notifications
- `get_exchange_rate`: Current BTC/fiat exchange rate from BTCPay
- `get_invoice`: Invoice status, payments received, metadata, timing
- `get_lightning_info`: Lightning node info: alias, version, peers, channels, balance
- `get_payment_request`: Get payment request details and status
- `get_server_info`: BTCPay Server version, sync status, supported methods
- `get_store_info`: Store configuration: currency, speed policy, checkout type
- `get_store_payment_methods`: Enabled payment methods: on-chain, Lightning, etc.
- `get_wallet_balance`: On-chain wallet balance (confirmed/unconfirmed)
- `list_invoices`: List invoices with optional status filter
- `list_lightning_channels`: List Lightning channels with capacity, balances, status
- `list_payment_requests`: List payment requests (reusable payment links)
- `list_payouts`: List actual payout transactions (claims against pull payments)
- `list_pull_payments`: List pull payments (donations, subscriptions, payroll)
- `list_stores`: List all stores accessible with the API key
- `list_wallet_transactions`: List on-chain wallet transactions
- `list_webhooks`: List configured webhooks for payment event notifications
- `refund_invoice`: Refund an invoice (creates pull payment)

Measured by Glimind (https://glimind.com): MCP handshake + tool list only, no tool is ever called. CC BY 4.0.
