このMCPでできること
Enables merchants to create crypto payment invoices, recurring subscription plans, payment webhooks, and related account and transaction management.
機能
ツール
20
ツール
archiveSubscriptionPlan
Stop new signups for a plan (live subscriptions keep renewing).
入力スキーマ
{'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).
破壊的操作あり
入力スキーマ
{'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.
入力スキーマ
{'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.
入力スキーマ
{'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.
入力スキーマ
{'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.
入力スキーマ
{'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).
破壊的操作あり
入力スキーマ
{'type': 'object', 'required': ['check_id'], 'properties': {'check_id': {'type': 'integer', 'description': 'The check to delete.'}}}
deleteInvoice
Delete an unpaid invoice.
破壊的操作あり
入力スキーマ
{'type': 'object', 'required': ['invoice_id'], 'properties': {'invoice_id': {'type': 'integer', 'description': 'The invoice to delete.'}}}
getBalance
Merchant app balance per asset (available + onhold).
読み取り専用
入力スキーマ
{'type': 'object', 'properties': {}}
getChecks
List checks.
読み取り専用
入力スキーマ
{'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.
読み取り専用
入力スキーマ
{'type': 'object', 'properties': {}}
get_docs
Read a TgPay Merchant API integration doc. START HERE before integrating: topics quickstart, invoices, subscriptions, transfers-checks, webhooks, errors.
読み取り専用
入力スキーマ
{'type': 'object', 'required': ['topic'], 'properties': {'topic': {'type': 'string', 'description': 'quickstart | invoices | subscriptions | transfers-checks | webhooks | errors'}}}
getExchangeRates
Current asset↔fiat display rates.
読み取り専用
入力スキーマ
{'type': 'object', 'properties': {}}
getInvoices
List invoices (newest first).
読み取り専用
入力スキーマ
{'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.
読み取り専用
入力スキーマ
{'type': 'object', 'properties': {}}
getStats
App volume/count stats for a period.
読み取り専用
入力スキーマ
{'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.
読み取り専用
入力スキーマ
{'type': 'object', 'properties': {}}
getSubscriptions
List subscriptions (subscribers).
読み取り専用
入力スキーマ
{'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.
読み取り専用
入力スキーマ
{'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.
入力スキーマ
{'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.'}}}
履歴
最近のツール変更
追加
updateApp
2026年9月17日12:37
追加
cancelSubscription
2026年9月17日12:37
追加
archiveSubscriptionPlan
2026年9月17日12:37
追加
createSubscriptionPlan
2026年9月17日12:37
追加
deleteCheck
2026年9月17日12:37
追加
deleteInvoice
2026年9月17日12:37
追加
createInvoice
2026年9月17日12:37
追加
getSubscriptions
2026年9月17日12:37
追加
getSubscriptionPlans
2026年9月17日12:37
追加
getTransfers
2026年9月17日12:37
追加
getChecks
2026年9月17日12:37
追加
getInvoices
2026年9月17日12:37
追加
getStats
2026年9月17日12:37
追加
getExchangeRates
2026年9月17日12:37
追加
getCurrencies
2026年9月17日12:37
追加
getBalance
2026年9月17日12:37
追加
getMe
2026年9月17日12:37
追加
connect_status
2026年9月17日12:37
追加
connect
2026年9月17日12:37
追加
get_docs
2026年9月17日12:37
関連MCP
類似のMCPサーバー
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.