TgPay Merchant API MCP Server

by tgpaybot Your server? Claim it

answering

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

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

Uptime history 22 days of history · worst day 89%

22 days agonow

100.0%

Uptime 24h

184 of 184 checks

Tools

read from the server

280 ms

Response time

average over 24h

open, no key

Access

streamable-http

What changed 133

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

16 Sep a tool changed version4 times that day

15 Sep a tool changed version2 times that day

14 Sep a tool changed version12 times that day

13 Sep a tool changed version6 times that day

12 Sep a tool changed version14 times that day

12 Sep a tool disappeared refundInvoice

11 Sep a tool changed version14 times that day

10 Sep a tool changed version12 times that day

9 Sep a tool changed version6 times that day

8 Sep a tool changed version25 times that day

and 123 more, back to 28 August 2026

Tools have disappeared from this server

A tool that vanishes takes a piece of your agent with it, and the change arrives silently. Watch this server and every such change lands in your inbox.

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 6 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

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "merchant-api": {
      "url": "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

{
  "mcpServers": {
    "merchant-api": {
      "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 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	232 ms	6 min ago
https://app.tgpaycrypto.com/mcp	streamable-http	answering	310 ms	6 min ago

Alternatives to TgPay Merchant API

same job, measured the same way

Tochka Bank

by dontsovcmc

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

154 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

MCP Iugu

by codespar

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

50 installs/wk local only

Voulti

by csacanam

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

35 installs/wk local only

Billium

by billiumhq

Official Billium MCP server: manage crypto invoices, payments, and webhooks from any MCP host.

39 installs/wk local only

MCP Blockchain Events

by cryptoapis-io

MCP server for subscribing to and managing on-chain event webhooks via Crypto APIs

82 installs/wk local only

Recurly

by usefulapi

MCP server for Recurly — accounts, subscriptions, invoices, plans; cancel & pause subs.

8 tools answering

Alternative Payments

by wyre-ai

MCP server for Alternative Payments — customers, invoices, payment requests, payouts, webhooks.

local only

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 184 of 184 checks got a reply (100.0%), average response time 280 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 with the file path 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 280 ms on average, which is faster than 53% of all working MCP servers we measure. The comparison comes from our own checks across the whole registry, every 15 minutes.