MCP Bitnovo Pay Logo

MCP Bitnovo Pay

Official

Enables AI agents to create cryptocurrency payments, check payment status, generate QR codes, and ma...

7 views
0 installs
Updated Jan 19, 2026
Not audited
Enables AI agents to create cryptocurrency payments, check payment status, generate QR codes, and manage transactions through Bitnovo Pay API integration with automatic webhook support.
  1. Click the "Install Now" button and open the FastMCP connection interface. Use the form there to add environment variables for this MCP server (each variable name → value).

  2. Create / sign in to your Bitnovo Pay merchant account (Bitnovo Pay dashboard). Then open your merchant admin/dashboard and locate the device (point‑of‑sale / device configuration) area to obtain device credentials. (bitnovo.gitbook.io)

  3. Obtain BITNOVO_DEVICE_ID

    • In the dashboard → device (device configuration) entry, copy the Device ID shown for the device you will use with the MCP server.
    • Paste that exact string into the FastMCP env field named BITNOVO_DEVICE_ID. (bitnovo.gitbook.io)
  4. Set BITNOVO_BASE_URL

  5. (Optional — webhooks) Generate or copy BITNOVO_DEVICE_SECRET for HMAC signature validation

    • In the device configuration page in the Bitnovo dashboard, generate (or reveal) the Device Secret / merchant secret for the device (this secret is used to compute/verify X-SIGNATURE HMACs).
    • Copy it securely (it may only be shown once) and paste it into FastMCP as BITNOVO_DEVICE_SECRET. (bitnovo.gitbook.io)
  6. (Optional — webhooks) Configure webhook and tunnel settings (if you want realtime events)

    • In Bitnovo device config set the Webhook URL (the MCP webhook endpoint). If you will use the MCP server’s automatic tunnel, enable WEBHOOK_ENABLED=true and TUNNEL_ENABLED=true in FastMCP.
    • Choose TUNNEL_PROVIDER in FastMCP (ngrok, zrok, or manual). If you pick ngrok:
      • Create an ngrok account and copy your authtoken from the ngrok dashboard.
      • Add that token into FastMCP as NGROK_AUTHTOKEN (and optionally NGROK_DOMAIN if you reserved a domain). (ngrok.com)
  7. Optional: other tunnel providers

    • If using zrok or manual, supply the provider-specific envs per your tunnel provider docs (e.g., zrok credentials) or configure a public webhook URL and set TUNNEL_PROVIDER=manual and WEBHOOK_ENABLED=true in FastMCP. (The MCP server expects webhooks per‑device as configured in Bitnovo.) (bitnovo.gitbook.io)
  8. Enter any additional MCP envs required by your deployment:

    • PORT (only for HTTP/remote mode), WEBHOOK_ENABLED (true/false), TUNNEL_ENABLED (true/false), TUNNEL_PROVIDER (ngrok|zrok|manual), NGROK_AUTHTOKEN, NGROK_DOMAIN as needed.
    • Put each variable name and value into the FastMCP env fields before saving. (lobehub.com)
  9. Save the FastMCP connection entry and restart / reload the MCP client so the new envs are applied. After restart, test the integration (for example: ask the assistant “Create a payment for 10 euros”) to confirm payments and webhooks are working. (lobehub.com)

  10. Security reminders

  • Never commit Device IDs, Device Secrets, or authtokens to source control.
    - Store secrets only in FastMCP/secret manager fields and treat the Device Secret and tunnel tokens as highly sensitive (copy them only when needed and rotate/revoke if exposed).

Quick Start

View on GitHub

More for Finance

View All →

More for API Development

View All →

Report Issue

Thank you! Your issue report has been submitted successfully.