Get started

BTCPay Server for AI agents

BTCPay Server is a self-hosted, open-source payment processor that lets a merchant accept Bitcoin directly, without a payment company sitting in between. Connect it once through Arc0, and your agent, or Claude, ChatGPT and Cursor, can use it through one MCP endpoint, limited to what each user approved.

Connect BTCPay ServerSee the 16 actions ↓
Finance and accountingAPI keyMCP + RESTbtcpayserver.org
AUDIT LOG · BTCPAY SERVERPOLICY: acme-support
09:41:07 · claude · u_8f2read
btcpay_server.list_apps
List Apps✓ allowed · 212ms
09:41:08 · claude · u_8f2read
btcpay_server.get_user
Get BTCPay Server User✓ allowed · 164ms
09:41:09 · claude · u_8f2write
btcpay_server.create_user
Create BTCPay Server User✓ approved · approved by user
09:41:12 · claude · u_8f2destructive
btcpay_server.delete_payout
Cancel Store Payout✕ blocked · policy: deny
EVERY BTCPAY SERVER CALL, ON THE RECORD
01 · USE CASES

What agents do in BTCPay Server.

01

Create a Bitcoin payment request

Generate a new payment request for an invoice, with the store and amount already attached.

02

Check pending payment requests

Pull the list of open payment requests for a store before following up with customers.

03

Confirm before canceling a payout

Confirm before canceling a pending store payout, since it cannot be reversed once approved.

02 · ACTIONS

16 BTCPay Server actions, graded by risk.

Every BTCPay Server action is tagged read, write or destructive, so one policy covers the whole app and new actions inherit the right default.

read

8

Look things up. Allowed by default.

  • btcpay_server.get_user
    Get BTCPay Server User
  • btcpay_server.get_store
    Get Store
  • btcpay_server.list_apps
    List Apps
  • btcpay_server.get_webhook
    Get Store Webhook
  • btcpay_server.get_api_keys
    Get Current API Key
  • btcpay_server.get_webhooks
    List Store Webhooks
  • btcpay_server.get_server_info
    Get BTCPay Server Info
  • btcpay_server.get_payment_requests
    Get Payment Requests

write

5

Create and change things. Allow, or ask the user first.

  • btcpay_server.create_user
    Create BTCPay Server User
  • btcpay_server.update_user
    Update BTCPay Server User
  • btcpay_server.create_store
    Create Store
  • btcpay_server.create_webhook
    Register a Webhook
  • btcpay_server.create_payment_request
    Create Payment Request

destructive

3

Delete, cancel or archive. Ask first, or deny outright.

  • btcpay_server.delete_payout
    Cancel Store Payout
  • btcpay_server.delete_api_key
    Delete API Key
  • btcpay_server.delete_payment_request
    Delete Payment Request
03 · HOW IT WORKS

BTCPay Server in three steps.

  1. 01Your users connect BTCPay ServerThey add their BTCPay Server api key on Arc0 Connect, under your brand. It goes straight into the vault.
  2. 02You set the rulesReads run, writes like “create BTCPay Server User” can wait for the user, and “cancel Store Payout” can be denied outright.
  3. 03Any agent can actYour agent calls BTCPay Server through the Arc0 SDK or MCP, and so can Claude, ChatGPT and Cursor. Every call lands on the audit log.
POLICY.TS
await arc0.policies.set('btcpay_server', {
  read: 'allow',
  write: 'ask',        // create_user
  destructive: 'deny',  // delete_payout
})

# Claude Code: the same connection, one URL
$ claude mcp add --transport http arc0 \
    https://mcp.arc0.ai/u/u_8f2
04 · AUTH AND DATA

How BTCPay Server connects.

Users add their BTCPay Server api key on Arc0 Connect. It is encrypted in the vault, never shown to the model, and each user can rotate or revoke it at any time.

The same BTCPay Server connection serves your agent over MCP and your own backend over REST and the proxy, so a user connects once. How Arc0 handles credentials →

AUTH
API key
CREDENTIALS
Per-tenant encrypted vault
MODEL SEES
Results only, never credentials
AUDIT LOG
Every call, on every plan
05 · WORKS WITH

Use BTCPay Server from any agent.

Claude
ChatGPT
Cursor
Codex
VS Code
OpenAI Agents SDK
Claude Agent SDK
Vercel AI SDK
Mastra
LangGraph
06 · RELATED

More finance and accounting apps.

Stripe433 actions44API4 actionsAirwallex7 actionsAiwyn Tax10 actionsAltoviz67 actionsCoupa384 actionsZoho Books265 actionsMaxio177 actions
ALL FINANCE AND ACCOUNTING APPS →
07 · FAQ

BTCPay Server and Arc0, answered.

Q01

Can I use BTCPay Server with Claude, ChatGPT or Cursor?

Yes. Connect BTCPay Server to Arc0 once, then add your Arc0 MCP URL to Claude, ChatGPT, Cursor, Claude Code or any other remote-MCP client. Each assistant only gets the BTCPay Server actions you allow.

Q02

How do users connect BTCPay Server?

Users add their BTCPay Server api key on Arc0 Connect. It is encrypted in the vault, never shown to the model, and each user can rotate or revoke it at any time.

Q03

Which BTCPay Server actions can my agent take?

16 in total: 8 read, 5 write and 3 destructive, such as “create BTCPay Server User”. Your policies decide which of them each agent may call.

Q04

Can I stop my agent from deleting things in BTCPay Server?

Yes. Actions like “cancel Store Payout” are graded destructive. Set destructive actions to deny, or to ask so the user approves each one, and blocked calls still show up on the audit log.

Q05

Can my own backend call BTCPay Server too?

Yes. The same BTCPay Server connection is available over REST and through the Arc0 proxy, so your product and your agent share one connection per user.

Get started

Plug BTCPay Server into your agent.

Your users connect BTCPay Server once, under your brand. Your agent gets 16 actions behind your policies, with every call on the record.

Connect BTCPay ServerBrowse all apps →

Free to build · MCP + REST · Audit log on every plan