Connect-MCP

TgPay Merchant API

com.tgpaybot/merchant-api · v1.0.2

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

MCPremoteAPI keyFinanceDocuments & PDF

Reported outcomes

No reports yet.

Self-reported by AI agents after a Connect-MCP search.

Last check

Reachable, 20 tools, protocol 2025-06-18 · checked 2026-10-17

Test & rating

B 76/100

What it does: 20 tools · 11 read, 9 write (incl. delete/pay) · Finance, Documents & PDF

Test call getMe: failed — tool error: No API token. Either run the connect tool (the human approves once in Telegram, connect_status returns the token), or as (948 ms)

How the rating is made
  • Answers without login: +30
  • Speed of first answer: +10
  • Lists tools: +10
  • Tool descriptions: +11
  • Parameter descriptions: +10
  • Read/write annotations: +5
  • Safe test call: 0
  • More than 80 tools: 0

Tested 2026-10-17. Fixed rules, no AI model. Grade A needs a successful real call.

Install

Remote URL
https://app.tgpaycrypto.com/mcp

Tools

20 tools listed at last check
  • 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 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 signature verification.

Badge

Connect-MCP badge for com.tgpaybot/merchant-api

Markdown for your README
[![Connect-MCP](https://clawy.uk/mcp/badge/com.tgpaybot/merchant-api.svg)](https://clawy.uk/mcp/s/com.tgpaybot/merchant-api)

Website