Skip to content

TgPay Merchant API

by tgpaybot.com · remote · no sign-in to list tools · v1.0.2 · published by com.tgpaybot

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

Deletes · 4Changes · 51 high finding

20 tools: 4 can delete or cancel things, 5 change things and 11 only read.

Scanned Oct 21, 2026

3 checks matched something in the tool definitions. No finding is not a safety guarantee. How the checks work.

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

Findings

Matches of fixed checks, with the text they matched.

1 high2 warn
  • The description refers to ".env".

    Matched text

    description: "...exactly once: save it to the project's .env immediately, never print it in logs). T..."

    What this check looks for
  • The server marks "connect_status" as not read-only (readOnlyHint: false), and its words say it reads.

    Matched text

    annotations: {"readOnlyHint":false,"destructiveHint":false}; The name "connect_status" says "status": a word for reading.

    What this check looks for
  • The server marks "archiveSubscriptionPlan" not destructive (destructiveHint: false), and its own name, description or input give the class "destructive".

    Matched text

    annotations: {"readOnlyHint":false,"destructiveHint":false}; The name "archiveSubscriptionPlan" says "archive": a word for removing or ending something.

    What this check looks for

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

20 tools

Deletes or cancels 4Claude Code: deny
  • archiveSubscriptionPlanStop new signups for a plan (live subscriptions keep renewing).1 finding

    Why it is in this group

    • The name "archiveSubscriptionPlan" says "archive": a word for removing or ending something.
    • The server marks it not destructive (destructiveHint: false), but an annotation never lowers a class.

    Findings

    • Warn

      The server marks "archiveSubscriptionPlan" not destructive (destructiveHint: false), and its own name, description or input give the class "destructive".

      Matched text

      annotations: {"readOnlyHint":false,"destructiveHint":false}; The name "archiveSubscriptionPlan" says "archive": a word for removing or ending something.

      What this check looks for
    Description, as the server wrote it
    Stop new signups for a plan (live subscriptions keep renewing).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
  • cancelSubscriptionStop future charges for one subscription (paid time runs out).No findings

    Why it is in this group

    • The name "cancelSubscription" says "cancel": a word for removing or ending something.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    Stop future charges for one subscription (paid time runs out).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
  • deleteCheckDelete an unclaimed check (refunds the hold).No findings

    Why it is in this group

    • The name "deleteCheck" says "delete": a word for removing or ending something.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    Delete an unclaimed check (refunds the hold).

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
  • deleteInvoiceDelete an unpaid invoice.No findings

    Why it is in this group

    • The name "deleteInvoice" says "delete": a word for removing or ending something.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    Delete an unpaid invoice.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: true
Changes things 5Claude Code: ask
  • connectStart token issuance WITHOUT the Mini App UI: creates a merchant-app request and returns a t.me approve link plus a poll_secret.No findings

    Why it is in this group

    • The description's first verb is "start": a word for a change.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
  • connect_statusPoll a connect request.Reads private data2 findings

    Why it is in this group

    • The name "connect_status" says "status": a word for reading.
    • The server marks it as not read-only (readOnlyHint: false).

    What it can reach

    • private-dataThe input names a secret (input.poll_secret), and the tool reads: it reads secrets.

    Findings

    • High

      The description refers to ".env".

      Matched text

      description: "...exactly once: save it to the project's .env immediately, never print it in logs). T..."

      What this check looks for
    • Warn

      The server marks "connect_status" as not read-only (readOnlyHint: false), and its words say it reads.

      Matched text

      annotations: {"readOnlyHint":false,"destructiveHint":false}; The name "connect_status" says "status": a word for reading.

      What this check looks for
    Description, as the server wrote it
    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.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
  • createInvoiceCreate a one-off payment invoice; the payer opens result.mini_app_invoice_url.No findings

    Why it is in this group

    • The name "createInvoice" says "create": a word for a change.
    Description, as the server wrote it
    Create a one-off payment invoice; the payer opens result.mini_app_invoice_url. See the invoices doc.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
  • createSubscriptionPlanCreate an IMMUTABLE recurring-billing plan; send payers to result.mini_app_subscribe_url.No findings

    Why it is in this group

    • The name "createSubscriptionPlan" says "create": a word for a change.
    Description, as the server wrote it
    Create an IMMUTABLE recurring-billing plan; send payers to result.mini_app_subscribe_url. See the subscriptions doc.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
  • updateAppUpdate app name / webhook_url (https) / webhook_events opt-in list.Can send data outNo findings

    Why it is in this group

    • The name "updateApp" says "update": a word for a change.

    What it can reach

    • outboundThe input takes a URL (input.webhook_url): a request to a URL can carry data to whoever runs it.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
