TgPay Merchant API MCP Server

by tgpaybot Your server? Claim it

answering

TgPay Merchant API is answering right now. Last checked 8 min ago. It exposes 20 tools.

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

Uptime history 67 days of history · worst day 89%

67 days agonow

100.0%

Uptime 24h

182 of 182 checks

Tools

read from the server

274 ms

Response time

average over 24h

open, no key

Access

streamable-http

What changed 490

Every tool that appeared, vanished or quietly changed what it asks for. Recorded since 28 August 2026. No other catalogue keeps this.

2 Nov a tool changed version10 times that day

2 Nov a tool description was rewritten connect

2 Nov a tool changed the parameters it asks for getChecks

1 Nov a tool changed version2 times that day

31 Oct a tool changed version8 times that day

30 Oct a tool changed version4 times that day

29 Oct a tool changed version10 times that day

28 Oct a tool changed version18 times that day

27 Oct a tool changed version14 times that day

26 Oct a tool changed version10 times that day

and 480 more, back to 28 August 2026

TgPay Merchant API missed 3 checks this week

Everything else answered, so this is steady rather than shaky. We check every 15 minutes, which is how a one-off gets told apart from the start of a pattern, and how you hear about the next one within the hour instead of from your users.

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 8 min ago.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

claude mcp add merchant-api --transport http https://crypto.tgpaybot.com/mcp

Settings → Connectors → Add custom connector, then paste this address

https://crypto.tgpaybot.com/mcp

~/.codex/config.toml

[mcp_servers.merchant-api]
url = "https://crypto.tgpaybot.com/mcp"

.cursor/mcp.json

{
  "mcpServers": {
    "merchant-api": {
      "url": "https://crypto.tgpaybot.com/mcp"
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "merchant-api": {
      "type": "http",
      "url": "https://crypto.tgpaybot.com/mcp"
    }
  }
}

This server publishes 1 more address. The block above uses the one we reach during checks; the full list is under Endpoints below, and the author may intend a particular one for your client.

Available tools 20

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

connect

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.

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.

archivesubscriptionplan

archiveSubscriptionPlan

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

cancelsubscription

cancelSubscription

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

createinvoice

createInvoice

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

createsubscriptionplan

createSubscriptionPlan

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

deletecheck

deleteCheck

Delete an unclaimed check (refunds the hold).

deleteinvoice

deleteInvoice

Delete an unpaid invoice.

docs

get_docs

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

getbalance

getBalance

Merchant app balance per asset (available + onhold).

getchecks

getChecks

List checks.

getcurrencies

getCurrencies

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

getexchangerates

getExchangeRates

Current asset↔fiat display rates.

getinvoices

getInvoices

List invoices (newest first).

getme

getMe

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

getstats

getStats

App volume/count stats for a period.

getsubscriptionplans

getSubscriptionPlans

List subscription plans.

getsubscriptions

getSubscriptions

List subscriptions (subscribers).

gettransfers

getTransfers

List app→user transfers.

updateapp

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.

Tools removed

Tools this server used to expose. Anything built against them stopped working on the day they went.

createCheck

removed 4 Sep 2026

transfer

removed 4 Sep 2026

transferBatch

removed 4 Sep 2026

refundInvoice

removed 12 Sep 2026

Endpoints

URL	Transport	State	Latency	Checked
https://crypto.tgpaybot.com/mcp	streamable-http	answering	221 ms	8 min ago
https://app.tgpaycrypto.com/mcp	streamable-http	answering	204 ms	8 min ago

Alternatives to TgPay Merchant API

same job, measured the same way

AgentaOS

by agentaos

Merchant of record: payment links, checkouts, subscriptions and invoices, with VAT handled.

answering

Tochka Bank

by dontsovcmc

MCP server for Tochka Bank API — payments, invoices, acquiring, subscriptions

104 installs/wk local only

Stripe MCP Server

by friendlygeorge

MCP server for Stripe API — customers, charges, payments, subscriptions, products, and invoices

36 installs/wk local only

CoinVello

by coinvello

Non-custodial crypto payments: checkout sessions, invoices, webhooks and test payments. No KYC.

18 tools answering

MCP Iugu

by codespar

MCP server for iugu — invoices, subscriptions, customers, payment methods

75 installs/wk local only

Members.dev MCP by usefulapi

by usefulapi

Read members, subscriptions, bookings, invoices, payments; create and update members in Members.dev.

23 tools answering

Voulti

by csacanam

Accept crypto payments from AI agents: invoices + hosted checkout on 5 chains. No API key.

42 installs/wk local only

Invoiced MCP by usefulapi

by usefulapi

Read Invoiced customers, invoices, payments, subscriptions; create customers, draft invoices, notes.

27 tools answering

TgPay Merchant API — questions

Answers built from our own checks of this server.

What can TgPay Merchant API do?

It exposes 20 tools, read directly from the server on our last check. Among them: archiveSubscriptionPlan, cancelSubscription, connect, connect_status, createInvoice, createSubscriptionPlan and 14 more. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →

Is TgPay Merchant API working right now?

We send a real MCP handshake every 15 minutes. Over the last 24 hours 182 of 182 checks got a reply (100.0%), average response time 274 ms. The bar chart above shows every period we have measured.

Did TgPay Merchant API ever remove tools?

Yes. createCheck, transfer, transferBatch, refundInvoice are no longer exposed — we recorded the date each one disappeared. A tool vanishing usually means a breaking change for anything that depended on it.

How do I connect TgPay Merchant API?

Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.

Does TgPay Merchant API need an API key?

No. TgPay Merchant API completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 20 of them are readable on this page. This is what we observed, not what the docs claim.

How fast is TgPay Merchant API?

It answers our handshake in 274 ms on average, which is faster than 52% of all working MCP servers we measure. The comparison comes from our own checks across the whole registry, every 15 minutes.