Ashar Exchange MCP Server

English | Português | 中文

Ashar Exchange API용 Model Context Protocol (MCP) 서버 — 플랫폼 수수료가 적용되는 PIX ↔ USDC/USDT 교환(payins, payouts, transfers, wallets, customers, stats).

BlindPay MCP에서 영감을 받았습니다. https://api.ashar.finance/v2의 공개 API를 호출하는 독립형 HTTP 래퍼이며, X-Ashar-Tenant-Key 헤더로 인증됩니다.

기능

• ashar_ 접두사를 가진 40개의 도구 — 모든 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 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 서버를 mcp.ashar.finance 하위 도메인에서 공개 서비스로 운영합니다. 클라이언트는 아무것도 설치할 필요 없이 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

• 인프라를 직접 운영하지 않고 MCP를 사용하는 에이전트/LLM에 적합합니다.

• 모든 요청은 Ashar 서버를 통해 전달되며, 서버는 테넌트 스프레드/수수료를 적용하고 모든 작업을 모니터링할 수 있습니다.

• 프로비저닝 엔드포인트(ashar_provision_test_tenant)는 키 없이도 동작합니다.

옵션 2 — 자체 호스팅(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)를 통해 동작하므로 스프레드와 모니터링을 서버 측에서 유지합니다.

두 방식 모두 REST API(/v2)를 대체하지 않습니다. 기존 클라이언트(앱/사이트/백엔드)는 일반적으로 REST로 직접 통합합니다. MCP는 AI 에이전트를 위한 채널입니다.

배포(호스팅 서비스)

mcp.ashar.finance 하위 도메인은 Railway의 AsharExchangeMCP 서비스(포트 3001)를 가리킵니다. 빌드는 Dockerfile과 railway.json의 구성을 사용합니다.

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

공용 라우팅(게이트웨이):

• mcp.ashar.finance/mcp → :3001/mcp 서비스(경로 제거 없음)

• mcp.ashar.finance/health → :3001/health 서비스

서비스에 권장되는 환경 변수:

일반적인 흐름

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에 문의하세요.

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

• 40 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 — integração de customers + sub-recursos (bank accounts, wallets, virtual accounts)

  • Admin/Provisioning — provisionar tenant de teste, listar tenants e gerenciar credenciais

• 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

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 administra o servidor MCP como serviço público no subdomínio mcp.ashar.finance. O cliente não instala nada — aponta seu client 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 usam MCP sem manter infraestrutura.

• Todas as requisições 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 em contêiner próprio) 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 CLIs / editores / IDEs e para clientes que preferem gerenciar o próprio processo.

• Continua passando pela API pública (https://api.ashar.finance/v2), mantendo spread e monitoramento server-side.

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 usa o 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:

Fluxo típico

1. (ashar_provision_test_tenant) — opcional, para criar um tenant de teste com 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

Licença

A definir. Contate o Ashar Finance.

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

BlindPay MCP에서 영감을 받았습니다. 이는 https://api.ashar.finance/v2의 공개 API를 호출하는 독립형 HTTP 래퍼이며, 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를 사용할 수 있습니다:

방식 1 — 호스팅 서비스(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

• 자체 인프라를 실행하지 않고 MCP를 직접 사용하는 서버/LLM에 적합합니다.

• 모든 요청은 Ashar 서버를 거치며, 서버가 테넌트의 스프레드/수수료(spread/fee) 를 적용하고 각 작업을 모니터링할 수 있습니다.

• 프로비저닝 엔드포인트(ashar_provision_test_tenant)는 키 없이 사용할 수 있습니다.

방식 2 — 자체 호스팅(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)를 대체하지 않습니다. 기존 클라이언트(앱/웹사이트/백엔드)는 REST로 직접 통합하며, MCP는 AI 에이전트를 위한 채널입니다.

배포(호스팅 서비스)

mcp.ashar.finance 하위 도메인은 Railway의 연산품MCP 서비스(포트 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

서비스에 권장되는 환경 변수:

일반적인 흐름

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에 문의하세요.