# Btcpay server (verified)

BTCPay Server is a free, open-source, self-hosted Bitcoin payment processor that enables merchants to accept Bitcoin payments without intermediaries.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add btcpay_server

# Browse available tools
npx -y @smithery/cli@latest tool list btcpay_server

# Get full schema for a tool
npx -y @smithery/cli@latest tool get btcpay_server BTCPAY_SERVER_CREATE_PAYMENT_REQUEST

# Call a tool
npx -y @smithery/cli@latest tool call btcpay_server BTCPAY_SERVER_CREATE_PAYMENT_REQUEST '{}'
```

## Direct MCP Connection

Endpoint: `https://btcpay_server.run.tools`

## Tools (17)

- `BTCPAY_SERVER_CREATE_PAYMENT_REQUEST` — Tool to create a new payment request for a store. Use after confirming store ID.
- `BTCPAY_SERVER_CREATE_STORE` — Tool to create a new store in BTCPay Server. Use when you need to provision a new store before processing transactions.
- `BTCPAY_SERVER_CREATE_USER` — Tool to create a new BTCPay Server user. Use when you need to register a new user programmatically as an administrator.
- `BTCPAY_SERVER_CREATE_WEBHOOK` — Tool to register a new webhook. Use when you need to receive store event notifications.
- `BTCPAY_SERVER_DELETE_API_KEY` — Tool to revoke a specific API key. Use when you need to remove an API key to immediately prevent its use. Call after id…
- `BTCPAY_SERVER_DELETE_PAYMENT_REQUEST` — Tool to delete a specific payment request. Use when you need to archive/remove an existing payment request for a store.
- `BTCPAY_SERVER_DELETE_PAYOUT` — Tool to delete a specific payout from a store. Use when you need to cancel a payout no longer needed.
- `BTCPAY_SERVER_GET_API_KEY` — Tool to retrieve the current API key. Use after authentication to get API key details.
- `BTCPAY_SERVER_GET_API_KEYS` — Tool to list API keys. Use when you need to retrieve all API keys associated with the authenticated user.
- `BTCPAY_SERVER_GET_PAYMENT_REQUESTS` — Tool to list all payment requests for a specific store. Use after confirming you have the store ID.
- `BTCPAY_SERVER_GET_SERVER_INFO` — Tool to retrieve information about the BTCPay Server instance. Use when needing server version, tor address, supported …
- `BTCPAY_SERVER_GET_STORE` — Tool to retrieve information about a specific store. Use when you need full store configuration.
- `BTCPAY_SERVER_GET_USER` — Tool to retrieve information about a specific user. Use when you need to fetch profile data for a given user ID or emai…
- `BTCPAY_SERVER_GET_WEBHOOK` — Tool to retrieve details of a specific webhook. Use when you need to verify the configuration or status of a webhook fo…
- `BTCPAY_SERVER_GET_WEBHOOKS` — Tool to list all webhooks registered for a store. Use when you need to retrieve the configured webhooks for management …
- `BTCPAY_SERVER_LIST_APPS` — Tool to list all apps associated with a specific store. Use when retrieving basic metadata of every app in that store.
- `BTCPAY_SERVER_UPDATE_USER` — Tool to update current user information. Use when you need to modify your authenticated user profile on BTCPay Server.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get btcpay_server <tool-name>
```
