buda-mcp — Buda.com Cryptocurrency Exchange

Name: buda-mcp — Buda.com Cryptocurrency Exchange
Author: gtorreal

@gtorreal

Repository Homepage

About buda-mcp — Buda.com Cryptocurrency Exchange

MCP server for Buda.com's public cryptocurrency exchange API (Chile, Colombia, Peru)

#cryptocurrency #bitcoin #trading #chile #colombia #peru #clp #cop #pen #buda #exchange #finance #market-data

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is buda-mcp?

An MCP server for Buda.com, the leading cryptocurrency exchange in Chile, Colombia, and Peru. It provides any MCP‑compatible AI assistant with live market data, order books, trade history, spreads, technical indicators, and price simulation without requiring an account or API key.

How to use buda-mcp?

Run npx @guiie/buda-mcp or install globally with npm install -g @guiie/buda-mcp then execute buda-mcp. Configure it in MCP clients like Claude Code, Claude Desktop, or Cursor by adding a stanza pointing to npx -y @guiie/buda-mcp. The server exposes tools that can be invoked via the MCP protocol.

Key features of buda-mcp

All tools are public – no API key or account needed.
One‑call market summary with liquidity rating.
Side‑by‑side comparison of markets across currencies.
OHLCV candles aggregated from raw trade history.
Cross‑country arbitrage detection normalized to USDC.
Kelly‑style position sizing computed entirely client‑side.

Use cases of buda-mcp

Get live cryptocurrency prices and order books for Buda markets.
Analyze market spreads and 24‑hour volume for decision support.
Simulate buy/sell orders using live ticker data without placement.
Detect arbitrage opportunities between Chile, Colombia, and Peru.
Compute technical indicators (RSI, MACD, Bollinger Bands) on demand.

FAQ from buda-mcp

Can I trade or place orders with buda-mcp?

No. Tools like simulate_order and get_real_quotation only simulate orders – no order is ever placed. All simulation responses include "simulation": true.

Does buda-mcp require any credentials?

No. All tools access only public Buda.com API endpoints. No API key, account, or authentication is accepted or stored.

What markets does buda-mcp support?

It covers markets quoting in CLP (Chile), COP (Colombia), PEN (Peru), USDC, and BTC. Sample pairs include BTC‑CLP, ETH‑COP, SOL‑PEN, BTC‑USDC, and ETH‑BTC.

What runtime does buda-mcp need?

Node.js version 18 or later. It can run via npx, a global install, or from source. An HTTP transport is also available for deployment on platforms like Railway.

How are data and security handled?

Input validation is applied to all tool parameters to prevent prompt injection. Error messages are sanitized – internal details are logged only to stderr and never returned to callers.