MCP & AI Agent Integration

Btcpay Server
automation.

15 AI agent actions for Btcpay Server — callable from any MCP-compatible runtime, Claude, Cursor, or Cerebral OS workflow. Use Btcpay Server to process payments, generate invoices, and manage financial workflows without human intervention. Full governance, audit trail, and dry-run safety on every execution.

No credit card required
Live in production environments
<200ms median execution
Dry-run before production
Execution trace
live
15
actions
100%
governed
<200ms
latency
15
AI agent actions
6
Read operations
9
Write operations
2
High-risk actions (approval gated)
Finance & Payments Btcpay Server is a Finance & Payments integration — use it to automate payments, invoicing, and financial operations from any AI agent or MCP-compatible runtime.
Actions

What you can do
with Btcpay Server.

Every action below is available as an MCP tool and a verb in Cerebral OS — callable from any AI agent, Claude, Cursor, Windsurf, or your own runtime via the BYOA API. All executions are governed, audited, and dry-run safe.

Get Invoice
btcpay_server:get_invoice
Fetch a single invoice by ID with payment status and details.
Read Low risk
Get Payment Request
btcpay_server:get_payment_request
Fetch a single payment request by ID with details and status.
Read Low risk
Get Store
btcpay_server:get_store
Fetch a single store by ID with basic configuration details.
Read Low risk
List Invoices
btcpay_server:list_invoices
List invoices from a store with optional filtering and pagination.
Read Low risk
List Payment Requests
btcpay_server:list_payment_requests
List payment requests from a store with optional filtering and pagination.
Read Low risk
List Stores
btcpay_server:list_stores
List all stores accessible with the current API key.
Read Low risk
Archive Invoice
btcpay_server:archive_invoice
Archive or unarchive an invoice to organize your invoice list.
Write High risk
Archive Payment Request
btcpay_server:archive_payment_request
Archive or unarchive a payment request to organize your payment request list.
Write High risk
Create Invoice
btcpay_server:create_invoice
Create a new invoice for payment processing.
Write Medium risk
Create Payment Request
btcpay_server:create_payment_request
Create a new payment request for collecting payments.
Write Medium risk
Create Store
btcpay_server:create_store
Create a new store with the specified configuration.
Write Medium risk
Mark Invoice Status
btcpay_server:mark_invoice_status
Manually mark an invoice with a specific status (use with caution).
Write Medium risk
Update Invoice
btcpay_server:update_invoice
Update an existing invoice's metadata.
Write Medium risk
Update Payment Request
btcpay_server:update_payment_request
Update an existing payment request's details.
Write Medium risk
Update Store
btcpay_server:update_store
Update an existing store's configuration.
Write Medium risk
MCP & Runtime API

Call Btcpay Server
from any AI agent.

Any AI agent — Claude, Cursor, LangChain, AutoGen, or your own — can call Btcpay Server actions through the Cerebral OS Runtime API. Governance, credentials, and audit trail fire automatically.

btcpay_server:get_invoice READ
# Call via Runtime API
curl
-X POST \
  "https://api.cerebralos.com/v1/runtime/actions/run"
  -H "X-API-Key: YOUR_KEY" \
  -d '{
    "verb": "btcpay_server:get_invoice",
    "args": {},
    "execution_id": "agent-001"
  }'
btcpay_server:archive_invoice WRITE
# Dry-run first — no production risk
curl
-X POST \
  "https://api.cerebralos.com/v1/runtime/actions/run"
  -H "X-API-Key: YOUR_KEY" \
  -d '{
    "verb": "btcpay_server:archive_invoice",
    "args": {},
    "execution_id": "agent-001",
    "metadata": {"dryRun": true}
  }'
Get your Runtime API key at app.cerebralos.com/signup — 1,000 free executions, no credit card required.
AI agent examples

What your AI agent
can do with Btcpay Server.

Real patterns your AI agent can execute via MCP or the Runtime API. Every action governed, dry-run safe, and fully audited.

Trigger
AI agent needs Btcpay Server data
Call btcpay_server:get_invoice via MCP or Runtime API
AI processes result and takes next action
Full execution logged to audit trail automatically
Trigger
Workflow needs to write to Btcpay Server
Dry-run validates btcpay_server:archive_invoice before execution
Approval gate fires if risk level is high
Action executes with full governance — logged, audited, reversible
Trigger
Payment or billing event
Sync to accounting system
Generate invoice
Alert finance team
How it works

Every Btcpay Server action
governed end-to-end.

Cerebral OS isn't a connector. It's the execution layer that sits in front of Btcpay Server — adding governance, dry-run safety, and a full audit trail to every operation.

Governance first
Every verb carries a risk classification. High-risk writes require explicit approval gates before they execute in production.
Dry-run safe
Simulate any Btcpay Server action before it touches production. See exactly what would happen before a single real call is made.
Immutable audit trail
Every Btcpay Server action is logged — what ran, what changed, who approved it, when it happened. Full history on every verb, forever.
Connect with

Btcpay Server works best
alongside these.

Build multi-step workflows that connect Btcpay Server to the rest of your stack. All governed. All audited.

Btcpay Server integration

Start free.
No credit card required.

Start free with 1,000 runs — no credit card required. Connect Btcpay Server in minutes, dry-run every action before it touches production, full audit trail on everything.

Start free — 1,000 runs Browse all integrations →