MCP server

TgPay Merchant API

com.tgpaybot/merchant-api

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

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

Website

At a glance

Type

MCP server

Publisher

tgpaybot.com (verified by the MCP Registry)

Status

Working at last check

Tools

20

Token cost

About 2,259 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

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

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.merchant-api]
url = "https://app.tgpaycrypto.com/mcp"

Gemini CLI

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

Cursor

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

VS Code

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

Antigravity

agy mcp add merchant-api https://app.tgpaycrypto.com/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"merchant-api","server_url":"https://app.tgpaycrypto.com/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"merchant-api","server_url":"https://app.tgpaycrypto.com/mcp"}

Tools

• archiveSubscriptionPlan ~72 tokens
  Stop new signups for a plan (live subscriptions keep renewing).
• cancelSubscription ~74 tokens
  Stop future charges for one subscription (paid time runs out).
• connect ~157 tokens
  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 ~179 tokens
  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
• createInvoice Moves money · ~424 tokens
  Create a one-off payment invoice; the payer opens result.mini_app_invoice_url. See the invoices doc.
• createSubscriptionPlan ~174 tokens
  Create an IMMUTABLE recurring-billing plan; send payers to result.mini_app_subscribe_url. See the subscriptions doc.
• deleteCheck Deletes data · ~64 tokens
  Delete an unclaimed check (refunds the hold).
• deleteInvoice Deletes data · ~61 tokens
  Delete an unpaid invoice.
• getBalance ~40 tokens
  Merchant app balance per asset (available + onhold).
• getChecks ~120 tokens
  List checks.
• getCurrencies ~42 tokens
  Supported crypto assets (code/name/decimals) and fiats.
• getExchangeRates ~36 tokens
  Current asset↔fiat display rates.
• getInvoices ~145 tokens
  List invoices (newest first).
• getMe ~41 tokens
  Verify the token: app id, name, webhook config, token scopes.
• getStats ~72 tokens
  App volume/count stats for a period.
• getSubscriptionPlans ~35 tokens
  List subscription plans.
• getSubscriptions ~98 tokens
  List subscriptions (subscribers).
• getTransfers ~128 tokens
  List app→user transfers.
• get_docs ~108 tokens
  Read a TgPay Merchant API integration doc. START HERE before integrating: topics quickstart, invoices, subscriptions, transfers-checks, webhooks, errors.
• updateApp ~189 tokens
  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.

Browse

• Payments
• Invoicing and accounting
• Crypto and blockchains

Related MCP servers

• Digital Manager Guru
  Digital Manager Guru checkout and sales-management platform for digital products via the official AP
• Pagar.me
  Stone's payments gateway (api.pagar.me), orders, charges (card, Pix, boleto), customers and cards, p
• PayRam
  Install, configure, operate and integrate self-hosted PayRam crypto payment gateways.
• Oblio MCP by usefulapi
  Read Oblio clients, products and documents; create proformas, issue, collect and cancel invoices.
• haggl.ai
  Ask a merchant's haggl.ai sales agent for a personalized offer, then hand it to checkout.
• Product Admin by Nova (CIVAI)
  I manage your Nova products, create/update/delete, payment & logistics config, icons, webhook secre…
• ChargeOver MCP by usefulapi
  Read ChargeOver customers, invoices, transactions, subscriptions, reports; create customers, quotes.
• Inferventis — Financial Data, News & Web MCP
  Live financial data MCP: FX, crypto, stocks, news, URL reader. x402 on Base: $0.001/call.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/com.tgpaybot/merchant-api.svg)](https://aptlynx.net/servers/com.tgpaybot/merchant-api)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents