Bitnovo Pay MCP Server

MCP server for Bitnovo Pay integration with AI agents. Provides cryptocurrency payment capabilities through Bitnovo Pay API. Features include payment

Local serverstdioTypeScript

What is the Bitnovo Pay MCP server?

Bitnovo Pay MCP server is a locally run integration for AI assistants that speak the Model Context Protocol. MCP server for Bitnovo Pay integration with AI agents. Provides cryptocurrency payment capabilities through Bitnovo Pay API. Features include payment creation, status checking, QR code generation, and webhook management with support for.

What you get

A Model Context Protocol (MCP) server that provides AI agents with cryptocurrency payment capabilities through Bitnovo Pay API integration. This server enables AI models to create payments, check payment status, manage QR codes, and access cryptocurrency catalogs.

What the assistant can call

Once Bitnovo Pay is connected, these are the calls the assistant has available:

  • create_payment_onchain — Creates a cryptocurrency payment with a specific address for direct transactions
  • create_payment_link — Creates a web-based payment URL where customers can choose their cryptocurrency
  • get_payment_status — The get_payment_status tool exposed by this server
  • list_currencies_catalog — Gets available cryptocurrencies with optional amount-based filtering
  • generate_payment_qr — Creates custom QR codes for existing payments with high-quality output
  • get_webhook_events — Query webhook events received in real-time from Bitnovo Pay API
  • get_webhook_url — Get public webhook URL with configuration instructions for Bitnovo panel
  • get_tunnel_status — The get_tunnel_status tool exposed by this server
  • Architecture — The Architecture tool exposed by this server

Configuration and credentials

You will need 8 environment variables: BITNOVO_DEVICE_ID, BITNOVO_BASE_URL, BITNOVO_DEVICE_SECRET, WEBHOOK_ENABLED, TUNNEL_ENABLED, TUNNEL_PROVIDER, NGROK_AUTHTOKEN, NGROK_DOMAIN. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

Setting it up

@bitnovopay/mcp-bitnovo-pay on npm is all you need. Most clients run it directly, so configuration is a few lines and a restart.

Choosing this one

Among the payments and commerce options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Bitnovo Pay's toolset — create_payment_onchain, create_payment_link, get_payment_status and 6 more — is a fair guide to whether it matches your workflow.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Before you rely on it

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 9 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Bitnovo Pay.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the bitnovo pay mcp server does with a few real requests.

Available tools

ToolWhat it does
create_payment_onchainCreates a cryptocurrency payment with a specific address for direct transactions.
create_payment_linkCreates a web-based payment URL where customers can choose their cryptocurrency.
get_payment_statusThe get_payment_status tool exposed by this server.
list_currencies_catalogGets available cryptocurrencies with optional amount-based filtering.
generate_payment_qrCreates custom QR codes for existing payments with high-quality output.
get_webhook_eventsQuery webhook events received in real-time from Bitnovo Pay API.
get_webhook_urlGet public webhook URL with configuration instructions for Bitnovo panel.
get_tunnel_statusThe get_tunnel_status tool exposed by this server.
ArchitectureThe Architecture tool exposed by this server.

How to install the Bitnovo Pay MCP server

{
  "mcpServers": {
    "bitnovo-pay": {
      "command": "npx",
      "args": ["-y", "@bitnovopay/mcp-bitnovo-pay"],
      "env": {
        "BITNOVO_DEVICE_ID": "your_device_id_here",
        "BITNOVO_BASE_URL": "https://pos.bitnovo.com"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
BITNOVO_DEVICE_IDConfiguration value read at startup.Optional
BITNOVO_BASE_URLEndpoint or connection string the server talks to.Yes
BITNOVO_DEVICE_SECRETCredential the server authenticates with.Yes
WEBHOOK_ENABLEDConfiguration value read at startup.Optional
TUNNEL_ENABLEDConfiguration value read at startup.Optional
TUNNEL_PROVIDERConfiguration value read at startup.Optional
NGROK_AUTHTOKENCredential the server authenticates with.Yes
NGROK_DOMAINConfiguration value read at startup.Optional

Example prompts to try

  • Use Bitnovo Pay to create payment onchain.
  • Use Bitnovo Pay to create payment link.
  • Use Bitnovo Pay to get payment status.

Frequently asked questions

It connects Bitnovo Pay to MCP-compatible AI assistants such as Claude and Cursor, exposing 9 tools (create_payment_onchain, create_payment_link, get_payment_status, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Bitnovo Pay directly.