Ashar Exchange MCP Server

Englisch | Portugiesisch | Chinesisch

Ein Model Context Protocol (MCP)-Server für die Ashar Exchange API — PIX ↔ USDC/USDT-Exchange mit Plattformgebühren (Payins, Payouts, Transfers, Wallets, Customers und Stats).

Inspiriert vom BlindPay MCP: Es handelt sich um einen eigenständigen HTTP-Wrapper, der die öffentliche API unter https://api.ashar.finance/v2 aufruft und über den X-Ashar-Tenant-Key-Header authentifiziert wird.

Funktionen

• 40 Tools mit dem Präfix ashar_, die alle API-Gruppen abdecken:

  • Quotes — Payin-, Payout- und Transfer-Quotes (mit Gebührenaufschlag)

  • PayIns — PIX-Einzahlung → Stablecoin, Auflistung und Abfrage

  • Payouts — Stablecoin-Auszahlung → PIX

  • Transfers — Transfer von Wallet → Blockchain

  • Wallets — Wallets und Salden

  • Bank Accounts — PIX-Bankkonten

  • Stats — Tägliche/Monatliche Kennzahlen und Gebührensätze

  • Customers — Kunden-Onboarding + Unterressourcen (Bankkonten, Wallets, virtuelle Konten)

  • Admin/Provisioning — Test-Tenant bereitstellen, Tenants auflisten und Anmeldeinformationen verwalten

• Wählbarer Transport — stdio (Standard) oder Streamable HTTP über eine Umgebungsvariable

• Aktionsfähige Fehler — HTTP-Code-Zuordnung (400/401/403/404/409/429/503) mit Hinweisen

Related MCP server: Proxell MCP Server

Anforderungen

• Node.js >= 18

Installation

cd mcp
npm install
npm run build

Bei der Entwicklung mit Hot-Reload:

npm run dev

Konfiguration

Verwendung

stdio (Standard)

