Ashar Exchange MCP Server

English | Português | 中文

Model Context Protocol (MCP) 服务器，用于 Ashar Exchange API —— PIX ↔ USDC/USDT 兑换，并收取平台费用（payins、payouts、transfers、wallets、customers 和 stats）。

受 BlindPay MCP 启发：它是一个独立的 HTTP 包装器，通过 X-Ashar-Tenant-Key 请求头完成身份验证，调用位于 https://api.ashar.finance/v2 的公共 API。

功能

• 40 个工具，均带 ashar_ 前缀，覆盖每个 API 分组：

  • Quotes —— payin、payout 和 transfer 报价（含费用加价）

  • PayIns —— PIX 入金 → 稳定币，支持列表和查询

  • Payouts —— 稳定币出金 → PIX

  • Transfers —— 钱包 → 区块链转账

  • Wallets —— 钱包和余额

  • Bank Accounts —— PIX 银行账户

  • Stats —— 每日/每月指标和费率

  • Customers —— 客户入 + 子资源（银行账户、钱包、虚拟账户）

  • Admin/Provisioning —— 预置测试租户、列出租户并管理凭据

• 可选传输方式 —— stdio（默认）或 Streamable HTTP，通过环境变量切换

• 可操作错误 —— HTTP 状态码映射（400/401/403/404/409/429/503）并附带处理提示

Related MCP server: Proxell MCP Server

环境要求

• Node..js >= 18

安装

cd mcp
npm install
npm run build

开发时使用热重载：

npm run dev

配置

使用

stdio（默认）

{
  "mcpServers": {
    "ashar-exchange": {
      "command": "node",
      "args": ["/path/to/AsharExchangeMCP/dist/index.js"],
      "env": {
        "ASHAR_EXCHANGE_TENANT_KEY": "ash_proxy_..."
      }
    }
  }
}

Streamable HTTPY

ASHAR_EXCHANGE_TRANSPORT=http PORT=3001 node dist/index.js

• MCP 端点：http://localhost:3001/mcp

• 健康检查：http://localhost:3001/health

消费模式

客户端可通过两种方式使用 Ashar Exchange MCP：

选项 1 —— 托管服务（Streamable HTTP）。

Ashar 在 m.ashar.finance 子提供上以公共面向服务的 MCP 服务器运行。客户端无需安装任何组件 —— 只需将 MCP 客户端指向 https://mcp.ashar.finance/mcp 并发送租户 Key 即可。

{
  "mcpServers": {
    "ashar-exchange": {
      "url": "https://mcp.ashar.finance/mcp",
      "headers": {
        "X-Ashar-Tenant-Key": "ash_proxy_..."
      }
    }
  }
}

• 公共健康检查：https://mcp.ashar.finance/health

• 非常适合无需自行运行基础设施、直接使用 MCP 的代理/LLM。

• 所有请求都经过 Ashar 服务器，由服务器应用租户 spread/fee（费用加价），并且可以监控每笔操作。

• 预置端点（服务（（ashar_provision_test_tenant）无需 Key 即可工作。

选项 2 —— 自托管（stdio）

• 客户端在本地（或自己的容器中）运行服务器，并指向 Ashar 的公共 API。

{
  "mcpServers": {
    "ashar-exchange": {
      "command": "node",
      "args": ["/path/to/AsharExchangeMCP/dist/index.js"],
      "env": {
        "ASHAR_EXCHANGE_TENANT_KEY": "ash_proxy_..."
      }
    }
  }
}

• 非常适合 CLI / 编辑器 / IDEs，以及希望自行管理进程的客户端。

• 仍会经过公共 API（https://api.ashar.finance/v2），spread/fee 和监控均在服务端完成。

两种模式，都不能替代 REST API（/）。传统客户端（app/site/backend）应通过 REST 直接集成；MCP 是向 AI 代理提供服务的渠道。

部署（托管服务）

mcp.ashar.finance 子域指向 Railway 上运行于端口 3001 的 AsharExchangeMCP 服务。构建通过 Dockerfile 进行，配置在 railway.json 中。

cd mcp
railway login
railway up        # uses the Dockerfile; runs on :3001 with ASHAR_EXCHANGE_TRANSPORT=http

公共路由（网关层）：

• mcp.ashar.finance/mcp → 服务 mcp.ashar.finance/mcp 服务 :3001/mcp 服务 :3001/mcp（不去除路径）

• mcp.ashar.finance/health → 服务 :3001/health

**建议在服务上配置的环境变量：

##典型流程

1. （ashar_provision_test_tenant）—— 可选，用于创建带新 Key 的测试租用

2. ashar_create_payin_quote → ashar_execute_payin（入金）

3. ashar_create_payout_quote → ashar_execute_payout（出金）

4. ashar_get_daily_stats / ashar_get_montly_stats / ashar_get_fee_rates（监控与费用）

脚本

许可证

待确定。请联系 Ashar Finance。

Model Context Protocol (MCP) 服务器，用于 Ashar Exchange API —— PIX ↔ USDC / USDT 兑换，并带有平台费用（fee、开销、转账、钱包、客户和统计数据）。

受 BlindPay MCP 启发：它是一个独立的 HTTP 包装器，使用 X-Ashar-Tenant-Key 请求头调用公共 API https://api.ashar.finance/v2。

