Servidor MCP de Ashar Exchange

English | Português | 中文

Servidor Model Context Protocol (MCP) para la API de Ashar Exchange — intercambio PIX ↔ USDC/USDT con comisiones de plataforma (payins, payouts, transfers, wallets, customers y stats).

Inspirado en BlindPay MCP: es un wrapper HTTP independiente que llama a la API pública en https://api.ashar.finance/v2, autenticado mediante la cabecera X-Ashar-Tenant-Key.

Características

• 40 herramientas con el prefijo ashar_, que cubren todos los grupos de la API:

  • Quotes — cotización de payin, payout y transfer (con margen sobre comisiones)

  • PayIns — depósito PIX → stablecoin, listado y consulta

  • Payouts — retiro de stablecoin → PIX

  • Transfers — transferencia de wallet → blockchain

  • Wallets — carteras y saldos

  • Bank Accounts — cuentas bancarias PIX

  • Stats — métricas diarias/mensuales y tarifas

  • Customers — onboarding de clientes + subrecursos (bank accounts, wallets, virtual accounts)

  • Admin/Provisioning — aprovisionar tenant de prueba, listar tenants y gestionar credenciales

• Transporte seleccionable — stdio (por defecto) o HTTP mediante variable de entorno

• Errores accionables — mapeo de códigos HTTP (400/401/403/404/409/429/503) con pistas

Related MCP server: Proxell MCP Server

Requisitos

• Node.js >= 18

Instalación

cd mcp
npm install
npm run build

Para desarrollo con recarga en caliente:

npm run dev

Configuración

Uso

stdio (predeterminado)

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

HTTP mediante Streamable

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

• Endpoint MCP: http://localhost:3001/mcp

• Verificación de salud: http://localhost:3001/health

Modos de consumo

Hay dos formas de que un cliente consuma la MCP de Ashar Exchange:

Opción 1 — Servicio alojado (HTTP mediante Streamable) ⭐

Ashar ejecuta el servidor MCP como un servicio público en el subdominio mcp.ashar.finance. El cliente no instala nada: apunta su cliente MCP a https://mcp.ashar.finance/mcp y envía la clave del tenant.

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

• Verificación de salud pública: https://mcp.ashar.finance/health

• Ideal para agentes/LLM que usan MCP sin ejecutar infraestructura.

• Todas las solicitudes pasan por el servidor de Ashar, que aplica el spread/comisión del tenant y puede monitorear cada operación.

• Los endpoints de aprovisionamiento (ashar_provision_test_tenant) funcionan sin clave.

Opción 2 — Autohospedado (stdio)

El cliente ejecuta el servidor localmente (o en su propio contenedor) y lo apunta a la API pública de Ashar.

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

• Ideal para CLI / editores / IDE y para clientes que prefieren gestionar su propio proceso.

