TgPay Merchant API

com.tgpaybot/merchant-apiVersion 1.0.2

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

Status

Responds280 msNov 14, 2026, 14:18 UTCAnswered our handshake without sign-in.

Registry data may be out of date

We could not refresh it, so this page shows the last copy.

Last checked: Nov 14, 2026, 14:18 UTC
Latency: 280 ms
Remotes responding: 1 of 1
Sign-in: No sign-in
Hosting: Hosted outside the EU (detected)
Registry data as of: Nov 14, 2026, 22:14 UTC

Data from the official MCP Registry, checked by run.zero. How we check

Connect

Streamable HTTP

https://app.tgpaycrypto.com/mcpResponds280 msNov 14, 2026, 14:18 UTC

No sign-in

Claude Code

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

Claude Desktop and claude.ai

1
2
3

Settings > Connectors > Add custom connector
Name: merchant-api
Remote MCP server URL: https://app.tgpaycrypto.com/mcp

Cursor

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

VS Code

code --add-mcp '{"name":"merchant-api","type":"http","url":"https://app.tgpaycrypto.com/mcp"}'

Built your own server? run.zero hosts MCP servers on European infrastructure.

Host your own MCP server on run.zero

Tools

20 tools

Tools of TgPay Merchant API
	Description		Read-only	Idempotent	Open world
`archiveSubscriptionPlan`Stop new signups for a plan (live subscriptions keep renewing).	Stop new signups for a plan (live subscriptions keep renewing).	No	No	Not declared	Not declared
`cancelSubscription`Stop future charges for one subscription (paid time runs out).	Stop future charges for one subscription (paid time runs out).	Yes	No	Not declared	Not declared
`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 ("Create app and issue token") in the @tgpaycryptobot bot — then call connect_status with the poll_secret. Use only when no API token is configured yet.	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 ("Create app and issue token") in the @tgpaycryptobot bot — then call connect_status with the poll_secret. Use only when no API token is configured yet.	No	No	Not declared	Not declared
`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 app; transfers/refunds/checks need the primary token the human holds in the Mini App. Poll every 3-5 seconds while pending.	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.	No	No	Not declared	Not declared
`createInvoice`Create a one-off payment invoice; the payer opens result.mini_app_invoice_url. See the invoices doc.	Create a one-off payment invoice; the payer opens result.mini_app_invoice_url. See the invoices doc.	No	No	Not declared	Not declared
`createSubscriptionPlan`Create an IMMUTABLE recurring-billing plan; send payers to result.mini_app_subscribe_url. See the subscriptions doc.	Create an IMMUTABLE recurring-billing plan; send payers to result.mini_app_subscribe_url. See the subscriptions doc.	No	No	Not declared	Not declared
`deleteCheck`Delete an unclaimed check (refunds the hold).	Delete an unclaimed check (refunds the hold).	Yes	No	Not declared	Not declared
`deleteInvoice`Delete an unpaid invoice.	Delete an unpaid invoice.	Yes	No	Not declared	Not declared
`get_docs`Read a TgPay Merchant API integration doc. START HERE before integrating: topics quickstart, invoices, subscriptions, transfers-checks, webhooks, errors.	Read a TgPay Merchant API integration doc. START HERE before integrating: topics quickstart, invoices, subscriptions, transfers-checks, webhooks, errors.	No	Yes	Not declared	Not declared
`getBalance`Merchant app balance per asset (available + onhold).	Merchant app balance per asset (available + onhold).	No	Yes	Not declared	Not declared
`getChecks`List checks.	List checks.	No	Yes	Not declared	Not declared
`getCurrencies`Supported crypto assets (code/name/decimals) and fiats.	Supported crypto assets (code/name/decimals) and fiats.	No	Yes	Not declared	Not declared
`getExchangeRates`Current asset↔fiat display rates.	Current asset↔fiat display rates.	No	Yes	Not declared	Not declared
`getInvoices`List invoices (newest first).	List invoices (newest first).	No	Yes	Not declared	Not declared
`getMe`Verify the token: app id, name, webhook config, token scopes.	Verify the token: app id, name, webhook config, token scopes.	No	Yes	Not declared	Not declared
`getStats`App volume/count stats for a period.	App volume/count stats for a period.	No	Yes	Not declared	Not declared
`getSubscriptionPlans`List subscription plans.	List subscription plans.	No	Yes	Not declared	Not declared
`getSubscriptions`List subscriptions (subscribers).	List subscriptions (subscribers).	No	Yes	Not declared	Not declared
`getTransfers`List app→user transfers.	List app→user transfers.	No	Yes	Not declared	Not declared
`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.	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.	No	No	Not declared	Not declared

Details

Registry status: Active
Published: Sep 7, 2026
Updated: Sep 7, 2026
Website: https://app.tgpaycrypto.com/mcp⁠ (opens in a new tab)
Repository: Not given
Categories (suggested): Finance and payments Developer tools E-commerceSuggested categories are assigned automatically from the registry text and may be wrong. Verified operators can correct them.
GDPR: Not declared

Are you the operator? Claim this listing