Ashar Exchange MCP Server
OfficialAllows interaction with the Ashar Exchange API to perform PIX ↔ stablecoin exchange operations, including payin quotes and deposits, payout quotes and withdrawals, and management of PIX bank accounts.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Ashar Exchange MCP Server Create a payin quote to convert 500 BRL to USDC"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Ashar Exchange MCP Server
Model Context Protocol (MCP) server for the Ashar Exchange API — PIX ↔ USDC/USDT exchange with platform fees (payins, payouts, transfers, wallets, customers and stats).
Inspired by the BlindPay MCP: it is a standalone HTTP wrapper that calls the public API at https://api.ashar.finance/v2, authenticated via the X-Ashar-Tenant-Key header.
Features
55 tools with the
ashar_prefix, covering every API group:Quotes — payin, payout and transfer quotes (with fee markup)
PayIns — PIX deposit → stablecoin, listing and querying
Payouts — stablecoin withdrawal → PIX
Transfers — wallet → blockchain transfer
Wallets — wallets and balances
Bank Accounts — PIX bank accounts
Stats — daily/monthly metrics and fee rates
Fees — list, get, create and delete partner fee schedules
Customers — customer onboarding + sub-resources (bank accounts, blockchain wallets, custodial wallets, virtual accounts, offramp wallets)
Upload — document upload (e.g. payout supporting file)
Admin/Provisioning — provision test tenant, list tenants, manage credentials and per-tenant user markup
Selectable transport — stdio (default) or Streamable HTTP via environment variable
Actionable errors — HTTP code mapping (400/401/403/404/409/429/503) with hints
Related MCP server: Stables MCP Server
Requirements
Node.js >= 18
Installation
cd mcp
npm install
npm run buildFor development with hot-reload:
npm run devConfiguration
Variable | Description | Default |
| Tenant API key ( | — |
| API base URL |
|
|
|
|
| HTTP server port (used with the |
|
Usage
stdio (default)
{
"mcpServers": {
"ashar-exchange": {
"command": "node",
"args": ["/path/to/AsharExchangeMCP/dist/index.js"],
"env": {
"ASHAR_EXCHANGE_TENANT_KEY": "ash_proxy_..."
}
}
}
}Streamable HTTP
ASHAR_EXCHANGE_TRANSPORT=http PORT=3001 node dist/index.jsMCP endpoint:
http://localhost:3001/mcpHealth check:
http://localhost:3001/health
Consumption modes
There are two ways for a client to consume the Ashar Exchange MCP:
Option 1 — Hosted service (Streamable HTTP) ⭐
Ashar runs the MCP server as a public service on the mcp.ashar.finance subdomain. The client installs nothing — it points its MCP client to https://mcp.ashar.finance/mcp and sends the tenant key.
{
"mcpServers": {
"ashar-exchange": {
"url": "https://mcp.ashar.finance/mcp",
"headers": {
"X-Ashar-Tenant-Key": "ash_proxy_..."
}
}
}
}Public health check:
https://mcp.ashar.finance/healthIdeal for agents/LLMs that speak MCP without running infrastructure.
All requests go through the Ashar server, which applies the tenant spread/fee and can monitor every operation.
Provisioning endpoints (
ashar_provision_test_tenant) work without a key.
Option 2 — Self-host (stdio)
The client runs the server locally (or in its own container) and points it to Ashar's public API.
{
"mcpServers": {
"ashar-exchange": {
"command": "node",
"args": ["/path/to/AsharExchangeMCP/dist/index.js"],
"env": {
"ASHAR_EXCHANGE_TENANT_KEY": "ash_proxy_..."
}
}
}
}Ideal for CLIs / editors / IDEs and for clients who prefer to manage their own process.
Still goes through the public API (
https://api.ashar.finance/v2), keeping spread and monitoring server-side.
Both modes do not replace the REST API (
/v2). A traditional client (app/site/backend) integrates directly via REST; the MCP is the channel for AI agents.
Deploy (hosted service)
The mcp.ashar.finance subdomain points to the AsharExchangeMCP service on Railway (port 3001). The build uses the Dockerfile and the config in railway.json.
cd mcp
railway login
railway up # uses the Dockerfile; runs on :3001 with ASHAR_EXCHANGE_TRANSPORT=httpPublic routing (at the gateway):
mcp.ashar.finance/mcp→ service:3001/mcp(no strip)mcp.ashar.finance/health→ service:3001/health
Recommended environment variables on the service:
Var | Value |
|
|
|
|
|
|
| optional — default key for protected calls |
Typical flow
(
ashar_provision_test_tenant) — optional, to create a test tenant with a new keyashar_create_payin_quote→ashar_execute_payin(deposit)ashar_create_payout_quote→ashar_execute_payout(withdrawal)ashar_get_daily_stats/ashar_get_monthly_stats/ashar_get_fee_rates(tracking and fees)
Scripts
Script | Description |
| Compiles TypeScript to |
| Runs with hot-reload ( |
| Runs the build ( |
| Type-checks without emitting ( |
License
To be defined. Contact Ashar Finance.
Servidor Model Context Protocol (MCP) para a Ashar Exchange API — câmbio PIX ↔ USDC/USDT com fees de plataforma (payins, payouts, transfers, wallets, customers e stats).
Inspirado no BlindPay MCP: é um wrapper HTTP autônomo que chama a API pública em https://api.ashar.finance/v2, autenticado via header X-Ashar-Tenant-Key.
Recursos
55 ferramentas com prefixo
ashar_, cobrindo todos os grupos da API:Quotes — cotação de payin, payout e transfer (com markup de fees)
PayIns — depósito PIX → stablecoin, listagem e consulta
Payouts — saque stablecoin → PIX
Transfers — transferência wallet → blockchain
Wallets — carteiras e saldos
Bank Accounts — contas bancárias PIX
Stats — métricas diárias/mensais e taxas de fee
Customers — customer onboarding + sub-recursos (bank accounts, wallets, virtual accounts, custodial/offramp wallets)
Parceiro/Admin — provisionar tenant de teste, listar tenants, credenciais e user markup (spread fim-a-fim)
Upload — upload de documentos (ex.: comprovante de payout)
Transporte selecionável — stdio (padrão) ou Streamable HTTP via variável de ambiente
Erros acionáveis — mapeamento de códigos HTTP (400/401/403/404/409/429/503) com hints
Requisitos
Node.js >= 18
Instalação
cd mcp
npm install
npm run buildPara desenvolvimento com hot-reload:
npm run devConfiguração
Variável | Descrição | Padrão |
| Chave de API do tenant ( | — |
| Base URL da API |
|
|
|
|
| Porta do servidor HTTP (usada com transporte |
|
Uso
stdio (padrão)
{
"mcpServers": {
"ashar-exchange": {
"command": "node",
"args": ["/caminho/para/AsharExchangeMCP/dist/index.js"],
"env": {
"ASHAR_EXCHANGE_TENANT_KEY": "ash_proxy_..."
}
}
}
}Streamable HTTP
ASHAR_EXCHANGE_TRANSPORT=http PORT=3001 node dist/index.jsEndpoint MCP:
http://localhost:3001/mcpHealth check:
http://localhost:3001/health
Modos de consumo
Há duas formas de um cliente consumir o Ashar Exchange MCP:
Opção 1 — Serviço hospedado (Streamable HTTP) ⭐
A Ashar opera o servidor MCP como um serviço público no subdomínio mcp.ashar.finance. O cliente não instala nada — aponta seu cliente MCP para https://mcp.ashar.finance/mcp e envia a chave do tenant.
{
"mcpServers": {
"ashar-exchange": {
"url": "https://mcp.ashar.finance/mcp",
"headers": {
"X-Ashar-Tenant-Key": "ash_proxy_..."
}
}
}
}Health check público:
https://mcp.ashar.finance/healthIdeal para agentes/LLMs que falam MCP sem precisar rodar infra.
Todas as requests passam pelo servidor Ashar, que aplica o spread/fee do tenant e pode monitorar cada operação.
Endpoints de provisionamento (
ashar_provision_test_tenant) funcionam sem chave.
Opção 2 — Self-host (stdio)
O cliente roda o servidor localmente (ou no próprio container) e aponta para a API pública da Ashar.
{
"mcpServers": {
"ashar-exchange": {
"command": "node",
"args": ["/caminho/para/AsharExchangeMCP/dist/index.js"],
"env": {
"ASHAR_EXCHANGE_TENANT_KEY": "ash_proxy_..."
}
}
}
}Ideal para CLI / editores / IDEs e para clientes que preferem manter o processo por conta própria.
Continua passando pela API pública (
https://api.ashar.finance/v2), mantendo spread e monitoramento no servidor.
Ambos os modos não substituem a API REST (
/v2). Um cliente tradicional (app/site/backend) integra direto pela REST; o MCP é o canal para agentes de IA.
Deploy (serviço hospedado)
O subdomínio mcp.ashar.finance aponta para o serviço AsharExchangeMCP no Railway (porta 3001). O build é via Dockerfile e a config em railway.json.
cd mcp
railway login
railway up # usa o Dockerfile; sobe em :3001 com ASHAR_EXCHANGE_TRANSPORT=httpRoteamento público (no gateway):
mcp.ashar.finance/mcp→ serviço:3001/mcp(sem strip)mcp.ashar.finance/health→ serviço:3001/health
Variáveis de ambiente recomendadas no serviço:
Var | Valor |
|
|
|
|
|
|
| opcional — chave default p/ chamadas protegidas |
Fluxo típico
(
ashar_provision_test_tenant) — opcional, para criar um tenant de teste com uma chave novaashar_create_payin_quote→ashar_execute_payin(depósito)ashar_create_payout_quote→ashar_execute_payout(saque)ashar_get_daily_stats/ashar_get_monthly_stats/ashar_get_fee_rates(acompanhamento e fees)
Scripts
Script | Descrição |
| Compila TypeScript para |
| Executa com hot-reload ( |
| Executa o build ( |
| Verifica tipos sem emitir ( |
Licença
A definir. Contate a Ashar Finance.
针对 Ashar Exchange API 的 Model Context Protocol (MCP) 服务器 —— 用于 PIX ↔ USDC/USDT 兑换,并收取平台费用(payins、payouts、transfers、wallets、customers 和 stats)。
受 BlindPay MCP 启发:它是一个独立的 HTTP 封装,调用 https://api.ashar.finance/v2 的公共 API,通过 X-Ashar-Tenant-Key 请求头进行身份验证。
功能特性
55 个工具,均带
ashar_前缀,覆盖所有 API 分组:Quotes — payin、payout 和 transfer 报价(含费用加成)
PayIns — PIX 充值 → 稳定币,列出与查询
Payouts — 稳定币提现 → PIX
Transfers — 钱包 → 区块链转账
Wallets — 钱包与余额
Bank Accounts — PIX 银行账户
Stats — 每日/每月指标与费率
Customers — 客户入驻 + 子资源(bank accounts、wallets、virtual accounts、custodial/offramp wallets)
合作伙伴/管理 — 创建测试租户、列出租户、管理凭证和用户加价(端到端价差)
Upload — 上传文档(如 payout 证明文件)
可选择的传输方式 — stdio(默认)或通过环境变量的 Streamable HTTP
可操作的错误提示 — HTTP 状态码映射(400/401/403/404/409/429/503)并附带提示
环境要求
Node.js >= 18
安装
cd mcp
npm install
npm run build开发模式(热重载):
npm run dev配置
变量 | 说明 | 默认值 |
| 租户 API 密钥( | — |
| API 基础地址 |
|
|
|
|
| HTTP 服务器端口(配合 |
|
使用方式
stdio(默认)
{
"mcpServers": {
"ashar-exchange": {
"command": "node",
"args": ["/path/to/AsharExchangeMCP/dist/index.js"],
"env": {
"ASHAR_EXCHANGE_TENANT_KEY": "ash_proxy_..."
}
}
}
}Streamable HTTP
ASHAR_EXCHANGE_TRANSPORT=http PORT=3001 node dist/index.jsMCP 端点:
http://localhost:3001/mcp健康检查:
http://localhost:3001/health
消费模式
客户端可以通过两种方式使用 Ashar Exchange MCP:
方案一 —— 托管服务(Streamable HTTP)⭐
Ashar 在 mcp.ashar.finance 子域名上以公共服务方式运行 MCP 服务器。客户端无需安装任何东西 —— 只需将 MCP 客户端指向 https://mcp.ashar.finance/mcp 并发送租户密钥。
{
"mcpServers": {
"ashar-exchange": {
"url": "https://mcp.ashar.finance/mcp",
"headers": {
"X-Ashar-Tenant-Key": "ash_proxy_..."
}
}
}
}公共健康检查:
https://mcp.ashar.finance/health适合无需运行基础设施的 agent/LLM,直接使用 MCP。
所有请求都经由 Ashar 服务器,服务器会应用租户的 spread/fee,并可监控每笔操作。
预置端点(
ashar_provision_test_tenant)无需密钥即可使用。
方案二 —— 自托管(stdio)
客户端在本地(或自己的容器中)运行服务器,并指向 Ashar 的公共 API。
{
"mcpServers": {
"ashar-exchange": {
"command": "node",
"args": ["/path/to/AsharExchangeMCP/dist/index.js"],
"env": {
"ASHAR_EXCHANGE_TENANT_KEY": "ash_proxy_..."
}
}
}
}适合 CLI / 编辑器 / IDE,以及希望自行管理进程的客户端。
仍然经过公共 API(
https://api.ashar.finance/v2),spread 与监控保留在服务器端。
两种模式都不替代 REST API(
/v2)。传统客户端(app/网站/后端)直接通过 REST 集成;MCP 是面向 AI 代理的通道。
部署(托管服务)
mcp.ashar.finance 子域名指向 Railway 上的 AsharExchangeMCP 服务(端口 3001)。构建使用 Dockerfile,配置位于 railway.json。
cd mcp
railway login
railway up # 使用 Dockerfile;以 ASHAR_EXCHANGE_TRANSPORT=http 在 :3001 运行公共路由(网关层):
mcp.ashar.finance/mcp→ 服务:3001/mcp(无 strip)mcp.ashar.finance/health→ 服务:3001/health
服务上推荐的环境变量:
变量 | 值 |
|
|
|
|
|
|
| 可选 —— 受保护调用的默认密钥 |
典型流程
(
ashar_provision_test_tenant)—— 可选,用于创建一个带新密钥的测试租户ashar_create_payin_quote→ashar_execute_payin(充值)ashar_create_payout_quote→ashar_execute_payout(提现)ashar_get_daily_stats/ashar_get_monthly_stats/ashar_get_fee_rates(跟踪与费用)
脚本
脚本 | 说明 |
| 将 TypeScript 编译到 |
| 热重载运行( |
| 运行构建产物( |
| 类型检查但不输出( |
许可协议
待定。请联系 Ashar Finance。
Available Tools
55 toolsashar_create_bank_accountCreate Bank AccountB
Register a PIX/TED bank account for the tenant.
Args:
body (object): the bank account payload (e.g. pix_key, bank_name, holder name/document, account details) accepted by the Exchange API
Returns the created bank account.
Inputs: body (required).
ashar_create_customerCreate CustomerB
Create a customer (individual or business) for KYC/KYB.
Args:
type (string): 'individual' or 'business'
kyc_type (string): KYC tier (e.g. 'light')
email (string): customer email
country (string): two-letter country code (e.g. 'BR')
tax_id (string, optional): taxpayer id (e.g. CPF/CNPJ)
first_name, last_name (string, optional): for individuals
additional fields (object, optional): pass-through payload
Returns the created customer.
Inputs: type (required), email (required), country (required), kyc_type (required), +4 more.
ashar_create_customer_bank_accountCreate Customer Bank AccountB
Add a bank account to a customer.
Args:
customer_id (string): the customer id
body (object): the bank account payload
Returns the created bank account.
Inputs: body (required), customer_id (required).
ashar_create_customer_custodial_walletCreate Customer Custodial WalletC
Create a custodial (wallet) for a customer.
Args:
customer_id (string): the customer id
network (string): the wallet network
name (string): a display name for the wallet
external_id (string, optional): your external reference for this wallet
Returns the created wallet.
Inputs: name (required), network (required), customer_id (required), external_id.
ashar_create_customer_offramp_walletCreate Customer Offramp WalletC
Create an offramp wallet for a customer's bank account.
Args:
customer_id (string): the customer id
bank_account_id (string): the bank account id
network (string): the settlement network
external_id (string, optional): your external reference
Returns the created offramp wallet.
Inputs: network (required), customer_id (required), bank_account_id (required), external_id.
ashar_create_customer_virtual_accountCreate Customer Virtual AccountC
Create a virtual account for a customer.
Args:
customer_id (string): the customer id
body (object): the virtual account payload
Returns the created virtual account.
Inputs: body (required), customer_id (required).
ashar_create_customer_walletCreate Customer Blockchain WalletC
Add a blockchain wallet to a customer.
Args:
customer_id (string): the customer id
body (object): the blockchain wallet payload
Returns the created wallet.
Inputs: body (required), customer_id (required).
ashar_create_partner_feeCreate Partner FeeB
Create a partner fee schedule for the tenant.
Args:
name (string): fee schedule name
payout_percentage_fee (number, optional): percentage fee on payouts (e.g. 0.5 for 0.5%)
payout_flat_fee (number, optional): fixed fee on payouts
payin_percentage_fee (number, optional): percentage fee on payins
payin_flat_fee (number, optional): fixed fee on payins
virtual_account_set (string, optional): virtual account set this fee applies to
Returns the created partner fee.
Inputs: name (required), payin_flat_fee, payout_flat_fee, virtual_account_set, +2 more.
ashar_create_payin_quoteCreate Payin QuoteARead-only
Create a deposit (PIX -> USDC/USDT) quote for the tenant, including the Ashar platform fee markup.
Args:
payment_method (string): 'pix' or 'ted'
token (string): 'USDC' or 'USDT' (what the client receives)
request_amount (number, cents, >= 500 i.e. R$ 5.00): amount in BRL cents
wallet_id (string, optional): destination BlindPay wallet id
blockchain_wallet_id (string, optional): destination blockchain wallet id
idempotency_key (string, optional): to safely retry
Returns: The marked-up quote: quote_id, request_amount, estimated_receive, fx_rate, expires_at, and the platform_fee breakdown.
Use before ashar_execute_payin.
Inputs: token (required), payment_method (required), request_amount (required), wallet_id, +2 more.
ashar_create_payout_quoteCreate Payout QuoteARead-only
Create a withdrawal (USDC/USDT -> PIX) quote for the tenant, including the Ashar platform fee markup.
Args:
request_amount (number, cents, >= 500): amount in stablecoin cents
bank_account_id (string): destination PIX bank account id
token (string): stablecoin being sent ('USDC' or 'USDT')
network (string, optional, default 'polygon'): sending network
idempotency_key (string, optional)
Returns the marked-up quote: quote_id, request_amount, estimated_receive_brl, fx_rate, expires_at, and platform_fee.
Use before ashar_execute_payout.
Inputs: token (required), request_amount (required), bank_account_id (required), network, +1 more.
ashar_create_transfer_quoteCreate Transfer QuoteBRead-only
Create a crypto -> crypto (cross-chain) transfer quote for the tenant.
Args:
wallet_id (string): source BlindPay wallet
request_amount (number): amount in cents
sender_token (string): 'USDC' or 'USDT'
customer_wallet_address (string): destination address
customer_token (string): 'USDC' or 'USDT'
customer_network (string): destination network
amount_reference (string, optional): 'sender' or 'receiver'
cover_fees (boolean, optional, default false)
Returns quote_id, estimated_receive, fx_rate, expires_at, and platform_fee.
Inputs: wallet_id (required), sender_token (required), customer_token (required), request_amount (required), +4 more.
ashar_create_walletCreate WalletB
Create a new custodial wallet for the tenant.
Args:
network (string): blockchain network for the wallet
name (string): wallet label
external_id (string, optional): external reference
Returns the created wallet.
Inputs: name (required), network (required), external_id.
ashar_delete_bank_accountDelete Bank AccountBDestructiveIdempotent
Remove a PIX/TED bank account.
Args:
bank_account_id (string): the account id
Returns { deleted: true }.
Inputs: bank_account_id (required).
ashar_delete_customerDelete CustomerBDestructiveIdempotent
Delete a customer by id.
Args:
customer_id (string): the customer id
Returns 204 No Content on success.
Inputs: customer_id (required).
ashar_delete_customer_bank_accountDelete Customer Bank AccountBDestructiveIdempotent
Remove a customer's bank account.
Args:
customer_id (string): the customer id
bank_account_id (string): the bank account id
Returns 204 No Content on success.
Inputs: customer_id (required), bank_account_id (required).
ashar_delete_customer_custodial_walletDelete Customer Custodial WalletBDestructiveIdempotent
Remove a customer's custodial wallet.
Args:
customer_id (string): the customer id
wallet_id (string): the custodial wallet id
Returns 204 No Content on success.
Inputs: wallet_id (required), customer_id (required).
ashar_delete_customer_walletDelete Customer Blockchain WalletBDestructiveIdempotent
Remove a customer's blockchain wallet.
Args:
customer_id (string): the customer id
wallet_id (string): the blockchain wallet id
Returns 204 No Content on success.
Inputs: wallet_id (required), customer_id (required).
ashar_delete_partner_feeDelete Partner FeeADestructiveIdempotent
Remove a partner fee schedule by id.
Args:
fee_id (string): the partner fee id
Returns 204 No Content on success.
Inputs: fee_id (required).
ashar_delete_tenant_credentialsDelete Tenant CredentialsADestructiveIdempotent
Remove the upstream credentials of a tenant (falls back to the global credential). ADMIN operation.
Args:
tenant_id (string): the tenant id
Returns { status: 'deleted', count }.
Inputs: tenant_id (required).
ashar_execute_payinExecute Payin (Deposit)AIdempotent
Execute a PIX deposit using a previously created payin quote.
Args:
payin_quote_id (string): id from ashar_create_payin_quote
idempotency_key (string, optional): safely retry without double-charging
Returns the payin_id, status, and the PIX payload (pix_copiacola, pix_qrcode_base64, expires_at).
The client pays the generated PIX to complete the deposit.
Inputs: payin_quote_id (required), idempotency_key.
ashar_execute_payoutExecute Payout (Withdrawal)AIdempotent
Execute a USDC/USDT -> PIX withdrawal using a previously created payout quote.
Args:
quote_id (string): id from ashar_create_payout_quote
sender_wallet_id (string): the sender wallet address from which crypto is debited
network (string, optional): settlement network — 'evm' (default), 'solana', or 'stellar'
signed_transaction (string, optional): pre-signed transaction, required for 'solana' and 'stellar'
idempotency_key (string, optional): safely retry without double-spending
Returns the payout_id and status.
Inputs: quote_id (required), sender_wallet_id (required), network, idempotency_key, +1 more.
ashar_execute_transferExecute Transfer (Crypto -> Crypto)AIdempotent
Transfer stablecoins from a BlindPay wallet to an external address (creates a quote and executes in one call).
Args:
wallet_id (string): source BlindPay wallet
request_amount (number, cents): amount
sender_token (string): 'USDC' or 'USDT'
destination_address (string): external destination address
destination_token (string): 'USDC' or 'USDT'
destination_network (string): one of polygon, ethereum, base, arbitrum, solana, stellar, tron
idempotency_key (string, optional)
Returns the transfer_id, status, tx_hash, and amounts.
Inputs: wallet_id (required), sender_token (required), request_amount (required), destination_token (required), +3 more.
ashar_get_customerGet CustomerBRead-onlyIdempotent
Get a customer by id.
Args:
customer_id (string): the customer id
Returns the customer details.
Inputs: customer_id (required).
ashar_get_customer_custodial_walletGet Customer Custodial WalletBRead-onlyIdempotent
Get a single custodial wallet by customer id and wallet id.
Args:
customer_id (string): the customer id
wallet_id (string): the custodial wallet id
Returns the curated wallet.
Inputs: wallet_id (required), customer_id (required).
ashar_get_customer_custodial_wallet_balanceGet Customer Custodial Wallet BalanceBRead-onlyIdempotent
Get the balance of a customer's custodial wallet.
Args:
customer_id (string): the customer id
wallet_id (string): the custodial wallet id
Returns the sanitized balance (available/total/pending/token).
Inputs: wallet_id (required), customer_id (required).
ashar_get_customer_offramp_walletGet Customer Offramp WalletBRead-onlyIdempotent
Get a single offramp wallet by id.
Args:
customer_id (string): the customer id
bank_account_id (string): the bank account id
offramp_wallet_id (string): the offramp wallet id
Returns the curated offramp wallet.
Inputs: customer_id (required), bank_account_id (required), offramp_wallet_id (required).
ashar_get_daily_statsGet Daily StatsARead-onlyIdempotent
Get today's volume and platform fees for the tenant across payins and payouts.
No arguments. Returns count, volume_brl, and platform_fee_brl broken down by payin/payout plus the day total.
Inputs: no named parameters.
ashar_get_fee_ratesGet Fee RatesARead-onlyIdempotent
Get the current platform fee rates and limits applied to the tenant.
No arguments. Returns the tenant fees (payin/payout/transfer spreads and fixed fees), the end-user markup (user_markup), and daily/monthly volume limits in BRL.
Inputs: no named parameters.
ashar_get_fx_rateGet FX RateARead-onlyIdempotent
Consult a quick FX rate (with platform markup) without creating a quote.
Args:
from (string): source currency ('BRL', 'USDC', or 'USDT')
to (string): target currency ('BRL', 'USDC', or 'USDT')
request_amount (number): amount in minor units
direction (string, optional): 'payin' (BRL -> crypto) or 'payout' (crypto -> BRL)
currency_type (string, optional): 'sender' or 'receiver'
Returns base_rate (BlindPay) and client_rate (after markup) plus platform_fee.
Inputs: to (required), from (required), request_amount (required), direction, +1 more.
ashar_get_monthly_statsGet Monthly StatsARead-onlyIdempotent
Get the current month's volume and platform fees for the tenant across payins and payouts.
No arguments. Returns count, volume_brl, and platform_fee_brl broken down by payin/payout plus the month total.
Inputs: no named parameters.
ashar_get_partner_feeGet Partner FeeBRead-onlyIdempotent
Get a single partner fee schedule by id.
Args:
fee_id (string): the partner fee id
Returns the sanitized fee schedule.
Inputs: fee_id (required).
ashar_get_payinGet PayinARead-onlyIdempotent
Get details of a single deposit by its payin_id.
Args:
payin_id (string): the deposit id
Returns live status (queries BlindPay when possible) plus the fee record.
Inputs: payin_id (required).
ashar_get_payoutGet PayoutARead-onlyIdempotent
Get details of a single withdrawal by its payout_id.
Args:
payout_id (string): the withdrawal id
Returns live status (queries BlindPay when possible) plus the fee record.
Inputs: payout_id (required).
ashar_get_tenant_credentialsList Tenant CredentialsARead-onlyIdempotent
List the (masked) upstream credentials metadata of a tenant. ADMIN operation. The upstream API key is never exposed.
Args:
tenant_id (string): the tenant id
Returns credential metadata (instance_id, api_key_prefix, receiver_id, is_active).
Inputs: tenant_id (required).
ashar_get_transferGet TransferARead-onlyIdempotent
Get details of a single crypto transfer by its transfer_id.
Args:
transfer_id (string): the transfer id
Returns live status plus on-chain tx_hash when available.
Inputs: transfer_id (required).
ashar_get_user_markupGet User Markup ConfigARead-onlyIdempotent
Get the end-user markup (2nd spread layer on top of the Ashar margin) for a tenant. ADMIN operation.
This markup is Ashar-specific — the upstream only sees the Ashar partner, so the end-user spread is configured locally.
Args:
tenant_id (string): the tenant id
Returns user_markup with payin_spread_percent and payout_spread_percent.
Inputs: tenant_id (required).
ashar_get_wallet_balanceGet Wallet BalanceARead-onlyIdempotent
Get the balance of a single custodial wallet.
Args:
wallet_id (string): the wallet id
Returns available, total, pending, and token.
Inputs: wallet_id (required).
ashar_list_bank_accountsList Bank AccountsARead-onlyIdempotent
List the tenant's PIX/TED bank accounts.
No arguments. Returns an array of bank_accounts (id, bank_name, pix_key, status).
Inputs: no named parameters.
ashar_list_customer_bank_accountsList Customer Bank AccountsBRead-onlyIdempotent
List a customer's bank accounts.
Args:
customer_id (string): the customer id
Returns an array of bank_accounts.
Inputs: customer_id (required).
ashar_list_customer_custodial_walletsList Customer Custodial WalletsBRead-onlyIdempotent
List a customer's custodial (wallet) wallets.
Args:
customer_id (string): the customer id
Returns an array of curated wallets.
Inputs: customer_id (required).
ashar_list_customer_offramp_walletsList Customer Offramp WalletsARead-onlyIdempotent
List a customer's offramp wallets (crypto settlement wallets for a bank account).
Args:
customer_id (string): the customer id
bank_account_id (string): the bank account id
Returns an array of offramp_wallets.
Inputs: customer_id (required), bank_account_id (required).
ashar_list_customersList CustomersARead-onlyIdempotent
List customers (KYC/KYB) on the tenant's instance.
Args (all optional): limit, offset, starting_after, ending_before, full_name, customer_name, status, customer_id, country.
Returns an array of customers.
Inputs: limit, offset, status, country, +5 more.
ashar_list_customer_virtual_accountsList Customer Virtual AccountsBRead-onlyIdempotent
List a customer's virtual accounts.
Args:
customer_id (string): the customer id
Returns an array of virtual_accounts.
Inputs: customer_id (required).
ashar_list_customer_walletsList Customer Blockchain WalletsBRead-onlyIdempotent
List a customer's blockchain wallets.
Args:
customer_id (string): the customer id
Returns an array of blockchain_wallets.
Inputs: customer_id (required).
ashar_list_partner_feesList Partner FeesARead-onlyIdempotent
List the tenant's partner fee schedules (spread/fixed fees applied on payins and payouts).
No arguments. Returns a sanitized list of partner_fees.
Inputs: no named parameters.
ashar_list_payinsList PayinsARead-onlyIdempotent
List deposit transactions for the tenant, newest first.
Args:
status (string, optional): filter by status (e.g. 'processing', 'completed', 'pending', 'failed')
limit (number, optional, default 50, max 1000)
offset (number, optional, default 0)
Returns a paginated list with total count.
Inputs: limit, offset, status.
ashar_list_payoutsList PayoutsBRead-onlyIdempotent
List withdrawal transactions for the tenant, newest first.
Args:
status (string, optional): filter by status
limit (number, optional, default 50, max 1000)
offset (number, optional, default 0)
Returns a paginated list with total count.
Inputs: limit, offset, status.
ashar_list_test_tenantsList Test TenantsARead-onlyIdempotent
List all provisioned sandbox tenants. ADMIN operation.
No arguments. Returns the list of sandbox_tenants with their API key prefixes.
Inputs: no named parameters.
ashar_list_transfersList TransfersBRead-onlyIdempotent
List crypto transfers for the tenant, newest first.
Args:
status (string, optional): filter by status
limit (number, optional, default 50, max 1000)
offset (number, optional, default 0)
Returns a paginated list with total count.
Inputs: limit, offset, status.
ashar_list_walletsList WalletsARead-onlyIdempotent
List the tenant's custodial wallets with their balances.
No arguments. Returns an array of wallets (id, name, network, address, token, balance).
Inputs: no named parameters.
ashar_provision_test_tenantProvision Test TenantA
Create a sandbox tenant with a fresh X-Ashar-Tenant-Key. This is an ADMIN operation (public endpoint on the API).
Args:
display_name (string): company or tester name
email (string): primary contact email
cc_email (string, optional): CC email
kyc_type (string, optional, default 'light')
country (string, optional, default 'BR')
customer_type (string, optional, default 'individual')
limit_daily_brl (number, optional): daily BRL volume limit in cents (default 1000000)
limit_monthly_brl (number, optional): monthly BRL volume limit in cents (default 30000000)
blindpay_instance_id / blindpay_api_key / blindpay_receiver_id / blindpay_base_url (optional): an isolated upstream credential for the tenant (the API key is encrypted at rest)
Returns the provisioned tenant, its minted api_key, and base_url.
Inputs: email (required), display_name (required), country, cc_email, +8 more.
ashar_rotate_tenant_credentialsCreate/Rotate Tenant CredentialsA
Create or rotate the upstream credential of a tenant. ADMIN operation.
Args:
tenant_id (string): the tenant id
blindpay_api_key (string, optional): new upstream API key (encrypted at rest). If omitted, only metadata is updated where possible.
blindpay_instance_id, blindpay_receiver_id, blindpay_base_url (string, optional): upstream metadata
label (string, optional, default 'production')
Returns the rotated credential metadata.
Inputs: tenant_id (required), label, blindpay_api_key, blindpay_base_url, +2 more.
ashar_set_user_markupSet User Markup ConfigA
Set the end-user markup (2nd spread layer on top of the Ashar margin) for a tenant. ADMIN operation.
This markup is Ashar-specific — the upstream only sees the Ashar partner, so the end-user spread is configured locally. Both rates apply multiplicatively on top of the Ashar spread when quoting.
Args:
tenant_id (string): the tenant id
payin_spread_percent (number, optional): end-user spread on payins (percent)
payout_spread_percent (number, optional): end-user spread on payouts (percent)
Returns the updated user_markup.
Inputs: tenant_id (required), payin_spread_percent, payout_spread_percent.
ashar_update_customerUpdate CustomerB
Update a customer by id.
Args:
customer_id (string): the customer id
body (object): the fields to update
Returns the updated customer.
Inputs: body (required), customer_id (required).
ashar_upload_payoutUpload Payout FileB
Upload a file (e.g. payout supporting document) to the tenant's instance.
Args:
filename (string): the file name (e.g. "doc.pdf")
mime (string, optional): the MIME type (e.g. "application/pdf")
file_base64 (string): the file content Base64-encoded
The server stores the binary and returns the sanitized upload id/details.
Inputs: filename (required), file_base64 (required), mime.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 55 tools
Most tools are distinguishable by resource and action, but the wallet surface is crowded with overlapping concepts such as custodial wallets, blockchain wallets, and offramp wallets at both tenant and customer levels. An agent can confuse list_wallets, list_customer_wallets, list_customer_custodial_wallets, and list_customer_offramp_wallets without careful reading. Quote vs execute vs FX-rate tools are better separated.
All tools use the same ashar_ prefix and a consistent snake_case verb_noun pattern (list_, get_, create_, update_, delete_, execute_, etc.). Minor semantic quirks like upload_payout do not break the naming convention.
With 55 tools, the surface is far beyond a well-scoped MCP tool set and exceeds the 50-tool threshold for extreme mismatch. While the API domain is broad, many operations could be consolidated or scoped into narrower servers.
The server covers core exchange workflows well: customer CRUD, bank accounts, wallets, payins and payouts with quote/execute lifecycles, transfers, fees, stats, FX, and admin credential management. Some lifecycle gaps remain, such as missing delete/get operations for virtual accounts and offramp wallet deletion, but core operations are largely covered.
Maintenance
Related MCP Connectors
Live & historical FX rates and currency conversion for AI agents. No API keys.
Live & historical FX rates and currency conversion for AI agents. No API keys.
Give your AI agent a wallet: live FX rates, swaps and payments in 140+ local currencies.
17 pay-per-call web, finance, legal and onchain tools for AI agents. USDC on Base via x402/MPP.
Related MCP Servers
AlicenseAqualityDmaintenanceEnables AI agents to create cryptocurrency payments, check payment status, generate QR codes, and manage transactions through Bitnovo Pay API integration with automatic webhook support.532 npm4MIT
Stables MCP Serverofficial
AlicenseBqualityBmaintenanceEnables AI agents to manage stablecoin payments including customer management, quotes, transfers, virtual accounts, and webhooks via the Stables API.61225 npmMIT- AlicenseBqualityCmaintenanceEnables AI assistants to interact with the Asaas v3 payments API for managing Pix, boleto, credit card, subscriptions, customers, subaccounts, webhooks, refunds, and payment splits. It supports production and sandbox environments with tools for creating, listing, querying, canceling, and simulating financial operations.1686 npm2MIT

Flashift MCP Serverofficial
AlicenseNot gradedqualityCmaintenanceEnables AI agents to compare rates across 100+ blockchains and 15+ liquidity providers, create non-custodial cross-chain swaps, and track transaction status without any API key. It exposes tools for listing currencies, quoting swaps with AI-ranked routing tags, generating deposit addresses, and monitoring exchanges to completion.MIT