io.github.codespar/mcp-transak

Cancel a Transak order. Only works while the order is in a cancellable state (awaiting payment / pending). Completed or in-flight on-chain orders cannot be cancelled.

Create a Transak order. Use isBuyOrSell='BUY' to onramp (fiat→crypto, funds delivered to walletAddress) or 'SELL' to offramp (crypto→fiat, payout to the linked bank account). Returns the order object with status, a widget/redirect URL if required, and the partner-side id.

Get the KYC status of a buyer the partner has previously sent through Transak. Look up by partnerCustomerId (preferred — your stable id) or email. Returns kycStatus (NOT_SUBMITTED, IN_REVIEW, APPROVED, REJECTED, EXPIRED), tier, country, and the timestamps. Use this to skip re-KYC for returning buyers and unlock higher limits.

Get a Transak order by its Transak order id. Returns full status, fiat/crypto amounts, fees, tx hash (once on-chain), and current state.

Get the min and max trade amount for a fiat+crypto+country combination — what's the smallest USD a US buyer can spend on USDC/Polygon, and what's the cap before extra KYC kicks in? Public endpoint. Pair with get_quote so you can prevalidate amount before opening the widget.

Get the authenticated partner's account profile (name, api key info, configured webhooks, default currencies). Useful for debugging which partner credentials the server is using.

Get the partner's settlement balance(s) — Transak holds partner liquidity per fiat to fund SELL payouts and reserves earned commissions until they settle. Returns balances broken down by currency, available vs pending, and last-settlement timestamp. Use this to monitor funding levels before promoting a high-volume corridor.

Get a fiat↔crypto price quote (public, no auth). Returns the rate, fees, min/max, delivery network, and the exact cryptoAmount the buyer receives for a given fiatAmount (or vice versa). Use this before calling create_order to show the user a price they can confirm.

Get the current per-user transaction limits granted by Transak based on the user's KYC tier and country (daily, weekly, monthly, lifetime caps in fiat). Look up by partnerCustomerId or email. Use before quoting big-ticket purchases so you can warn a buyer they'll need a tier-up flow first.

List the countries Transak serves, with allowed fiat currencies, payment methods, and KYC requirements per country. Optionally filter by fiatCurrency to see only countries where that fiat is supported. Public endpoint — call this as a discovery step before showing a country picker.

List all crypto assets Transak supports, including network, decimals, pay-in/pay-out eligibility, and jurisdictional restrictions (US state blocklists etc). Public endpoint.

List all fiat currencies Transak supports, with per-currency payment methods, limits, and country restrictions. Public endpoint — safe to call without credentials. Use as a discovery step before rendering a funding flow.

List the network/gas fees Transak charges (or estimates) per crypto+network combination. Useful for showing buyers the all-in landed cost or for choosing the cheapest network when an asset is multi-chain (e.g. USDC on Polygon vs Ethereum). Public endpoint.

List Transak orders for the partner account. Filter by status, walletAddress, partnerOrderId, isBuyOrSell, or createdAt date range. Use this to reconcile webhook-driven state, run sweeps on pending orders, or pull a partner-period statement.

List payment methods available for a given fiat currency (card, Apple Pay, Google Pay, SEPA, UPI, Pix, wire, etc) with min/max amounts and processing time. Public endpoint. Use to dynamically build a funding-method picker per corridor.

Mint a fresh short-lived access-token from the partner api-secret. Some Partner API tiers require this token (sent as the access-token header) on order/user endpoints. The token is short-lived (~minutes); cache it and refresh on 401. Returns { accessToken, expiresAt }.

Update a Transak order after creation. Used for partner-side post-creation actions such as marking a SELL crypto deposit transaction hash, attaching/changing the partnerCustomerId, refreshing the redirectURL, or correcting the buyer email before KYC. Only mutable fields are accepted; immutable fields (amount, currency, network) require a fresh order.

Locally verify the HMAC-SHA256 signature on a Transak webhook delivery. Transak signs the raw request body with the partner api-secret as the HMAC key; the signature is delivered in the x-transak-signature header (sometimes also `signature`). Pass the raw body string + the header value and this returns { valid: boolean }. Does NOT call Transak — pure local crypto. Always use this before trusting webhook contents.