Back to search
100
MCP live MCP 2025-06-18 streamable-http

TgPay Merchant API

com.tgpaybot/merchant-api

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

Watch this dependency Share evidence report
Uptime
100.0%
5 direct probes · 30d
Response
685ms
last probe
Tools
20
callable
Resources
6
readable
Prompts
0
available
Primary URL
https://app.tgpaycrypto.com/mcp
Score: 100/100
Handshake verified by our own probe.
pass Answers the MCP handshake 50/50
The handshake and the list calls succeeded on the primary URL.
pass Lists tools, resources or prompts 30/30
20 tools, 6 resources, 0 prompts returned.
pass 3 or more catalogue items 10/10
26 items in total; 3 or more earns these points.
pass Describes itself 10/10
86 characters; more than 30 earns these points.

Tools · 20

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 ("Create app …

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)…

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

Delete an unpaid invoice.

deleteCheck

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

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 sign…

Resources · 6

quickstart tgpay://docs/quickstart
invoices tgpay://docs/invoices
subscriptions tgpay://docs/subscriptions
transfers-checks tgpay://docs/transfers-checks
webhooks tgpay://docs/webhooks
errors tgpay://docs/errors

How to use

Claude Desktop or claude.ai: add a custom connector (Customize → Connectors; on Team and Enterprise plans an owner adds it under Organization settings → Connectors) with this server URL: https://app.tgpaycrypto.com/mcp

Cursor or Cline: add to your MCP config:

{
  "mcpServers": {
    "tgpay_merchant_api": {
      "url": "https://app.tgpaycrypto.com/mcp",
      "transport": "streamable-http"
    }
  }
}