buda-mcp

MCP-Server für Buda.com – die führende Kryptobörse in Chile, Kolumbien und Peru. Ermöglicht jedem MCP-kompatiblen KI-Assistenten den Live-Zugriff auf Marktdaten, Orderbücher, Handelshistorie, Spreads, technische Indikatoren und Preissimulation – kein Konto oder API-Schlüssel erforderlich.

Schnelleinstieg

npx @guiie/buda-mcp

Oder dauerhaft installieren:

npm install -g @guiie/buda-mcp
buda-mcp

Installation in Ihrem MCP-Client

Claude Code

claude mcp add buda-mcp -- npx -y @guiie/buda-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "buda-mcp": {
      "command": "npx",
      "args": ["-y", "@guiie/buda-mcp"]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "buda-mcp": {
      "command": "npx",
      "args": ["-y", "@guiie/buda-mcp"]
    }
  }
}

Tools

Alle Tools sind öffentlich – kein API-Schlüssel oder Konto erforderlich.

get_market_summary ⭐ Hier starten

Zusammenfassung mit einem Aufruf: letzter Preis, Geld-/Briefkurs, Spread in %, 24h-Volumen, Preisänderung und liquidity_rating (high / medium / low). Das beste erste Tool, wenn ein Benutzer nach einem bestimmten Markt fragt.

get_markets

Listet alle Handelspaare auf Buda.com auf oder ruft Details für einen bestimmten Markt ab (Gebühren, Mindestordergröße, Rabattstufen).

get_ticker

Aktuelle Momentaufnahme: letzter Preis, bester Geld-/Briefkurs, 24h-Volumen sowie Preisänderung über 24h und 7d.

get_orderbook

Aktuelles Orderbuch: sortierte Geld- und Briefkurse als {price, amount}-Objekte.

get_trades

Aktuelle Handelshistorie als typisierte Objekte: {timestamp_ms, amount, price, direction}.

get_market_volume

Gehandeltes Volumen der letzten 24h und 7 Tage nach Seite (Geld = Käufe, Brief = Verkäufe).

get_spread

Geld-/Brief-Spread: absoluter Wert und Prozentsatz des Briefkurses.

compare_markets

Ticker-Daten im direkten Vergleich für alle Paare einer gegebenen Basiswährung über alle Notierungswährungen hinweg.

get_price_history

OHLCV-Kerzen, aggregiert aus der rohen Handelshistorie (Buda hat keinen nativen Candlestick-Endpunkt). Unterstützt die Zeiträume 5m, 15m, 30m, 1h, 4h, 1d.

get_arbitrage_opportunities

Erkennt Preisunterschiede zwischen Ländern für einen Vermögenswert über Budas CLP-, COP- und PEN-Märkte hinweg, normalisiert auf USDC.

simulate_order

Simuliert eine Kauf- oder Verkaufsorder unter Verwendung von Live-Ticker-Daten – es wird niemals eine echte Order platziert. Gibt estimated_fill_price, fee_amount, total_cost, slippage_vs_mid_pct zurück. Alle Antworten enthalten simulation: true.

calculate_position_size

Positionsgrößenbestimmung nach Kelly-Art basierend auf Kapital, Risiko-%, Einstiegs- und Stop-Loss-Preis. Vollständig clientseitig – kein API-Aufruf.

get_market_sentiment

Zusammengesetzter Sentiment-Score (−100 bis +100) aus drei Komponenten: 24h-Preisvariation (40%), Volumen vs. 7-Tage-Durchschnitt (35%), Spread vs. marktüblicher Basislinie (25%). Gibt score, label, component_breakdown und einen disclaimer zurück.

get_technical_indicators

RSI (14), MACD (12/26/9), Bollinger-Bänder (20, 2σ), SMA 20, SMA 50 – serverseitig berechnet aus der Buda-Handelshistorie (keine externen Bibliotheken). Gibt Signalinterpretationen und eine strukturierte Warnung zurück, falls weniger als 20 Kerzen verfügbar sind. Enthält disclaimer.

get_real_quotation

Gibt ein Echtzeit-Angebot für einen bestimmten Orderbetrag und eine bestimmte Richtung zurück, das den genauen Ausführungspreis, die Gebühr und die Saldoänderungen anzeigt, ohne eine Order zu platzieren.

get_available_banks

Listet verfügbare Banken für Fiat-Einzahlungen/-Auszahlungen im Land der jeweiligen Währung auf.

MCP-Ressourcen

Zusätzlich zu den Tools stellt der Server MCP-Ressourcen bereit, die Clients direkt lesen können:

Abgedeckte Märkte

Aus Quellcode bauen

git clone https://github.com/gtorreal/buda-mcp.git
cd buda-mcp
npm install
npm run build
node dist/index.js        # stdio (for MCP clients)
node dist/http.js         # HTTP on port 3000 (for Railway / hosted)

Tests ausführen:

npm run test:unit        # 100 unit tests, no network required
npm run test:integration # live API tests (skips if unreachable)
npm test                 # both

HTTP / Railway-Bereitstellung

Der Einstiegspunkt dist/http.js führt einen Express-Server aus mit:

• POST /mcp — Streambarer HTTP-MCP-Transport

• GET /mcp — SSE-Streaming-Transport

• GET /health — Gesundheitsprüfung ({ status })

• GET /.well-known/mcp/server-card.json — Smithery-kompatibles statisches Tool-Manifest

Umgebungsvariablen

Sicherheit

Der Server macht nur öffentliche Buda.com-API-Endpunkte zugänglich. Es werden keine Anmeldedaten akzeptiert oder gespeichert. Auf alle Tool-Parameter wird eine Eingabevalidierung angewendet, um Prompt-Injection zu verhindern. Fehlermeldungen werden bereinigt – interne Details (Pfade, Upstream-Fehler) werden nur in stderr protokolliert und niemals an Aufrufer zurückgegeben.

Schwachstellen melden

Bitte melden Sie Sicherheitsprobleme privat über GitHub Security Advisories – nicht als öffentliche Issues. Siehe SECURITY.md für die vollständige Offenlegungsrichtlinie.

Projektstruktur

src/
  client.ts                   BudaClient (HTTP + 429 retry)
  cache.ts                    In-memory TTL cache with in-flight deduplication
  types.ts                    TypeScript types for Buda API responses
  validation.ts               validateMarketId(), validateCurrency()
  utils.ts                    flattenAmount(), aggregateTradesToCandles(), getLiquidityRating()
  version.ts                  Single source of truth for version string
  index.ts                    stdio MCP server entrypoint
  http.ts                     HTTP/SSE MCP server entrypoint
  tools/
    markets.ts                get_markets
    ticker.ts                 get_ticker
    orderbook.ts              get_orderbook
    trades.ts                 get_trades
    volume.ts                 get_market_volume
    spread.ts                 get_spread
    compare_markets.ts        compare_markets
    price_history.ts          get_price_history
    arbitrage.ts              get_arbitrage_opportunities
    market_summary.ts         get_market_summary
    simulate_order.ts         simulate_order
    calculate_position_size.ts calculate_position_size
    market_sentiment.ts       get_market_sentiment
    technical_indicators.ts   get_technical_indicators
    banks.ts                  get_available_banks
    quotation.ts              get_real_quotation
marketplace/
  cursor-mcp.json             Cursor MCP config example
  claude-listing.md           Claude registry listing
  openapi.yaml                OpenAPI spec (GPT Actions / HTTP wrapper)
  gemini-tools.json           Gemini function declarations

Lizenz

MIT — Buda.com API-Dokumentation