• Sigue pasando por la API pública (https://api.ashar.finance/v2), manteniendo el spread y el monitoreo en el servidor.

Ambos modos no reemplazan la API REST (/v2). Un cliente tradicional (app/sitio/backend) se integra directamente mediante REST; la MCP es el canal para los agentes de IA.

Despliegue (servicio alojado)

El subdominio mcp.ashar.finance apunta al servicio AsharExchangeMCP en Railway (puerto 3001). La compilación usa el Dockerfile y la config en railway.json.

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

Enrutamiento público (en la puerta de enlace):

• mcp.ashar.finance/mcp → servicio :3001/mcp (sin strip)

• mcp.ashar.finance/health → servicio :3001/health

Variables de entorno recomendadas en el servicio:

Flujo típico

1. (ashar_provision_test_tenant): opcional, para crear un tenant de prueba con una clave nueva

2. ashar_create_payin_quote → ashar_execute_payin (depósito)

3. ashar_create_payout_quote → ashar_execute_payout (retiro)

4. ashar_get_daily_stats / ashar_get_monthly_stats / ashar_get_fee_rates (seguimiento y comisiones)

Scripts

Licencia

Por definir. Contacta con Ashar Finance.

Servidor Model Context Protocol (MCP) para la API de Ashar Exchange — intercambio PIX ↔ USDC/USDT con comisiones de plataforma (payins, payouts, transfers, wallets, customers y stats).

Inspirado en BlindPay MCP: es un wrapper HTTP autónomo que llama a la API pública en https://api.ashar.finance/v2, autenticado mediante la cabecera X-Ashar-Tenant-Key.

Características

• 40 herramientas con prefijo ashar_, que cubren todos los grupos de la API:

  • Quotes — cotización de payin, payout y transfer (con margen de comisiones)

  • PayIns — depósito PIX → stablecoin, listado y consulta

  • Payouts — retiro de stablecoin → PIX

  • Transfers — transferencia de wallet → blockchain

  • Wallets — carteras y saldos

  • Bank Accounts — cuentas bancarias PIX

  • Stats — métricas diarias/mensuales y tarifas de comisión

  • Customers — onboarding de clientes + subrecursos (bank accounts, wallets, cuentas virtuales)

  • Admin/Provisioning — provisionar tenant de prueba, listar tenants y gestionar credenciales

• Transporte seleccionable — stdio (predeterminado) o HTTP mediante Streamable a través de variable de entorno

• Errores accionables — mapeo de códigos HTTP (400/401/403/404/409/429/503) con pistas

Requisitos

• Node.js >= 18

Instalación

cd mcp
npm install
npm run build

Para desarrollo con recarga en caliente:

npm run dev

Configuración

Uso

stdio (predeterminado)

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

HTTP mediante Streamable

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

• Endpoint MCP: http://localhost:3001/mcp

• Verificación de salud: http://localhost:3001/health

Modos de consumo

Hay dos formas de que un cliente consuma la MCP Ashar Exchange:

Opción 1 — Servicio alojado (HTTP mediante Streamable) ⭐

Ashar opera el servidor MCP como servicio público en el subdominio **c. El cliente no instala nada: apunta su cliente MCP a https://mcp.ashar.finance/mcp y envía la clave del tenant.

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

• Verificación de salud pública: https://mcp.ashar.finance/health

• Ideal para agentes/LLM que hablan MCP sin necesidad de ejecutar infraestructura.

• Todas las solicitudes pasan por el servidor Ashar, que aplica el margen/comisión del tenant y pueda monitorear cada operación.

• Endpoints de aprovisionamiento (ashar_provisioned_test_tenant) funcionan sin clave.

Opción 2 — Autohospedado (stdio)

El cliente ejecuta el servidor localmente (o History in its próprio ev container) y lo apunta a la API pública de 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 y para clientes que prefieren administrar su propio proceso.

• Continúa pasando por la API pública (https://api.ashar.finance/v2), manteniendo margen y monitoreo en el servidor.

Ambos modos no sustituyen la API REST (/v2). Un cliente tradicional (app/sitio/backend) se integra directamente mediante REST; MCP es el canal para los agentes de IA.

Despliegue (servicio alojado)

El subdominio mcp.ashar.finance apunta al servicio MCPAsharExchangeMCP en Railway (puerto 3001). El build se realiza mediante el Dockerfile y la configuración en railway.json.

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

Enrutamiento público (en la puerta de entrada):

• mcp.ashar.finance/mcp → servicio :3001/mcp (sin strips)

• mcp.ashar.finance/health → servicio :3001/health

Variables de entorno recomendadas en el servicio:

Flujo típico

1. (ashar_provision_test_tenant) — opcional, para crear un tenant de prueba con una clave nueva

2. ashar_create_payin_quote → ashar_execute_payin (depósito)

3. ashar_create_payout_quote → ashar_execute_payout (retiro)

4. ashar_get_daily_stats / ashar_get_monthly_stats / ashar_get_fee_rates (seguimiento y comisiones)

Scripts

Inspirado en BlindPay MCP: es un servidor HTTP independiente que envuelve la API pública de https://api.ashar.finance/v2, autenticándose mediante la cabecera X-Ashar-Tenant-Key.

Funcionalidades

• 40 herramientas, todas con el prefijo ashar_, que cubren todos los grupos de la API:

  • Quotes — cotizaciones de payin, payout y transferencias (con recargo de comisión incluido)

  • PayIns — recargas PIX → stablecoins: listado y consulta

  • Payouts — retiros de stablecoins → PIX

  • Transfers — transferencias de wallet a cadena de bloques

  • Wallets — wallets y saldos

  • Bank Accounts — cuentas bancarias PIX

  • Stats — métricas diarias/mensuales y tarifas

  • Customers — incorporación de clientes + subrecursos (bank accounts, wallets, virtual accounts)

  • Admin/Provisioning — crear tenants de prueba, listar tenants y gestionar credenciales

• Transporte configurable — stdio (predeterminado) o Streamable HTTP mediante variable de entorno

• Errores accionables — mapeo de códigos de estado HTTP (400/401/403/404/409/429/503) con sugerencias

Requisitos

• Node.js >= 18

Instalación

cd mcp
npm install
npm run build

Modo de desarrollo (recarga en caliente):

npm run dev

Configuración

Uso

stdio (predeterminado)

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

• Endpoint MCP: http://localhost:3001/mcp

• Health check: http://localhost:3001/health

Modos de consumo

Los clientes pueden consumir el Ashar Exchange MCP de dos maneras:

Opción 1 — Servicio alojado (Streamable HTTP) ⭐

Ashar ejecuta el servidor MCP de forma pública en el subdominio mcp.ashar.finance. El cliente no necesita instalar nada: solo debe apuntar su cliente MCP a https://mcp.ashar.finance/mcp y enviar su clave de 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

• Adecuado para agentes/LLM que no requieren infraestructura y usan MCP directamente.

• Todas las solicitudes pasan por los servidores de Ashar, que aplican el spread/comisión del tenant y pueden supervisar cada operación.

• El endpoint de aprovisionamiento (ashar_provision_test_tenant) se puede usar sin clave.

Opción 2 — Autoalojado (stdio)

El cliente ejecuta el servidor localmente (o en su propio contenedor) y lo apunta a la API pública de Ashar.

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

• Adecuado para CLI / editores / IDEs y para clientes que quieran gestionar el proceso por sí mismos.

• Sigue pasando por la API pública (https://api.ashar.finance/v2); el spread/comisión y la supervisión son gestionados en el lado del servidor.

Modelidades: ninguno de los dos modos sustituye la API REST (/v2). Los clientes tradicionales (app/web/backend) se integran directamente a través de REST; el MCP es el canal para los agentes de IA.

Despliegue (servicio alojado)

El subdominio mcp.ashar.finance apunta al servicio AsharExchangeMCP en Railway (puerto 3001). El build se basa en el Dockerfile y la configuración está en railway.json.

cd mcp
railway login
railway up        # 使用 Dockerfile；以 ASHAR_EXCHANGE_TRANSPORT=http 在 :3001 运行

Rutas públicas (capa de gateway):

• mcp.ashar.finance/mcp → servicio :3001/mcp (sin strip)

• mcp.ashar.finance/health → servicio :3001/health

Variables de entorno recomendadas en el servicio:

Flujo típico

1. (ashar_provision_test_tenant) — opcional, para crear un tenant de prueba con una clave nueva

2. ashar_create_payin_quote → ashar_execute_payin (recarga)

3. ashar_create_payout_quote → ashar_execute_payout (retiro)

4. ashar_get_daily_stats / ashar_get_monthly_stats / ashar_get_fee_rates (seguimiento y comisiones)

Scripts

Licencia

Pendiente. Póngase en contacto con Ashar Finance.