mcp-transak

Name: mcp-transak
Author: codespar

本地服务

github.com/codespar金融数据2754 周前更新

代码仓库

关于 mcp-transak

mcp-transak 是 Transak 的 MCP 服务，用于法币与加密货币之间的兑换（on/off-ramp），覆盖约 170 个国家和多条区块链。它面向需要通过 Partner API 以服务端方式创建和跟踪订单的开发者与 Agent。服务还提供报价、限额和 Webhook 签名校验等工具。

主要功能

01通过 Partner API 创建、查询、更新和取消订单
02按法币、加密货币和国家查询报价与最小最大限额
03列出支持的法币、加密货币、支付方式和国家
04查询网络费用、合作方余额与用户 KYC 状态
05本地校验 Webhook 的 HMAC-SHA256 签名

适用场景

01Agent 按地区比较 Transak 与其他服务商的报价后选择兑换路径
02跟踪买家订单状态并通过 Webhook 对账
03检查某个国家或买家的交易限额与 KYC 状态

MCP 相关

该项目是 MCP 服务，向 MCP 客户端暴露 18 个工具，用于调用 Transak Partner API 的订单、报价和账户接口。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "codespar-mcp-transak": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-transak"
      ],
      "env": {
        "TRANSAK_API_KEY": "<TRANSAK_API_KEY>",
        "TRANSAK_API_SECRET": "<TRANSAK_API_SECRET>",
        "TRANSAK_ENV": "<TRANSAK_ENV>"
      }
    }
  }
}

启动命令npx -y @codespar/mcp-transak

需要配置的环境变量

TRANSAK_API_KEY密钥Transak partner API key (from partner dashboard). Used as partnerApiKey query param on public quote endpoint and bundled with api-secret to mint the access-token for Partner API calls.

TRANSAK_API_SECRET密钥Transak partner API secret. Sent as the api-secret header to endpoints that require server-to-server authentication (and used to mint access tokens for order endpoints).

TRANSAK_ENVEnvironment selector: 'staging' (default) targets https://api-stg.transak.com; 'production' targets https://api.transak.com.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@codespar/mcp-transak0.2.0-alpha.3stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
email	string	是	买家电子邮箱（用于 KYC 和收据）
network	string	是	区块链网络（ethereum、polygon、bsc、solana、bitcoin、arbitrum、optimism、base 等）
fiatAmount	number	否	法币金额，以主要货币单位计。必须设置 fiatAmount 或 cryptoAmount。
themeColor	string	否	可选的十六进制颜色值（不含 #），用于托管式组件品牌定制
isBuyOrSell	enum	是	BUY = 法币→加密货币入金；SELL = 加密货币→法币出金BUY \| SELL
redirectURL	string	否	托管流程完成后 Transak 重定向至的 URL
cryptoAmount	number	否	加密货币金额。必须设置 fiatAmount 或 cryptoAmount。
fiatCurrency	string	是	ISO-4217 法币货币代码（USD、EUR、BRL、GBP、INR 等）
paymentMethod	string	否	来自 list_payment_methods 的方式 ID（credit_debit_card、apple_pay、google_pay、sepa_bank_transfer、pix、upi 等）
walletAddress	string	是	目标（BUY）或来源（SELL）加密货币钱包地址
cryptoCurrency	string	是	加密货币代码（ETH、USDC、USDT、BTC、SOL、MATIC 等）
partnerOrderId	string	是	商户侧稳定订单 ID（会在 webhook 中原样返回）
partnerCustomerId	string	否	商户侧稳定用户 ID（用于回访用户）

详细介绍

@codespar/mcp-transak

用于 Transak 的 MCP 服务——覆盖约 170 个国家/地区的法币↔加密货币出入金服务，支持多条链（Ethereum、Solana、Polygon、BSC、Bitcoin、Arbitrum、Optimism、Base 等）。

Transak 是 MoonPay 的天然搭档：两者解决同一个问题（将本地法币兑换为链上加密货币，或反向兑换），但合作伙伴名单、国家/地区覆盖范围和定价曲线各不相同。将两者打包使用，可以让 Agent 商务流程按不同交易路线选择最佳方案，而不是绑定单一服务商。

为什么同时使用 MoonPay 和 Transak

覆盖范围：MoonPay 列出了约 160 个国家/地区，Transak 约 170 个。两者覆盖范围重合很多，但边缘差异也很重要——某些拉美、中东和北非以及亚太地区的交易路线在其中一家服务商上表现更好。
合作伙伴：两者的 DEX、钱包和 dapp 合作伙伴名单各不相同，这会影响特定买家的 KYC 复用情况和托管方式。
定价：费用、汇率差价以及最低/最高限额因交易路线而异。Agent 可以在两者上调用 get_quote，进行比较后再选择交易路线。
冗余：如果一家服务商触发速率限制、降低某个国家/地区的风险级别或暂停 KYC，另一家仍可维持流程正常运行。

