MCP Radar
MCP Server

TgPay Merchant API

com.tgpaybot/merchant-api
Crypto & Web3 Payments & Fintech Public & reachable MCP 2026-07-28

What this MCP does

Enables merchants to create crypto payment invoices, recurring subscription plans, payment webhooks, and related account and transaction management.

Capabilities

Tools

20 tools
archiveSubscriptionPlan
Stop new signups for a plan (live subscriptions keep renewing).
Input schema 
{'type': 'object', 'required': ['plan_id'], 'properties': {'plan_id': {'type': 'integer', 'description': 'The plan to archive.'}}}
cancelSubscription
Stop future charges for one subscription (paid time runs out).
Destructive
Input schema 
{'type': 'object', 'required': ['subscription_id'], 'properties': {'subscription_id': {'type': 'integer', 'description': 'The subscription.'}}}
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.
Input schema 
{'type': 'object', 'required': ['app_name'], 'properties': {'app_name': {'type': 'string', 'description': 'Merchant app name shown to the approving human, 1-64 chars (e.g. the project/bot name).'}}}
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.
Input schema 
{'type': 'object', 'required': ['poll_secret'], 'properties': {'poll_secret': {'type': 'string', 'description': 'The poll_secret from the connect tool.'}}}
createInvoice
Create a one-off payment invoice; the payer opens result.mini_app_invoice_url. See the invoices doc.
Input schema 
{'type': 'object', 'properties': {'fiat': {'type': 'string', 'description': 'Fiat code (fiat mode).'}, 'asset': {'type': 'string', 'description': 'Asset code (crypto mode).'}, 'amount': {'type': 'string', 'description': 'Decimal string in MAJOR units, e.g. "5" = 5 USDT. Never a float. Omit for an open-amount invoice.'}, 'payload': {'type': 'string', 'description': 'Opaque data echoed back in the webhook (≤4096).'}, 'swap_to': {'type': 'string', 'description': 'Auto-convert the received amount to this asset.'}, 'expires_in': {'type': 'integer', 'description': 'Invoice TTL in seconds.'}, 'description': {'type': 'string', 'description': 'Shown to the payer (≤1024).'}, 'paid_btn_url': {'type': 'string', 'description': 'URL for the paid button.'}, 'currency_type': {'type': 'string', 'description': 'crypto (default) | fiat.'}, 'paid_btn_name': {'type': 'string', 'description': 'viewItem | openChannel | openBot | callback.'}, 'allow_comments': {'type': 'boolean', 'description': 'Default true.'}, 'hidden_message': {'type': 'string', 'description': 'Revealed to the payer ONLY after payment (≤2048).'}, 'accepted_assets': {'type': 'string', 'description': 'Fiat mode: comma-separated assets the payer may pay in.'}, 'allow_anonymous': {'type': 'boolean', 'description': 'Default true.'}, 'rate_lock_seconds': {'type': 'integer', 'description': 'Fiat mode: freeze crypto quotes for this long.'}}}
createSubscriptionPlan
Create an IMMUTABLE recurring-billing plan; send payers to result.mini_app_subscribe_url. See the subscriptions doc.
Input schema 
{'type': 'object', 'required': ['name', 'asset', 'amount', 'period_days'], 'properties': {'name': {'type': 'string', 'description': 'Plan name shown to payers (≤64).'}, 'asset': {'type': 'string', 'description': 'Asset code, e.g. USDT.'}, 'amount': {'type': 'string', 'description': 'Decimal string in MAJOR units, e.g. "5" = 5 USDT. Never a float. Charged per period.'}, 'period_days': {'type': 'integer', 'description': 'Billing period in days.'}}}
deleteCheck
Delete an unclaimed check (refunds the hold).
Destructive
Input schema 
{'type': 'object', 'required': ['check_id'], 'properties': {'check_id': {'type': 'integer', 'description': 'The check to delete.'}}}
deleteInvoice
Delete an unpaid invoice.
Destructive
Input schema 
{'type': 'object', 'required': ['invoice_id'], 'properties': {'invoice_id': {'type': 'integer', 'description': 'The invoice to delete.'}}}
getBalance
Merchant app balance per asset (available + onhold).
Read only
Input schema 
{'type': 'object', 'properties': {}}
getChecks
List checks.
Read only
Input schema 
{'type': 'object', 'properties': {'asset': {'type': 'string', 'description': 'Filter by asset code.'}, 'count': {'type': 'integer', 'description': 'Page size (default 100).'}, 'offset': {'type': 'integer', 'description': 'Skip this many.'}, 'status': {'type': 'string', 'description': 'active | activated.'}, 'check_ids': {'type': 'string', 'description': 'Comma-separated ids.'}}}
getCurrencies
Supported crypto assets (code/name/decimals) and fiats.
Read only
Input schema 
{'type': 'object', 'properties': {}}
get_docs
Read a TgPay Merchant API integration doc. START HERE before integrating: topics quickstart, invoices, subscriptions, transfers-checks, webhooks, errors.
Read only
Input schema 
{'type': 'object', 'required': ['topic'], 'properties': {'topic': {'type': 'string', 'description': 'quickstart | invoices | subscriptions | transfers-checks | webhooks | errors'}}}
getExchangeRates
Current asset↔fiat display rates.
Read only
Input schema 
{'type': 'object', 'properties': {}}
getInvoices
List invoices (newest first).
Read only
Input schema 
{'type': 'object', 'properties': {'fiat': {'type': 'string', 'description': 'Filter by fiat code.'}, 'asset': {'type': 'string', 'description': 'Filter by asset code.'}, 'count': {'type': 'integer', 'description': 'Page size (default 100).'}, 'offset': {'type': 'integer', 'description': 'Skip this many.'}, 'status': {'type': 'string', 'description': 'active | paid | expired.'}, 'invoice_ids': {'type': 'string', 'description': 'Comma-separated ids.'}}}
getMe
Verify the token: app id, name, webhook config, token scopes.
Read only
Input schema 
{'type': 'object', 'properties': {}}
getStats
App volume/count stats for a period.
Read only
Input schema 
{'type': 'object', 'properties': {'end_at': {'type': 'string', 'description': 'ISO 8601 period end.'}, 'start_at': {'type': 'string', 'description': 'ISO 8601 period start.'}}}
getSubscriptionPlans
List subscription plans.
Read only
Input schema 
{'type': 'object', 'properties': {}}
getSubscriptions
List subscriptions (subscribers).
Read only
Input schema 
{'type': 'object', 'properties': {'status': {'type': 'string', 'description': 'active | grace | cancelled | expired.'}, 'plan_id': {'type': 'integer', 'description': 'Filter by plan.'}, 'user_id': {'type': 'integer', 'description': 'Filter by Telegram user id.'}}}
getTransfers
List app→user transfers.
Read only
Input schema 
{'type': 'object', 'properties': {'asset': {'type': 'string', 'description': 'Filter by asset code.'}, 'count': {'type': 'integer', 'description': 'Page size (default 100).'}, 'offset': {'type': 'integer', 'description': 'Skip this many.'}, 'spend_id': {'type': 'string', 'description': 'Filter by idempotency key.'}, 'transfer_ids': {'type': 'string', 'description': 'Comma-separated ids.'}}}
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.
Input schema 
{'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'New app name (1-64).'}, 'webhook_url': {'type': 'string', 'description': 'https URL for webhook delivery; "" clears it.'}, 'webhook_events': {'type': 'array', 'items': {'type': 'string', 'description': 'Event type.'}, 'description': 'Extended event types to opt into (invoice_paid is always delivered); [] = invoice_paid-only.'}}}
History

Recent tool changes

Added
updateApp
Sept. 17, 2026, 12:37 p.m.
Added
cancelSubscription
Sept. 17, 2026, 12:37 p.m.
Added
archiveSubscriptionPlan
Sept. 17, 2026, 12:37 p.m.
Added
createSubscriptionPlan
Sept. 17, 2026, 12:37 p.m.
Added
deleteCheck
Sept. 17, 2026, 12:37 p.m.
Added
deleteInvoice
Sept. 17, 2026, 12:37 p.m.
Added
createInvoice
Sept. 17, 2026, 12:37 p.m.
Added
getSubscriptions
Sept. 17, 2026, 12:37 p.m.
Added
getSubscriptionPlans
Sept. 17, 2026, 12:37 p.m.
Added
getTransfers
Sept. 17, 2026, 12:37 p.m.
Added
getChecks
Sept. 17, 2026, 12:37 p.m.
Added
getInvoices
Sept. 17, 2026, 12:37 p.m.
Added
getStats
Sept. 17, 2026, 12:37 p.m.
Added
getExchangeRates
Sept. 17, 2026, 12:37 p.m.
Added
getCurrencies
Sept. 17, 2026, 12:37 p.m.
Added
getBalance
Sept. 17, 2026, 12:37 p.m.
Added
getMe
Sept. 17, 2026, 12:37 p.m.
Added
connect_status
Sept. 17, 2026, 12:37 p.m.
Added
connect
Sept. 17, 2026, 12:37 p.m.
Added
get_docs
Sept. 17, 2026, 12:37 p.m.
Discover

Similar MCP servers

SAP MCP Server

ai.oobeprotocol.sap.mcp/sap-mcp

Provides an MCP gateway connecting SAP-related tools with Solana, DeFi, decentralized identity, and x402 payments.

FortFi Treasury MCP

io.github.rebelArtists/fortfi-treasury-mcp

Provides policy-controlled crypto treasury operations across chains, including wallets, payments, token discovery, swaps, bridges…

DPX — Institutional Cross-Border Settlement

io.github.untitledfinancial/dpx

Provides compliance-gated cross-border crypto settlement, agent registration and spending mandates, stablecoin routing, ESG and s…

Peer

io.github.zkp2p/peer

Reads Peer protocol, checkout, deposit, wallet, Peer Cash, cross-chain routing, payout, and IntentGuardian data on Base and relat…

Robyn — Gasless Cross-Chain for AI Agents

io.github.ox31461/robyn

Supports gasless cross-chain transfers, wallet and transaction checks, spending mandates, privacy-preserving messaging, and signe…

MERX - TRON Resource Exchange

exchange.merx/mcp

Manages TRON energy and bandwidth purchasing, resource monitoring, transaction cost estimation, wallet operations, token transfer…

Wisely x402 Agent-Payment Infrastructure

com.wiselyenterprisesllc/x402-agent-payment-infrastructure

Provides agent payment workflows for x402 endpoints, wallet handoffs, receipts, creator catalogs, local commerce bridges, endpoin…

AgentTools Hub

io.github.Thyphex/agenttools-hub

Offers calculators, unit and data converters, reference lookups, live crypto data, wallet utilities, and paid x402 access.