MCP Radar
Servidor MCP

TgPay Merchant API

com.tgpaybot/merchant-api
Cripto y Web3 Pagos y fintech Público y accesible MCP 2026-07-28

Qué hace este MCP

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

Capacidades

Herramientas

20 herramientas
archiveSubscriptionPlan
Stop new signups for a plan (live subscriptions keep renewing).
Esquema de entrada 
{'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).
Destructivo
Esquema de entrada 
{'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.
Esquema de entrada 
{'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.
Esquema de entrada 
{'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.
Esquema de entrada 
{'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.
Esquema de entrada 
{'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).
Destructivo
Esquema de entrada 
{'type': 'object', 'required': ['check_id'], 'properties': {'check_id': {'type': 'integer', 'description': 'The check to delete.'}}}
deleteInvoice
Delete an unpaid invoice.
Destructivo
Esquema de entrada 
{'type': 'object', 'required': ['invoice_id'], 'properties': {'invoice_id': {'type': 'integer', 'description': 'The invoice to delete.'}}}
getBalance
Merchant app balance per asset (available + onhold).
Solo lectura
Esquema de entrada 
{'type': 'object', 'properties': {}}
getChecks
List checks.
Solo lectura
Esquema de entrada 
{'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.
Solo lectura
Esquema de entrada 
{'type': 'object', 'properties': {}}
get_docs
Read a TgPay Merchant API integration doc. START HERE before integrating: topics quickstart, invoices, subscriptions, transfers-checks, webhooks, errors.
Solo lectura
Esquema de entrada 
{'type': 'object', 'required': ['topic'], 'properties': {'topic': {'type': 'string', 'description': 'quickstart | invoices | subscriptions | transfers-checks | webhooks | errors'}}}
getExchangeRates
Current asset↔fiat display rates.
Solo lectura
Esquema de entrada 
{'type': 'object', 'properties': {}}
getInvoices
List invoices (newest first).
Solo lectura
Esquema de entrada 
{'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.
Solo lectura
Esquema de entrada 
{'type': 'object', 'properties': {}}
getStats
App volume/count stats for a period.
Solo lectura
Esquema de entrada 
{'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.
Solo lectura
Esquema de entrada 
{'type': 'object', 'properties': {}}
getSubscriptions
List subscriptions (subscribers).
Solo lectura
Esquema de entrada 
{'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.
Solo lectura
Esquema de entrada 
{'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.
Esquema de entrada 
{'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.'}}}
Historial

Cambios recientes en herramientas

Añadido
updateApp
17 de September de 2026 a las 12:37
Añadido
cancelSubscription
17 de September de 2026 a las 12:37
Añadido
archiveSubscriptionPlan
17 de September de 2026 a las 12:37
Añadido
createSubscriptionPlan
17 de September de 2026 a las 12:37
Añadido
deleteCheck
17 de September de 2026 a las 12:37
Añadido
deleteInvoice
17 de September de 2026 a las 12:37
Añadido
createInvoice
17 de September de 2026 a las 12:37
Añadido
getSubscriptions
17 de September de 2026 a las 12:37
Añadido
getSubscriptionPlans
17 de September de 2026 a las 12:37
Añadido
getTransfers
17 de September de 2026 a las 12:37
Añadido
getChecks
17 de September de 2026 a las 12:37
Añadido
getInvoices
17 de September de 2026 a las 12:37
Añadido
getStats
17 de September de 2026 a las 12:37
Añadido
getExchangeRates
17 de September de 2026 a las 12:37
Añadido
getCurrencies
17 de September de 2026 a las 12:37
Añadido
getBalance
17 de September de 2026 a las 12:37
Añadido
getMe
17 de September de 2026 a las 12:37
Añadido
connect_status
17 de September de 2026 a las 12:37
Añadido
connect
17 de September de 2026 a las 12:37
Añadido
get_docs
17 de September de 2026 a las 12:37
Descubrir

Servidores MCP similares

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.