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.
20 tools: 4 can delete or cancel things, 5 change things and 11 only read.
Scanned Oct 21, 2026
- Deletes or cancels4Claude Code: deny: see these tools
- Can't be undone0Claude Code: ask
- Changes things5Claude Code: ask: see these tools
- Only reads11Claude Code: allow: see these tools
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/mcpFindings
Matches of fixed checks, with the text they matched.
- Highconnect_status
The description refers to ".env".
What this check looks forMatched text
description: "...exactly once: save it to the project's .env immediately, never print it in logs). T..."
- Warnconnect_status
The server marks "connect_status" as not read-only (readOnlyHint: false), and its words say it reads.
What this check looks forMatched text
annotations: {"readOnlyHint":false,"destructiveHint":false}; The name "connect_status" says "status": a word for reading.
The server marks "archiveSubscriptionPlan" not destructive (destructiveHint: false), and its own name, description or input give the class "destructive".
What this check looks forMatched text
annotations: {"readOnlyHint":false,"destructiveHint":false}; The name "archiveSubscriptionPlan" says "archive": a word for removing or ending something.
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".
What this check looks forMatched text
annotations: {"readOnlyHint":false,"destructiveHint":false}; The name "archiveSubscriptionPlan" says "archive": a word for removing or ending something.
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".
What this check looks forMatched text
description: "...exactly once: save it to the project's .env immediately, never print it in logs). T..."
- Warn
The server marks "connect_status" as not read-only (readOnlyHint: false), and its words say it reads.
What this check looks forMatched text
annotations: {"readOnlyHint":false,"destructiveHint":false}; The name "connect_status" says "status": a word for reading.
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.
What this check looks forMatched 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
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/mcpRun 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.
{
"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