Bitnovo Pay

Bitnovo Pay

MCP server that provides AI agents with cryptocurrency payment capabilities via Bitnovo Pay API.

2
Stars
0
Forks
2
Releases

Overview

An MCP server that enables AI agents to perform cryptocurrency payments through the Bitnovo Pay API. It provides capabilities to create payments (direct on-chain via create_payment_onchain and web-based via create_payment_link), retrieve payment status, and generate high-quality QR codes, while giving access to a currencies catalog. The server exposes eight MCP tools: create_payment_onchain, create_payment_link, get_payment_status, list_currencies_catalog, generate_payment_qr, get_webhook_events, get_webhook_url, and get_tunnel_status. It supports automatic webhook delivery through three tunnel providers (ngrok, zrok, manual) to expose webhook endpoints for real-time notifications. It is designed for multi-LLM environments including OpenAI ChatGPT, Google Gemini, and Claude. QR outputs are high quality (512px default, up to 2000px) with branding and interpolation optimizations. The architecture is stateless, with privacy-by-default data masking, HTTPS enforcement, HMAC validation, and nonce-based replay protection. Reliability is enhanced with built-in retry and timeout handling. Deployment is flexible, including cloud options (Railway) and Docker-based setups, with environment variable configuration (BITNOVO_DEVICE_ID, BITNOVO_BASE_URL, BITNOVO_DEVICE_SECRET). Prerequisites include Node.js 18+ and a Bitnovo Pay account.

Details

Owner
bitnovo
Language
TypeScript
License
MIT License
Updated
2025-12-07

Features

create_payment_onchain

Generates cryptocurrency addresses for direct payments.

create_payment_link

Creates web-based payment URLs with redirect handling.

get_payment_status

Queries and returns detailed payment status information.

list_currencies_catalog

Fetches supported cryptocurrencies with optional amount filtering.

generate_payment_qr

Generates branded, high-quality QR codes for existing payments.

get_webhook_events

Retrieves webhook events in real-time from Bitnovo Pay.

get_webhook_url

Provides a public URL and configuration steps for webhooks.

get_tunnel_status

Diagnoses current tunnel connection status (ngrok, zrok, manual).

Audience

AI AgentsAllow AI agents to initiate, monitor, and finalize cryptocurrency payments via Bitnovo Pay.
MCP DevelopersBuild MCP servers that integrate Bitnovo Pay payments for autonomous workflows.
Platform OperatorsOperate cloud or on-prem MCP deployments with webhook tunnels and secure payment handling.

Tags

MCPBitnovo PaycryptocurrencypaymentsQR codeswebhooktunnelngrokzrokmanualOpenAIChatGPTGeminiClaudeonchainpayment_linkcurrency_catalogprivacysecuritycloudDockerRailwayHTTPAPIMCP Tools