manage_lightning
Manage Lightning
Manage Lightning Network operations for a store, including checking balance, creating invoices, paying invoices (BOLT11), and viewing channels. Requires a connected Lightning node.
Ask your agent in plain language. Each of these maps to a real tool on the server.
manage_lightning
Manage Lightning Network operations for a store, including checking balance, creating invoices, paying invoices (BOLT11), and viewing channels. Requires a connected Lightning node.
get_store_payment_methods
Discover payment method IDs and enabled status for a store. Call manage_stores with action list to find a store. Requires btcpay.store.canviewstoresettings.
manage_payment_requests
Create, list, update, or archive shareable payment requests. Payment requests are pages where customers can pay on their own schedule with automatic exchange rate updates. Useful for freelancers, invoicing, or requesting money.
manage_payout_claims
List, retrieve, create, approve, cancel, or mark store payouts as paid. Call manage_stores to discover stores. Approval requires the actual current revision from list or get; cancellation and marking paid do not transfer funds. Create requires btcpay.store.cancreatenonapprovedpullpayments, plus btcpay.store.cancreatepullpayments when approved is true; list/get require btcpay.store.canviewpayouts; approve/cancel/mark_paid require btcpay.store.canmanagepayouts.
get_notifications
Retrieve in-app notifications for the authenticated user. Covers events like invoice status changes, payouts, and version updates. Can filter by read/unread status and mark notifications as read.
refund_invoice
Issue a full or partial refund for a settled invoice. Returns a link where the customer can claim the refund. Supports different refund variants including original payment method, fiat, and custom amounts.
create_invoice
Create a new payment invoice for a store. Invoices are the primary way to accept cryptocurrency payments. Supports configurable amounts, currencies, order IDs, buyer emails, custom metadata, and expiration.
manage_pull_payments
Create, list, or archive pull payments. Pull payments are long-lived payment offers from which recipients can pull (claim) funds at their convenience. The merchant specifies the total amount and can approve partial or full claims. Useful for recipient-initiated payments and refunds.
get_current_user
Get the authenticated BTCPay Server user profile without requesting server information. Requires btcpay.user.canviewprofile.
manage_payouts
DEPRECATED — use `manage_payout_claims` instead. List, approve, cancel, or mark payouts as paid. Payouts represent claims against pull payments that need to be processed. Supports both on-chain and Lightning payouts.
manage_wallet
View on-chain wallet balance, list transactions, generate receive addresses, and create transactions for a store's wallet. Supports watch-only wallets and configured hot wallets.
get_server_info
Retrieve information about the BTCPay Server instance, including version, supported payment methods, and current user details.
manage_invoice
Update invoice metadata, archive or unarchive an invoice, or manually mark its status. Discover stores with manage_stores and invoices with get_invoices. Manual marking requires btcpay.store.canmanageinvoicestatus; metadata and archive operations require btcpay.store.canmodifyinvoices.
get_invoices
Retrieve a single invoice by ID or list invoices for a store with optional filtering by status, order ID, date range, and text search. Returns invoice details including status, amount, currency, and metadata.
manage_stores
Create, list, retrieve, update, or delete stores on a BTCPay Server instance. Each store operates as an independent tenant with its own settings, payment methods, and wallets.
Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.
{"mcpServers": {"metorial": {"url": "<your-magic-mcp-url>"}}}
claude mcp add --transport http metorial <your-magic-mcp-url>
codex mcp add metorial --url <your-magic-mcp-url>codex mcp login metorial
One governed layer for every app your agents reach, not a separate connector per tool.
Accept cryptocurrency payments with BTCPay Server. Manage stores, invoices, refunds, payment requests, pull payments, and payout claims. Inspect on-chain wallets and connected Lightning nodes, discover payment methods, and retrieve user profiles and notifications.
Common questions about connecting Btcpay Server to AI agents with Metorial.