TgPay Merchant API MCP server

• archiveSubscriptionPlanFree

  Stop new signups for a plan (live subscriptions keep renewing).

• cancelSubscriptionwrite actionFree

  Stop future charges for one subscription (paid time runs out).

• connectFree

  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 configured yet.

• connect_statusFree

  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 app; transfers/refunds/checks need the primary token the human holds in the Mini App. Poll every 3-5 seconds while pending.

• createInvoicewrite actionFree

  Create a one-off payment invoice; the payer opens result.mini_app_invoice_url. See the invoices doc.

• createSubscriptionPlanwrite actionFree

  Create an IMMUTABLE recurring-billing plan; send payers to result.mini_app_subscribe_url. See the subscriptions doc.

• deleteCheckwrite actionFree

  Delete an unclaimed check (refunds the hold).

• deleteInvoicewrite actionFree

  Delete an unpaid invoice.

• getBalanceFree

  Merchant app balance per asset (available + onhold).

• getChecksFree

  List checks.

• getCurrenciesFree

  Supported crypto assets (code/name/decimals) and fiats.

• getExchangeRatesFree

  Current asset↔fiat display rates.

• getInvoicesFree

  List invoices (newest first).

• getMeFree

  Verify the token: app id, name, webhook config, token scopes.

• getStatsFree

  App volume/count stats for a period.

• getSubscriptionPlansFree

  List subscription plans.

• getSubscriptionsFree

  List subscriptions (subscribers).

• getTransfersFree

  List app→user transfers.

• get_docsFree

  Read a TgPay Merchant API integration doc. START HERE before integrating: topics quickstart, invoices, subscriptions, transfers-checks, webhooks, errors.

• updateAppwrite actionFree

  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.

• –Code scanremote-only server, no package to scann/a
• Live reliabilityremote reachable in 2393ms17/20
• Tool poisoning20 tool descriptions checked15/15
• Auth qualityAPI key sent as a header8/15
• Maintenanceno repository listed3/15
• Maintainer identityverified namespace with website, no repo4/10

TgPay Merchant API: common questions

Is TgPay Merchant API MCP server safe?

With care: it is graded C, so read the findings first (63/100). Read the TgPay Merchant API safety report

How do I install TgPay Merchant API?

It runs remotely at app.tgpaycrypto.com. Add it to Claude Code, Claude Desktop or Cursor with the snippets above, or call it through the mcp.market gateway without installing anything.

Does TgPay Merchant API need an API key?

Yes. The registry entry asks for TgPayCrypto-API-Token.

Is TgPay Merchant API maintained?

The latest release is v1.0.2.

Is TgPay Merchant API up?

100% of our last 6 checks got an answer. We check remote servers about four times a day.

What can I use instead of TgPay Merchant API?

Servers from other publishers that do the same job: payware MCP server, AurasPay Merchant MCP server and gate402 merchant checkout MCP server. Compare all TgPay Merchant API alternatives.