{
  "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-Endpunkt: http://localhost:3001/mcp

• Health-Check: http://localhost:3001/health

Nutzungsarten

Es gibt zwei Möglichkeiten, wie ein Client den Ashar Exchange MCP nutzen kann:

Option 1 — Gehosteter Dienst (Streamable HTTP) ⭐

Ashar betreibt den MCP-Server als öffentlichen Dienst auf der Subdomäne mcp.ashar.finance. Der Client installiert nichts — er zeigt seinen MCP-Client einfach auf https://mcp.ashar.finance/mcp und sendet den Tenant-Key.

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

• Öffentlicher Health-Check: https://mcp.ashar.finance/health

• Ideal für Agenten/LLMs, die MCP sprechen, ohne Infrastruktur betreiben zu müssen.

• Alle Anfragen laufen über den Ashar-Server, der den Tenant-Spread/Gebühr anwendet und jede Operation überwachen kann.

• Provisionierungs-Endpunkte (ashar_provision_test_tenant) funktionieren ohne Schlüssel.

Option 2 — Selbsthosting (stdio)

Der Client führt den Server lokal (oder im eigenen Container) aus und zeigt ihn auf die öffentliche API von Ashar.

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

• Ideal für CLIs / Editoren / IDEs und für Kunden, die ihren eigenen Prozess bevorzugen.

• Der Datenverkehr läuft weiterhin über die öffentliche API (https://api.ashar.finance/v2), sodass Spread und Monitoring serverseitig bleiben.

Beide Modi ersetzen die REST-API nicht (/v2). Ein traditioneller Client (App/Site/Backend) integriert sich direkt über REST; der MCP ist der Kanal für KI-Agenten.

Bereitstellung (gehosteter Dienst)

Die Subdomäne mcp.ashar.finance zeigt auf den Dienst AsharExchangeMCP auf Railway (Port 3001). Der Build verwendet das Dockerfile und die Konfiguration in railway.json.

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

Öffentliches Routing (am Gateway):

• mcp.ashar.finance/mcp → Dienst :3001/mcp (ohne Strip)

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

Empfohlene Umgebungsvariablen für den Dienst:

Typischer Ablauf

1. (ashar_provision_test_tenant) — optional, um einen Test-Tenant mit neuem Schlüssel zu erstellen

2. ashar_create_payin_quote → ashar_execute_payin (Einzahlung)

3. ashar_create_payout_quote → ashar_execute_payout (Auszahlung)

4. ashar_get_daily_stats / ashar_get_monthly_stats / ashar_get_fee_rates (Tracking und Gebühren)

Skripte

Lizenz

Noch zu definieren. Kontaktieren Sie Ashar Exchange.

Model Context Protocol (MCP)-Server für Ashar Exchange API — PIX ↔ USDC/USDT-Exchange mit Plattformgebühren (Payins, Payouts, Transfers, Wallets, Customers und Stats).

Inspiriert vom BlindPay MCP: Es ist ein eigenständiger HTTP-Wrapper, der die öffentliche API unter https://api.ashar.finance/v2 aufruft, authentifiziert über den X-Ashar-Tenant-Key-Header.

Funktionen

• 40 Tools mit dem Präfix ashar_, die alle API-Gruppen abdecken:

  • Quotes — Payin-, Payout- und Transfer-Quotes (mit Gebührenaufschlag)

  • PayIns — PIX-Einzahlung → Stablecoin, Auflistung und Abfrage

  • Payouts — Stablecoin-Auszahlung → PIX

  • Transfers — Transfer von Wallet → Blockchain

  • Wallets — Wallets und Salden

  • Bank Accounts — PIX-Bankkonten

  • Stats — tägliche/monatliche Kennzahlen und Gebührensätze

  • Customers — Kunden-Onboarding + Unterressourcen (Bankkonten, Wallets, virtuelle Konten)

  • Admin/Provisioning — Bereitstellung SP** — Provisionieren von Testlagen, Auflistung von Lagen, Verwaltung von Zugangsdaten

• Wählbarer Transport — stdio (Standard) oder Streamable HTTP per Umgebungsvariable

• Aktionsfähige Fehler — HTTP-Code-Zuordnung (400/401/403/404/409/429/503) mit Hinweisen

Anforderung

• Node.js >= 18

Installation

cd mcp
npm install
npm run build

Für Entwicklung mit Hot-Reload:

npm run dev

Konfiguration

Verwendung

stdio (Standard)

{
  "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-Endpunkt: http://localhost:3001/mcp

• Health-Check: http://localhost:3001/health

Nutzungsarteni

Option 1 — Gehosteter Dienst (Streamable HTTP) ⭐

Ashar betreibt den MCP-Server als öffentlichen Dienst mcp.ashar.finance. Der Client installiert nichts — er zeigt seinen MCP-Client auf https://mcp.ashar.finance/mcp und sendet den Tenant-Schlüssel.

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

• Öffentlicher Health-Check: https://mcp.ashar.finance/health

• Ideal für Agenten/LLM that MCP speak without infrastructure.

• All requests run through Ashar server, with tenant spread/spread fee and monitoring.

• Provisioning endpoints (ashar_provision_test_tenant) run without key.

Option 2 — Selbst hosten (stdio)

The client runs locally (or in its own container) and points to Ashar's public API.

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

• Ideal for CLI/editors/IDEs and for clients who prefer to manage their own process.

• Works through public API (https://api.ashar.finance/v2), keeping monitoring on server.

Both modes do not use the REST API, a traditional client using REST, MCP is for AI agents.

Deployment (hosted service)

The subdomain mcp.ashar.finance points to the service on Railway (port 3001). Build via Dockerfile and config in railway.json.

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

Public route (in the gateway):

• mcp.ashar.finance/mcp → service :3001/mcp

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

Typical process

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

2. ashar_create_payin_quote → ashar_execute_payin (deposit)

3. ashar_create_payout_quote → ashar_execute_payout (withdraw)

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

Scripts

License

To be defined. Contact Ashar Finance.

Ein Model Context Protocol (MCP)-Server für die Ashar Exchange API — PIX ↔ USDC/USDT-Exchange mit Plattformgebühren (Payins, Payouts, Transfers, Wallets, Customers und Stats).

Inspiriert von BlindPay MCP: ein eigenständiger HTTP-Wrapper, der die öffentliche API unter https://api.ashar.finance/v2 aufruft und sich über den Header X-Ashar-Tenant-Key authentifiziert.

Funktionen

• 40 Tools, alle mit ashar_-Präfix, die alle API-Gruppen abdecken:

  • Quotes — Payin-, Payout- und Transfer-Angebote (inklusive Gebührenaufschlag)

  • PayIns — PIX-Einzahlung → Stablecoins, Auflisten und Abfragen

  • Payouts — Stablecoin-Auszahlung → PIX

  • Transfers — Wallet → Blockchain-Überweisung

  • Wallets — Wallets und Salden

  • Bank Accounts — PIX-Bankkonten

  • Stats — Tägliche/monatliche Kennzahlen und Gebührensätze

  • Customers — Kunden-Onboarding + Unterressourcen (bank accounts, wallets, virtual accounts)

  • Admin/Provisioning — Test-Tenants erstellen, Tenants auflisten und Anmeldedaten verwalten

• Wählbarer Transport — stdio (Standard) oder Streamable HTTP per Umgebungsvariable

• Handlungsorientierte Fehlermeldungen — HTTP-Statuscode-Zuordnung (400/401/403/404/409/429/503) mit Hinweisen

Umgebungsanforderungen

• Node.js >= 18

Installation

cd mcp
npm install
npm run build

Entwicklungsmodus (Hot Reload):

npm run dev

Konfiguration

Verwendung

stdio (Standard)

{
  "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-Endpunkt: http://localhost:3001/mcp

• Health-Check: http://localhost:3001/health

Nutzungsmodelle

Clients können den Ashar Exchange MCP auf zwei Arten nutzen:

Option 1 — Gehosteter Dienst (Streamable HTTP) ⭐

Ashar betreibt den MCP-Server als öffentlichen Dienst auf der Subdomain mcp.ashar.finance. Clients müssen nichts installieren — sie weisen ihren MCP-Client lediglich auf https://mcp.ashar.finance/mcp und senden einen Tenant-Schlüssel.

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

• Öffentlicher Health-Check: https://mcp.ashar.finance/health

• Geeignet für Agenten/LLMs, die keine Infrastruktur betreiben müssen, die MCP direkt nutzen.

• Alle Anfragen laufen über die Ashar-Server; sie wenden den Spread/die Gebühren des Tenants an und können jede Operation überwachen.

• Der Provisioning-Endpunkt (ashar_provision_test_tenant) ist ohne Schlüssel nutzbar.

Option 2 — Selbst gehostet (stdio)

Clients betreiben den Server lokal (oder in ihrem eigenen Container) und richten ihn (eine) der öffentlichen API von Ashar an.

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

• Geeignet für CLI / Editoren / IDEs und Clients, die den Prozess selbst verwalten möchten.

• Läuft weiterhin über die öffentliche API (https://api.ashar.finance/v2); Spread und Überwachung bleiben serverseitig.

Beide Modi ersetzen nicht die REST API (/v2). Traditionelle Clients (App/Website/Backend) integrieren sich direkt über REST; MCP ist der Kanal fürjenigen KI-Agenten.

Bereitstellung (gehosteter Dienst)

Die Subdomain mcp.ashar.finance zeigt auf den Dienst AsharExchangeMCP auf Railway (Port 3001). Der Build verwendet das Dockerfile, die Konfiguration liegt in railway.json.

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

Öffentliche Routen (Gateway-Ebene):

• mcp.ashar.finance/mcp → dies :3001/mcp (ohne Strip)

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

Empfohlene Umgebungsvariablen für den Dienst:

Typischer Ablauf

1. (ashar_provision_test_tenant) — optional, um einen Test-Tenant mit neuem Schlüssel zu erstellen

2. ashar_create_payin_quote → ashar_execute_payin (Einzahlung)

3. ashar_create_payout_quote → ashar_execute_payout (Auszahlung)

4. ashar_get_daily_stats / ashar_get_monthly_stats / ashar_get_fee_rates (Tracking und Gebühren)

Skripte

Lizenz

Noch offen. Bitte kontaktieren Sie Ashar Finance.