Only reads 11Claude Code: allow
  • get_docsRead a TgPay Merchant API integration doc.Reads private dataNo findings

    Why it is in this group

    • The name "get_docs" says "get": a word for reading.

    What it can reach

    • private-dataThe name "get_docs" says "get" and "doc": it reads documents.
    • private-dataThe description's first sentence says "read" and "doc": it reads documents.
    Description, as the server wrote it
    Read a TgPay Merchant API integration doc. START HERE before integrating: topics quickstart, invoices, subscriptions, transfers-checks, webhooks, errors.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
  • getBalanceMerchant app balance per asset (available + onhold).No findings

    Why it is in this group

    • The name "getBalance" says "get": a word for reading.
    Description, as the server wrote it
    Merchant app balance per asset (available + onhold).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
  • getChecksList checks.No findings

    Why it is in this group

    • The name "getChecks" says "get": a word for reading.
    Description, as the server wrote it
    List checks.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
  • getCurrenciesSupported crypto assets (code/name/decimals) and fiats.No findings

    Why it is in this group

    • The name "getCurrencies" says "get": a word for reading.
    Description, as the server wrote it
    Supported crypto assets (code/name/decimals) and fiats.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
  • getExchangeRatesCurrent asset↔fiat display rates.No findings

    Why it is in this group

    • The name "getExchangeRates" says "get": a word for reading.
    Description, as the server wrote it
    Current asset↔fiat display rates.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
  • getInvoicesList invoices (newest first).No findings

    Why it is in this group

    • The name "getInvoices" says "get": a word for reading.
    Description, as the server wrote it
    List invoices (newest first).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
  • getMeVerify the token: app id, name, webhook config, token scopes.No findings

    Why it is in this group

    • The name "getMe" says "get": a word for reading.
    Description, as the server wrote it
    Verify the token: app id, name, webhook config, token scopes.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
  • getStatsApp volume/count stats for a period.No findings

    Why it is in this group

    • The name "getStats" says "get": a word for reading.
    Description, as the server wrote it
    App volume/count stats for a period.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
  • getSubscriptionPlansList subscription plans.No findings

    Why it is in this group

    • The name "getSubscriptionPlans" says "get": a word for reading.
    Description, as the server wrote it
    List subscription plans.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
  • getSubscriptionsList subscriptions (subscribers).No findings

    Why it is in this group

    • The name "getSubscriptions" says "get": a word for reading.
    Description, as the server wrote it
    List subscriptions (subscribers).

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
  • getTransfersList app→user transfers.No findings

    Why it is in this group

    • The name "getTransfers" says "get": a word for reading.
    Description, as the server wrote it
    List app→user transfers.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Exfil surface

Which tools read private data, which read text someone else can write, and which can send data out. One of each is a path a prompt injection can use.

No private-data, untrusted-input, outbound path in this server alone: no tool is tagged untrusted-input.

Reads private data2
Reads files, mail, messages, databases, secrets, calendars or repositories.
Reads text others write0
Brings in text someone else can write: web pages, inbound email, messages, issues and comments.
Can send data out1
Can carry data to people or systems: it sends, posts or publishes, or takes a recipient, channel or URL.

Other servers in the same agent add their own tools to these paths. Audit your whole setup to see them together.

Remote posture

What anyone on the internet sees at the remote endpoint: an anonymous initialize and tools/list, and the public OAuth metadata.

Looked at Oct 22, 2026, 14:42 UTC, unchanged since Oct 22, 2026. No credentials were sent and no tool was called. What is looked at.

Reachable
yes
HTTP status of an anonymous initialize
200
tools/list served without credentials
yes
Tools that change things, listed without credentials
9
Protocol version
2025-06-18
WWW-Authenticate on 401
not observed
resource_metadata in WWW-Authenticate
none
RFC 9728 protected resource metadata
none
Authorization servers
none
Legacy HTTP+SSE transport
no
Dynamic client registration
not observed
Client ID metadata documents
not observed
  • HighThe whole server

    The endpoint served tools/list without credentials, and the list has 9 tools that change things (4 destructive, 5 write). Whether a call also works without credentials was not tested: tools are never called.

    Matched text

    https://app.tgpaycrypto.com/mcp: tools/list returned 20 tools to an anonymous client, including deleteInvoice (destructive), deleteCheck (destructive), archiveSubscriptionPlan (destructive), cancelSubscription (destructive), connect (write) and 4 more

    What this check looks for

Install

Pinned to version 1.0.2. Values in angle brackets are yours to fill in.

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

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change or a way out, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__merchant-api__get_docs",
      "mcp__merchant-api__getMe",
      "mcp__merchant-api__getBalance",
      "mcp__merchant-api__getCurrencies",
      "mcp__merchant-api__getExchangeRates",
      "mcp__merchant-api__getStats",
      "mcp__merchant-api__getInvoices",
      "mcp__merchant-api__getChecks",
      "mcp__merchant-api__getTransfers",
      "mcp__merchant-api__getSubscriptionPlans",
      "mcp__merchant-api__getSubscriptions"
    ],
    "ask": [
      "mcp__merchant-api__connect",
      "mcp__merchant-api__connect_status",
      "mcp__merchant-api__createInvoice",
      "mcp__merchant-api__createSubscriptionPlan",
      "mcp__merchant-api__updateApp"
    ],
    "deny": [
      "mcp__merchant-api__deleteInvoice",
      "mcp__merchant-api__deleteCheck",
      "mcp__merchant-api__archiveSubscriptionPlan",
      "mcp__merchant-api__cancelSubscription"
    ]
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. A read that can send data out (it takes a URL, say) asks first too. It assumes the server is installed as merchant-api. Review it before you use it.

Capability tags behind 3 rules
  • mcp__merchant-api__get_docs private-data
  • mcp__merchant-api__connect_status private-data
  • mcp__merchant-api__updateApp outbound