btcfactura for AI Agents

btcfactura for AI Agents

btcfactura.com exposes its full catalog and checkout over MCP so an AI agent can browse Romanian carriers and gift card brands, pick a denomination, pay a Lightning invoice, and deliver a mobile top-up or PIN voucher – no account, no signup, no human in the loop.

MCP endpoint

https://btcfactura.com/mcp

Stateless, JSON responses, no session required. Compatible with Claude, GPT-4o, Cursor, and any MCP client.

Versiunea in romana

How it works

Mobile top-up (type: prepay_msisdn)

  1. Call lookup_carrier to identify the carrier for a phone number.
  2. Call get_supplier_products to browse available denominations.
  3. Call create_order with type: "prepay_msisdn", the product, and the phone number (msisdn).
  4. Pay the Lightning invoice returned in the response.
  5. Poll get_order_status – the credit is added to the phone automatically once payment settles.

Gift card / PIN voucher (type: prepay_pin)

  1. Call list_suppliers with category: "prepayPin" to see available brands.
  2. Call get_supplier_products to browse denominations.
  3. Call create_order with type: "prepay_pin" and the product – no phone number needed.
  4. Pay the Lightning invoice returned in the response.
  5. Poll get_order_status – when dispatchStatus is COMPLETED, the PIN is delivered.

Tools

ToolDescription
list_suppliersList suppliers available on btcfactura.com, optionally filtered by category (prepayMSISDN, prepayPin, utility).
get_supplier_productsList purchasable denominations for a supplier.
lookup_carrierIdentify the mobile carrier for a Romanian phone number. Returns the supplierUid to use in create_order.
create_orderCreate an order and receive a Lightning invoice (bolt11). Use type: "prepay_msisdn" + msisdn for direct mobile top-ups; type: "prepay_pin" for gift cards and PIN vouchers (no phone number required). No bearer token required.
get_order_statusCheck payment status (PENDING / PAID / EXPIRED) and dispatch status (PENDING / PROCESSING / COMPLETED / FAILED). Poll every 10-15 s after paying.
healthCheck that the MCP server is reachable.

Payment

The agent pays a Lightning invoice from its own wallet. Top-ups and vouchers are non-reversible once delivered, which is why Lightning fits: instant settlement, no chargebacks, no card networks. The price charged is identical to the website price – it includes the operator margin and any applicable fees.

Limits

  • Rate limit: 30 requests per minute per IP.
  • Invoice expiry: 30 minutes from creation.
  • Mobile top-ups: Vodafone Romania, Orange Romania, Digi (RCS&RDS), Telekom, and more via list_suppliers.
  • Gift cards and vouchers: browse available brands with list_suppliers and category: "prepayPin".

For people

Not an agent? Shop the site – same products, Lightning + crypto + card.