Skip to content

Integration · Payments

Connect Claude & ChatGPT to BTCPay Server

Ask your AI about the invoices, payments and payouts on your own BTCPay Server. It can find an invoice by order ID, show what was paid per payment method, and create new invoices and payment requests. It can also read your on-chain wallet balance and transactions, see sales from your point-of-sale apps, and create refunds with your approval.

Connect BTCPay Server free

Free plan, no credit card. Takes about a minute.

Try asking

  • “Has the invoice for order 1087 been paid?”

    The AI searches invoices by order ID, reads the status and shows the payments received per method.

  • “Create an invoice for 250 EUR for [email protected], order 1102.”

    It creates the invoice with amount, currency and the order ID and buyer email in the metadata.

  • “Make a payment request for the March consulting retainer.”

    It creates a payment request page with title, amount, currency and an optional expiry date.

What your AI can do

Invoices and payment requests

Search, create and read invoices, see payments per method, update metadata, and create or update payment requests.

Refunds and payouts

Create refunds for paid invoices, and list payouts and pull payments with their amount, destination and state.

Stores, wallet and apps

Read store settings, payment methods, exchange rates, on-chain wallet balance and transactions, and sales from your apps.

  • “Which invoices expired last week?”

    It searches invoices with status Expired within the date range and lists them.

  • “What is the on-chain wallet balance and what came in recently?”

    It finds the payment method, reads the wallet balance and lists recent wallet transactions.

  • “Refund invoice 7Hk2 at the rate the customer paid.”

    It creates a refund with the RateThen option. The customer claims it from a link, and money leaves your wallet.

27 tools for BTCPay Server

These tools are switched on when you connect. You can switch any of them off, or require your approval before it runs.

  • archive_invoiceDeletesArchive an invoice by `invoice_id` so it is hidden from the invoice list.
  • create_invoiceChanges dataCreate an invoice for a customer to pay, with `amount` and `currency` (store default if empty). Put details such as orderId or buyerEmail in `metadata`. Leave `amount` empty for a top-up invoice.
  • create_payment_requestChanges dataCreate a payment request page with `title`, `amount`, `currency`, optional `description`, `email`, `expiry_date` and `reference_id`.
  • get_appGet one app by `app_id`.
  • get_app_salesGet sales statistics for an app by `app_id` over the last `number_of_days`.
  • get_app_top_itemsGet the best-selling items of an app by `app_id`.
  • get_current_userGet the BTCPay Server user you are connected as.
  • get_exchange_ratesGet the store's current exchange rates, optionally for specific `currency_pair` values such as BTC_USD.
  • get_invoiceGet one invoice by `invoice_id`, with amount, currency, status and metadata.
  • get_invoice_paymentsGet the payment methods and payments received for an invoice by `invoice_id`, including amounts paid and due per method.
  • get_payment_requestGet one payment request by `payment_id`, with its amount, status and description.
  • get_payoutGet one payout by `payout_id`, with amount, destination and state.
  • get_storeGet one store's settings by its store ID (`message_id`).
  • get_wallet_overviewGet the on-chain wallet balance for a `payment_method_id` (see list_payment_methods).
  • list_appsList the store's apps, such as point-of-sale and crowdfund pages.
  • list_notificationsList your BTCPay notifications, optionally only unread ones with `seen` = false.
  • list_payment_methodsList the payment methods enabled on the store (for example on-chain BTC or Lightning) and their IDs.
  • list_payment_requestsList the store's payment requests (long-lived payment pages).
  • list_payoutsList the store's payouts (including refunds waiting to be paid), optionally with `include_cancelled`.
  • list_pull_paymentsList the store's pull payments (refund and payout links), optionally with `include_archived`.
  • list_storesList the stores you can access, with their IDs and default currency.
  • list_wallet_transactionsList on-chain wallet transactions for a `payment_method_id`, filtered by `status_filter` or `label_filter`.
  • mark_invoice_statusChanges dataManually mark an invoice by `invoice_id` as settled or invalid with `status`. Use only when a payment was handled outside BTCPay.
  • refund_invoiceMoves moneyCreate a refund for a paid invoice by `invoice_id`. `refund_variant` sets the amount: RateThen (crypto at the rate paid), CurrentRate, Fiat, OverpaidAmount or Custom (with `custom_amount` and `custom_currency`). The customer claims the refund from a link; this moves money.
  • search_invoicesSearch the store's invoices by `text_search`, `status` (New, Processing, Settled, Expired, Invalid), `order_id` or date range (`start_date`/`end_date` as Unix timestamps). Use this to find an invoice ID.
  • update_invoice_metadataChanges dataReplace the `metadata` of an invoice by `invoice_id`, e.g. order ID or buyer details.
  • update_payment_requestChanges dataUpdate a payment request by `payment_id`, e.g. `title`, `amount`, `description` or `expiry_date`.

Set up in three steps

  1. 1

    Pick the app

    Create a free PipMCP account and choose BTCPay Server from the app list.

  2. 2

    Paste your key

    Paste your BTCPay Server address (for example https://btcpay.example.com), an API key and your Store ID. In BTCPay Server, open Account > Manage account > API keys, click Generate key, tick only the permissions you need (for example view and create invoices, view stores) and copy the key.

  3. 3

    Add the link to your AI

    You get a personal MCP link. Add it to Claude, ChatGPT or Cursor:

    1. Click your name, then Settings › Connectors › Add custom connector.
    2. Paste your link as the Remote MCP server URL.
    3. Switch it on from the + menu in a chat.

Questions

What can the AI do in BTCPay Server?

It can search and read invoices and their payments, payment requests, payouts, pull payments, stores, payment methods, exchange rates, apps and their sales, notifications and on-chain wallet transactions. It can create invoices and payment requests, update invoice metadata and payment requests, mark or archive invoices, and create refunds.

Does the AI see my BTCPay Server API key?

No. You paste your BTCPay Server API key into PipMCP once. It is encrypted at rest, never shown to the AI and never shown again after you save it, not even to you. The AI only sees the results of the tools it calls.

Can I control what the AI is allowed to do?

Yes. You choose which tools are switched on, so you can start read-only. Creating a refund moves money, and marking an invoice as settled or invalid changes its status by hand. Both can require your approval before they run. Every tool call is logged.

Does it work with ChatGPT?

Yes. In ChatGPT, open Settings › Apps & Connectors › Advanced, turn on Developer mode and add your PipMCP link. Developer mode needs a paid ChatGPT plan: Plus, Pro, Business or Enterprise. The same link also works in Claude (Settings › Connectors › Add custom connector), Cursor and other MCP clients.

What does it cost?

PipMCP has a free plan, and you do not need a credit card to start. Paid plans are billed per completed task. You connect your own BTCPay Server account on your own server, and PipMCP connects to it with the API key you give it.

Does it work with my own BTCPay Server?

Yes. You enter the address of your own server together with the API key and Store ID, and PipMCP calls that server. The permissions you tick when you generate the key limit what the key can do, on top of the tools you switch on in PipMCP.

Let your AI work in BTCPay Server today.

Start free. Your key stays encrypted, and you decide what the AI may do.

Connect BTCPay Server free

PipMCP is not affiliated with BTCPay Server. Product names are trademarks of their owners.