功能

• 40 个工具（带 ashar_ 前缀），覆盖所有 API 分组：

  • Quotes —— payin、payout 和 transfer 报价（含加价）

  • PayIns —— PIX 入金 → 稳定币，支持列表和查询

  • Payouts —— 稳定币出金 → PIX

  • Transfers —— 钱包 → 区块链转账

  • Wallets —— 钱包和余额

  • Bank Accounts —— PIX 银行账户

  • Stats —— 日/月统计指标和费率

  • Customers —— 客户 joined + 子资源（银行账户、钱包、虚拟账户子）

  • Admin/Provisioning —— 预置测试租户、列表租户、管理凭据

• 可选传输 —— stdio（默认）或 Streamable HTTP，通过环境变量设置

• 可操作错误 —— HTTP 状态码映射（400/401/403/404/409/429/503）并带提示

环境要求

• Node.js >= 18

安装

cd mcp
npm install
npm run build

开发时使用热重载：

npm run dev

配置

使用

stdio（默认）

{
  "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

• MCP 端点：http://localhost:3001/mcp

• 健康检查：http://localhost:3001/health

消费模式

客户可以通过两种方式使用 Ashar Exchange MCP：

选项 1 —— 托管服务（Streamable HTTP）⭐

Ashar在 mcp.ashar.finance 子域上作为公共 MCP 服务运行。客户无需安装 —— 只需要客户端 https://mcp.ashar.finance/mcp 并发送租户 Key。

{
  "mcpServers": {
    "ashar-exchange": {
      "url": "https://mcp.ashar.finance/mcp",
      "headers": {
        "X-Ashar-Tenant-Key": "ash_proxy_..."
      }
    }
  }
}

• 公共健康检查：https://mcp.ashar.inance/health

• 非常适合 代理/LLM，无需运行基础设施即可直接使用 MCP。

• 通过 Ashar 服务器处理所有请求，由服务器应用租户 spread/ 费率（点差/费用），并可监控 每笔操作。

• 预置端点（ashar_provision_test_tenant）无需 Key 即可工作。

选项 2 —— 自托管（stdio）

客户在本地（或自己的容器中）运行服务器，并指向 Ashar 的公共 API。

{
  "mcpServers": {
    "ashar-exchange": {
      "command": "node",
      "args": ["/caminho/para/AsharExchangeMCP/dist/index.js"],
      "env": {
        "ASHAR_EXCHANGE_TENANT_KEY": "ash_proxy_..."
      }
    }
  }
}

• 非常适合 CLI（/ 编辑器 / IDEs），以及更偏好自管理进程的客户。

• 仍通过公共 API（https://api.ashar.finance/v2）访问，spread/fee 和监控仍保留服务端。

上面两种方式 并不替代 REST API（/）。传统客户端（app/site/backend）通过 REST 直接集成；MCE 是 AI 代理的通道。

部署（托管服务）

mcp.ashar.finance 子域指向 Railway 上运行于端口 3001 的 AsharExchangeMCP 服务，构建采用 Dockerfile，配置见 railway.json。

cd mcp
railway login
railway up        # usa o Dockerfile; sobe em :3001 com ASHAR_EXCHANGE_TRANSPORT=http

路由（网关访问）：

• mcp.ashar.finance/mcp → 服务 :3001/mcp（不剥离路径）

• mcp.ashar.finance/health → 服务 :3001/health

服务上建议配置的环境变量：

典型流程

1. (ashar_provision_test_tenant) —— 可选，创建一个带新 Key 的测试租用

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（吸附）

脚本

许可证

待定。请联系 Ashar Finience。

针对 Ashar Exchange API 的 Model Context Protocol (MCP) 服务器 —— 用于 PIX ↔ SPLY 互换，并收取平台费用（payins、payouts、transfers、wallets、customers 和 stats）。

受 BlindPay MCP 启发：它是独立 HTTP 包装器，调用 https://api.ashar.finance/v2 的公共 API，通过 X-Ashar-Tenant-Key 头进行身份验证。

功能特性

• 40 个工具，均带 ashar_ 前缀，涵盖所有 API 分组：

  • Quotes — payin、payout 与 transfer 报价（含费用加成）

  • PayIns — PIX 充值 → 稳定币，列出与查询

  • Payouts — 稳定币提现 → PIX

  • Transfers — 钱包 → 区块链转账

  • Wallets — 钱包与余额

  • Bank Accounts — PIX 银行账户

  • Stats — 每日/月度指标与费率

  • Customers — 客户入驻 + 子资源（bank accounts、wallets、virtual accounts）

  • Admin/Provisioning — 创建测试租户、列出租户并管理凭据

• 可切换传输方式 — stdio（默认）或通过环境变量配置 Streamable HTTP

• 可操作的错误提示 — HTTP 状态码映射（400/401/403/404/409/429/503）并附带提示

环境要求

• Node.js >= 18

安装

cd mcp
npm install
npm run build

开发模式（热重载）：

npm run dev

配置

用法

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 并监控每笔操作。

• 无密钥即可使用 provisioning 端点（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

• mcp.ashar.finance/health → 服务 :3001/health

推荐的环境变量：

11.典型流程

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（跟踪与费用）

脚本

许可证

待定。请联系 Ashar Finance。