TgPay Merchant API

Connect Remote server

claude mcp add --transport http merchant-api https://app.tgpaycrypto.com/mcp --header "TgPayCrypto-API-Token: <TGPAYCRYPTO_API_TOKEN>"

{
  "mcpServers": {
    "merchant-api": {
      "url": "https://app.tgpaycrypto.com/mcp",
      "headers": {
        "TgPayCrypto-API-Token": "<TGPAYCRYPTO_API_TOKEN>"
      }
    }
  }
}

{
  "servers": {
    "merchant-api": {
      "type": "http",
      "url": "https://app.tgpaycrypto.com/mcp",
      "headers": {
        "TgPayCrypto-API-Token": "<TGPAYCRYPTO_API_TOKEN>"
      }
    }
  }
}

Settings > Connectors > Add custom connector
URL: https://app.tgpaycrypto.com/mcp

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools 20 found in our last check

• get_docs

  Read a TgPay Merchant API integration doc. START HERE before integrating: topics quickstart, invoices, subscriptions, transfers-checks, webhooks, errors.

• 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 ("Create app and issue token") in the @tgpaycryptobot bot — then call connect_status with th…

• 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 mov…

• getMe

  Verify the token: app id, name, webhook config, token scopes.

• getBalance

  Merchant app balance per asset (available + onhold).

• getCurrencies

  Supported crypto assets (code/name/decimals) and fiats.

• getExchangeRates

  Current asset↔fiat display rates.

• getStats

  App volume/count stats for a period.

• getInvoices

  List invoices (newest first).

• getChecks

  List checks.

• getTransfers

  List app→user transfers.

• getSubscriptionPlans

  List subscription plans.

• getSubscriptions

  List subscriptions (subscribers).

• createInvoice

  Create a one-off payment invoice; the payer opens result.mini_app_invoice_url. See the invoices doc.

• deleteInvoice

  Delete an unpaid invoice.

• deleteCheck

  Delete an unclaimed check (refunds the hold).

• createSubscriptionPlan

  Create an IMMUTABLE recurring-billing plan; send payers to result.mini_app_subscribe_url. See the subscriptions doc.

• archiveSubscriptionPlan

  Stop new signups for a plan (live subscriptions keep renewing).

• cancelSubscription

  Stop future charges for one subscription (paid time runs out).

• 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.

Headers

Details

More finance and crypto servers See all

• RightCard

  Which of your credit cards to use at any store, from verified bank data. No bank login.

• Africa Compliance Data

  African holidays, business days, VAT, withholding tax, tax treaties, tax IDs and filing deadlines

• BusCalc Business Calculators

  Business calculators, data lookups, replayable receipts, and documentation for enterprise pilots.

• CarLoanMath

  US car loan math: monthly payment, compare loans, max price for your budget, amortization. Free.

• InfinityVolume

  Dollar volume across 13 stock markets and US sectors, against each one's own normal. No prices.

• xytara MCP Executor

  Pay-per-call MCP tools and signed on-chain attestations: 20 free/day, then x402 or a spend key.