此 MCP 服务专注于合作伙伴 API（服务端到服务端），而非小组件。Agent 可直接创建订单、轮询状态，并通过 Webhook 对账。

状态

0.1.0-alpha.1。已在 api-stg.transak.com 上对外部货币、支付方式和报价端点进行了实时验证。合作伙伴订单端点路径（/api/v2/orders、/api/v2/orders/{id}、/cancel、/api/v2/partner/me）遵循文档中的约定，但其中少数路径只有在 Transak 合作伙伴控制面板中才能完整查看——使用真实密钥进行验证时可能需要做少量调整。

工具（18）

工具	用途
`create_order`	创建 Transak 订单。
`get_order`	根据 Transak 订单 ID 获取 Transak 订单。
`list_orders`	列出合作伙伴账户的 Transak 订单。
`update_order`	创建后更新 Transak 订单。
`cancel_order`	取消 Transak 订单。
`get_quote`	获取法币↔加密货币价格报价（公开接口，无需身份验证）。
`get_order_limits`	获取法币、加密货币和国家/地区组合对应的最低和最高交易金额——例如美国买家最少可购买多少美元……
`list_fiat_currencies`	列出 Transak 支持的所有法币，以及每种货币对应的支付方式、限额和国家/地区限制……
`list_crypto_currencies`	列出 Transak 支持的所有加密资产，包括网络、小数位数、入金/出金资格和司法管辖区……
`list_payment_methods`	列出指定法币可用的支付方式（银行卡、Apple Pay、Google Pay、SEPA、UPI、Pix、电汇……）
`list_countries`	列出 Transak 服务覆盖的国家/地区，以及每个国家/地区允许使用的法币、支付方式和 KYC 要求……
`list_network_fees`	列出 Transak 按加密货币和网络收取（或估算）的网络/燃料费。
`get_partner_account`	获取已通过身份验证的合作伙伴账户资料（名称、API 密钥信息、已配置的 Webhook、默认货币）。
`get_partner_balance`	获取合作伙伴的结算余额——Transak 会按法币持有合作伙伴流动性，用于为卖出订单付款……
`refresh_access_token`	使用合作伙伴 api-secret 签发新的短期访问令牌。
`get_kyc_status`	获取合作伙伴此前通过 Transak 提交的买家 KYC 状态。
`get_user_limits`	获取 Transak 根据用户的 KYC 等级和国家/地区授予的当前单用户交易限额（数据……）
`verify_webhook_signature`	在本地验证 Transak Webhook 投递的 HMAC-SHA256 签名。

环境

变量	必需	密钥	描述
`TRANSAK_API_KEY`	是	否	合作伙伴 API 密钥（也会作为 `partnerApiKey` 传递给公共端点）
`TRANSAK_API_SECRET`	是	是	合作伙伴 API 密钥（通过 `api-secret` 标头发送）
`TRANSAK_ACCESS_TOKEN`	否	是	短期访问令牌（如果你的合作伙伴级别要求，则通过 `access-token` 标头发送）
`TRANSAK_ENV`	否	否	`staging`（默认）或 `production`

安装

npm install @codespar/mcp-transak@alpha

运行（stdio）

TRANSAK_API_KEY=... TRANSAK_API_SECRET=... mcp-transak

运行（HTTP）

TRANSAK_API_KEY=... TRANSAK_API_SECRET=... mcp-transak --http
# POST http://localhost:3000/mcp

文档

Transak：https://docs.transak.com
CodeSpar 目录：https://github.com/codespar/mcp-dev-latam

企业版

需要为 Agent 支付设置治理、预算限制和审计跟踪？CodeSpar Enterprise 在这些 MCP 服务之上添加了策略引擎、支付路由和合规模板。

身份验证

启动服务前设置以下环境变量：

TRANSAK_API_KEY （必需） — Transak 合作伙伴 API 密钥（来自合作伙伴控制面板）。在公共报价端点中用作 partnerApiKey 查询参数，并与 api-secret 一起用于为 Partner API 调用获取 access-token。
TRANSAK_API_SECRET （必需，密钥） — Transak 合作伙伴 API 密钥。通过需要服务器到服务器身份验证的端点的 api-secret 标头发送（并用于为订单端点获取访问令牌）。
TRANSAK_ENV — 环境选择器：'staging'（默认）指向 https://api-stg.transak.com；'production' 指向 https://api.transak.com。

在提供商的开发者门户中申请凭据：https://docs.transak.com。