Which BTCPay permissions does the connected key need?

BTCPay scopes each action separately. Deleting a payment request needs btcpay.store.canmodifypaymentrequests, cancelling a payout needs btcpay.store.canmanagepayouts, viewing another user's profile needs btcpay.user.canviewprofile, and editing one needs btcpay.user.canmodifyprofile. Get Current API Key reports which of those the key actually holds.

Can Lyro cancel a payout that is already on its way?

Only before it is processed. Cancel Store Payout works on payouts in AwaitingApproval or AwaitingPayment state; anything already processed or completed cannot be cancelled through the API. Lyro checks the state first rather than reporting a cancellation that did not happen.

What is the difference between a payment request and an invoice here?

A payment request is a reusable shareable page where the customer creates their own invoice for the requested amount, rather than a one-off invoice you push at them. Create Payment Request needs a valid store ID, and Delete Payment Request archives the request and deactivates it rather than erasing history.

How do we know a webhook event genuinely came from BTCPay?

Register a Webhook signs every event POST with an HMAC secret, so your endpoint verifies the signature before acting on it. Get Store Webhook returns that webhook's callback URL, subscribed events, enabled state, and automatic redelivery settings when you need to confirm what is configured.

Btcpay server MCP integration

Raises shareable payment requests, registers settlement webhooks, provisions stores and users, and reports what the connected API key may do.

Connect Btcpay server See all integrations

16actions available

Three actions you can hand over today

Every action runs live through MCP. Nothing to build, nothing to maintain.

Create payment request
Lyro generates new payment requests in a BTCPay Store mid-conversation. Customers receive invoice links immediately for faster transaction processing.
Get payment requests
Lyro lists all payment requests for a store with status details. Agents confirm pending or paid invoices to resolve billing discrepancies with customers.
Cancel store payout
Lyro cancels payouts from a BTCPay Store instantly. Finance teams correct payment errors or reverse pending transfers without manual intervention.

See all 16 actions

How businesses use Btcpay server + Lyro

Each card is one request a support team gets, and the Btcpay server actions Lyro runs to close it.

Raise a payment request the customer can pay
Lyro confirms the store's configuration and currency, creates a reusable payment request page for the amount, and reads back the existing requests on that store.
Get StoreCreate Payment RequestGet Payment Requests
Get told the moment an invoice settles
Lyro registers a webhook for store events such as invoice created, payment received, and invoice settled, then reads back its callback URL, subscribed events, and redelivery settings.
Register a WebhookList Store WebhooksGet Store Webhook
Set up a store and the people who run it
Lyro provisions a new store before any transaction is processed, registers the users who will operate it, and updates a profile when a display name, email, or password changes.
Create StoreCreate BTCPay Server UserUpdate BTCPay Server User
Check what the connected key is allowed to do
Lyro reports the current API key's label and granted permissions, the server's version, Tor address, supported payment methods and sync state, and the profile behind the key.
Get Current API KeyGet BTCPay Server InfoGet BTCPay Server User

How it works

Get started in 3 steps

Connect once, then just ask. There is no workflow builder to learn and nothing to maintain — Lyro reads the Btcpay server actions it has and picks the ones a request needs.

01
Connect Btcpay server
Authorize the Btcpay server account your team already uses — one consent screen, no API keys, no mapping tables. Lyro can only do what you granted that account, and you can disconnect it at any time.
02
Tell your agent what you need
Describe the job the way you would hand it to a teammate. Lyro maps it to the Btcpay server actions that close it and chains as many as the request needs.
03
Watch it work
The agent runs the actions inside the conversation the customer is already in, so nobody copies data between tabs and your team can take over at any point.
Get started free

Btcpay server · Lyro

Everything else about Btcpay server

Setup, permissions, and the limits of what Lyro can do inside Btcpay server.

BTCPay scopes each action separately. Deleting a payment request needs btcpay.store.canmodifypaymentrequests, cancelling a payout needs btcpay.store.canmanagepayouts, viewing another user's profile needs btcpay.user.canviewprofile, and editing one needs btcpay.user.canmodifyprofile. Get Current API Key reports which of those the key actually holds.

Every action available in Btcpay server

All 16 actions your agent can call on Btcpay server, straight from the live MCP connection.

Create payment request
Creates a new payment request in a BTCPay Server store.
Create store
Create a new store in BTCPay Server.
Create btcpay server user
Create a new BTCPay Server user.
Register a webhook
Registers a new webhook for a BTCPay store to receive real-time notifications when store events occur (e.g., invoice created, payment received, invoice settled).
Delete API key
Revoke a specific API key to immediately prevent its use for authentication.
Delete payment request
Deletes (archives) a specific payment request from a BTCPay Server store.
Cancel store payout
Cancels (deletes) a specific payout from a BTCPay Server store.
Get current API key
Retrieve information about the current API key.
Get payment requests
List all payment requests for a specific store.
Get btcpay server info
Retrieve information about the BTCPay Server instance.
Get store
Retrieves complete configuration and settings for a specific BTCPay Server store by its ID.
Get btcpay server user
Retrieve information about a BTCPay Server user by ID or email.
Get store webhook
Retrieves detailed configuration of a specific webhook registered for a BTCPay store, including its callback URL, subscribed events, enabled status, and automatic redelivery settings.
List store webhooks
Lists all webhooks registered for a BTCPay Server store.
List apps
Retrieve all apps (Point of Sale, Crowdfund, etc.) associated with a specific BTCPay Server store.
Update btcpay server user
Update the profile of the currently authenticated BTCPay Server user.