Connect

8 clients · secrets stay placeholders

JSON (mcpServers)Claude CodeCodexOpenCodeCursorVS CodeGemini CLIGoose

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

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

[mcp_servers.merchant-api]
url = "https://app.tgpaycrypto.com/mcp"
env_http_headers = { "TgPayCrypto-API-Token" = "TGPAYCRYPTO_API_TOKEN" }

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "merchant-api": {
      "type": "remote",
      "url": "https://app.tgpaycrypto.com/mcp",
      "enabled": true,
      "headers": {
        "TgPayCrypto-API-Token": "{env:TGPAYCRYPTO_API_TOKEN}"
      }
    }
  }
}

{
  "mcpServers": {
    "merchant-api": {
      "type": "http",
      "url": "https://app.tgpaycrypto.com/mcp",
      "headers": {
        "TgPayCrypto-API-Token": "${TGPAYCRYPTO_API_TOKEN}"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=merchant-api&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vYXBwLnRncGF5Y3J5cHRvLmNvbS9tY3AiLCJoZWFkZXJzIjp7IlRnUGF5Q3J5cHRvLUFQSS1Ub2tlbiI6IiR7VEdQQVlDUllQVE9fQVBJX1RPS0VOfSJ9fQ%3D%3D"
}

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

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

extensions:
  "merchant-api":
    enabled: true
    name: "merchant-api"
    type: streamable_http
    uri: "https://app.tgpaycrypto.com/mcp"
    headers:
      "TgPayCrypto-API-Token": "${TGPAYCRYPTO_API_TOKEN}"
    timeout: 300

Placeholders to fill from your own secret store: ${TGPAYCRYPTO_API_TOKEN}. The registry never accepts secret values.

Quality 82 / 100good

protocol75 · weight 25

warn
protocol.modernnewest supported version is 2025-06-18; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
n/a
protocol.statelessonly applies to 2026-07-28 servers
pass
protocol.transportstreamable HTTP
n/a
protocol.list_ttlonly applies to 2026-07-28 servers

authorizationn/a · weight 15

n/a
auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
n/a
auth.secret_in_urlno templated URL

tool hygiene79 · weight 30

warn
tools.descriptions1 of 20 tools have a description under 20 characters
pass
tools.description_lengthdescriptions are concise
pass
tools.schemasevery tool has an object input schema
pass
tools.annotations20 of 20 tools declare readOnlyHint or destructiveHint
fail
tools.directory_hintsno tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: getInvoices (idempotentHint, openWorldHint); getTransfers (idempotentHint, openWorldHint); deleteInvoice (idempotentHint, openWorldHint); …
pass
tools.token_costabout 1,977 tokens to load every tool
pass
tools.api_dumptools are not a one-to-one API dump

stability100 · weight 15

pass
stability.changesno tool changes in 30 days
pass
stability.rug_pullno tool changed its meaning under the same name

dependenciesn/a · weight 15

n/a
deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

20 tools, about 1,977 tokens to load them all · tool set edcf9e664ece · checked 2026-10-20 10:03 UTC

Tool changes

No tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 79 / 100

no-repository

provenance55

liveness99

freshness85

hygiene80

+dns-namespace +website +reachable +uptime-97% ~updated-43d-ago -no-repository

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Endpoints

remote	auth	reachable	uptime 30d	p50	protocol	last ok
`https://app.tgpaycrypto.com/mcp` streamable-http	none	yes	97%	586 ms	2025-06-18	2026-10-20

Tools (20)

`archiveSubscriptionPlan`	Stop new signups for a plan (live subscriptions keep renewing).
`cancelSubscription`destructive	Stop future charges for one subscription (paid time runs out).
`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.
`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.
`createInvoice`	Create a one-off payment invoice; the payer opens result.mini_app_invoice_url. See the invoices doc.
`createSubscriptionPlan`	Create an IMMUTABLE recurring-billing plan; send payers to result.mini_app_subscribe_url. See the subscriptions doc.
`deleteCheck`destructive	Delete an unclaimed check (refunds the hold).
`deleteInvoice`destructive	Delete an unpaid invoice.
`getBalance`read-only	Merchant app balance per asset (available + onhold).
`getChecks`read-only	List checks.
`getCurrencies`read-only	Supported crypto assets (code/name/decimals) and fiats.
`get_docs`read-only	Read a TgPay Merchant API integration doc. START HERE before integrating: topics quickstart, invoices, subscriptions, transfers-checks, webhooks, errors.
`getExchangeRates`read-only	Current asset↔fiat display rates.
`getInvoices`read-only	List invoices (newest first).
`getMe`read-only	Verify the token: app id, name, webhook config, token scopes.
`getStats`read-only	App volume/count stats for a period.
`getSubscriptionPlans`read-only	List subscription plans.
`getSubscriptions`read-only	List subscriptions (subscribers).
`getTransfers`read-only	List app→user transfers.
`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.

Schemas: list_tools.

Similar MCP servers

Official server.json

{
  "name": "com.tgpaybot/merchant-api",
  "title": "TgPay Merchant API",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://app.tgpaycrypto.com/mcp",
      "type": "streamable-http",
      "headers": [
        {
          "name": "TgPayCrypto-API-Token",
          "isSecret": true,
          "description": "Merchant API token. Optional — without it the connect tool issues a scoped token after one-tap approval in the TgPay Telegram bot."
        }
      ]
    }
  ],
  "version": "1.0.2",
  "websiteUrl": "https://app.tgpaycrypto.com/mcp",
  "description": "Accept crypto payments via the TgPay Merchant API — invoices, subscriptions, webhooks."
}