Skip to main content
Glama
Ashar Exchange MCP Server

Ashar Exchange MCP Server

Official
by AsharFinance

Ashar Exchange MCP Server

English | Português | 中文


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 build

For development with hot-reload:

npm run dev

Configuration

Variable

Description

Default

ASHAR_EXCHANGE_TENANT_KEY

Tenant API key (ash_proxy_...) used in the X-Ashar-Tenant-Key header. Required for protected endpoints; admin endpoints work without it.

—

ASHAR_EXCHANGE_BASE_URL

API base URL

https://api.ashar.finance/v2

ASHAR_EXCHANGE_TRANSPORT (or TRANSPORT)

stdio or http

stdio

PORT

HTTP server port (used with the http transport)

3001

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.js
  • MCP endpoint: http://localhost:3001/mcp

  • Health 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/health

  • Ideal 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=http

Public 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

ASHAR_EXCHANGE_TRANSPORT

http (default already in the Dockerfile)

PORT

3001 (default already in the Dockerfile)

ASHAR_EXCHANGE_BASE_URL

https://api.ashar.finance/v2

ASHAR_EXCHANGE_TENANT_KEY

optional — default key for protected calls

Typical flow

  1. (ashar_provision_test_tenant) — optional, to create a test tenant with a new key

  2. ashar_create_payin_quote → ashar_execute_payin (deposit)

  3. ashar_create_payout_quote → ashar_execute_payout (withdrawal)

  4. ashar_get_daily_stats / ashar_get_monthly_stats / ashar_get_fee_rates (tracking and fees)

Scripts

Script

Description

npm run build

Compiles TypeScript to dist/

npm run dev

Runs with hot-reload (tsx watch)

npm run start

Runs the build (node dist/index.js)

npm run typecheck

Type-checks without emitting (tsc --noEmit)

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 build

Para desenvolvimento com hot-reload:

npm run dev

Configuração

Variável

Descrição

Padrão

ASHAR_EXCHANGE_TENANT_KEY

Chave de API do tenant (ash_proxy_...) usada no header X-Ashar-Tenant-Key. Obrigatória para endpoints protegidos; admin endpoints funcionam sem ela.

—

ASHAR_EXCHANGE_BASE_URL

Base URL da API

https://api.ashar.finance/v2

ASHAR_EXCHANGE_TRANSPORT (ou TRANSPORT)

stdio ou http

stdio

PORT

Porta do servidor HTTP (usada com transporte http)

3001

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.js
  • Endpoint MCP: http://localhost:3001/mcp

  • Health 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/health

  • Ideal 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=http

Roteamento 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

ASHAR_EXCHANGE_TRANSPORT

http (default já no Dockerfile)

PORT

3001 (default já no Dockerfile)

ASHAR_EXCHANGE_BASE_URL

https://api.ashar.finance/v2

ASHAR_EXCHANGE_TENANT_KEY

opcional — chave default p/ chamadas protegidas

Fluxo típico

  1. (ashar_provision_test_tenant) — opcional, para criar um tenant de teste com uma chave nova

  2. ashar_create_payin_quote → ashar_execute_payin (depósito)

  3. ashar_create_payout_quote → ashar_execute_payout (saque)

  4. ashar_get_daily_stats / ashar_get_monthly_stats / ashar_get_fee_rates (acompanhamento e fees)

Scripts

Script

Descrição

npm run build

Compila TypeScript para dist/

npm run dev

Executa com hot-reload (tsx watch)

npm run start

Executa o build (node dist/index.js)

npm run typecheck

Verifica tipos sem emitir (tsc --noEmit)

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

配置

变量

说明

默认值

ASHAR_EXCHANGE_TENANT_KEY

租户 API 密钥(ash_proxy_...),用于 X-Ashar-Tenant-Key 请求头。受保护端点必需;管理端点无需。

—

ASHAR_EXCHANGE_BASE_URL

API 基础地址

https://api.ashar.finance/v2

ASHAR_EXCHANGE_TRANSPORT(或 TRANSPORT)

stdio 或 http

stdio

PORT

HTTP 服务器端口(配合 http 传输方式使用)

3001

使用方式

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.js
  • MCP 端点: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_EXCHANGE_TRANSPORT

http(Dockerfile 中已为默认值)

PORT

3001(Dockerfile 中已为默认值)

ASHAR_EXCHANGE_BASE_URL

https://api.ashar.finance/v2

ASHAR_EXCHANGE_TENANT_KEY

可选 —— 受保护调用的默认密钥

典型流程

  1. (ashar_provision_test_tenant)—— 可选,用于创建一个带新密钥的测试租户

  2. ashar_create_payin_quote → ashar_execute_payin(充值)

  3. ashar_create_payout_quote → ashar_execute_payout(提现)

  4. ashar_get_daily_stats / ashar_get_monthly_stats / ashar_get_fee_rates(跟踪与费用)

脚本

脚本

说明

npm run build

将 TypeScript 编译到 dist/

npm run dev

热重载运行(tsx watch)

npm run start

运行构建产物(node dist/index.js)

npm run typecheck

类型检查但不输出(tsc --noEmit)

许可协议

待定。请联系 Ashar Finance。

Available Tools

55 tools
ashar_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 QuoteA
Read-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 QuoteA
Read-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 QuoteB
Read-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 AccountB
DestructiveIdempotent

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 CustomerB
DestructiveIdempotent

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 AccountB
DestructiveIdempotent

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 WalletB
DestructiveIdempotent

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 WalletB
DestructiveIdempotent

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 FeeA
DestructiveIdempotent

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 CredentialsA
DestructiveIdempotent

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)A
Idempotent

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)A
Idempotent

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)A
Idempotent

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 CustomerB
Read-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 WalletB
Read-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 BalanceB
Read-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 WalletB
Read-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 StatsA
Read-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 RatesA
Read-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 RateA
Read-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 StatsA
Read-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 FeeB
Read-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 PayinA
Read-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 PayoutA
Read-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 CredentialsA
Read-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 TransferA
Read-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 ConfigA
Read-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 BalanceA
Read-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 AccountsA
Read-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 AccountsB
Read-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 WalletsB
Read-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 WalletsA
Read-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 CustomersA
Read-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 AccountsB
Read-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 WalletsB
Read-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 FeesA
Read-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 PayinsA
Read-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 PayoutsB
Read-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 TenantsA
Read-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 TransfersB
Read-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 WalletsA
Read-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

    B3.2/5.0

    Scored across 55 tools

    Disambiguation3/5

    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.

    Naming Consistency5/5

    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.

    Tool Count1/5

    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.

    Completeness4/5

    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

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables AI agents to create cryptocurrency payments, check payment status, generate QR codes, and manage transactions through Bitnovo Pay API integration with automatic webhook support.
      5
      32 npm
      4
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      Enables 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.
      16
      86 npm
      2
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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