All servers · Payments & accounting · APIs & integrations

TgPay Merchant API

com.tgpaybot/merchant-api · v1.0.2

Measured by MCP Station

Description written by the publisher, not verified

Accept crypto payments via the TgPay Merchant API — invoices, subscriptions, webhooks.

Connect

claude mcp add --transport http merchant-api https://app.tgpaycrypto.com/mcp

{
  "mcpServers": {
    "merchant-api": {
      "url": "https://app.tgpaycrypto.com/mcp"
    }
  }
}

Tools as reported by the server

• get_docs
  Read a TgPay Merchant API integration doc. START HERE before integrating: topics quickstart, invoices, subscriptions, transfers-checks, webhooks, errors.
• connect
  Start token issuance WITHOUT the Mini App UI: creates a merchant-app request and returns a t.me approve link plus a poll_secret. Show the link to the human — they approve with one button in the @tgpaycryptobot bot — then call connect_status with the poll_secret. Use only when no API token is configu
• connect_status
  Poll a connect request. Returns pending | denied | expired, or — once approved — the app id and the API TOKEN (returned exactly once: save it to the project's .env immediately, never print it in logs). The token is SCOPED (read, invoices, subscriptions, webhooks) — it cannot move money out of the ap
• getMe
  Verify the token: app id, name, webhook config, token scopes.
• getBalance
  Merchant app balance per asset (available + onhold).
• getCurrencies
  Supported crypto assets (code/name/decimals) and fiats.
• getExchangeRates
  Current asset↔fiat display rates.
• getStats
  App volume/count stats for a period.
• getInvoices
  List invoices (newest first).
• getChecks
  List checks.
• getTransfers
  List app→user transfers.
• getSubscriptionPlans
  List subscription plans.
• getSubscriptions
  List subscriptions (subscribers).
• createInvoice
  Create a one-off payment invoice; the payer opens result.mini_app_invoice_url. See the invoices doc.
• deleteInvoice write/delete
  Delete an unpaid invoice.
• deleteCheck write/delete
  Delete an unclaimed check (refunds the hold).
• createSubscriptionPlan
  Create an IMMUTABLE recurring-billing plan; send payers to result.mini_app_subscribe_url. See the subscriptions doc.
• archiveSubscriptionPlan
  Stop new signups for a plan (live subscriptions keep renewing).
• cancelSubscription write/delete
  Stop future charges for one subscription (paid time runs out).
• updateApp
  Update app name / webhook_url (https) / webhook_events opt-in list. Needs the 'webhooks' scope (the connect-issued token has it) or the primary token. See the webhooks doc for the event types and signature verification.

Website · JSON · Text for agents · Registry updated 2026-09-07