buda-mcp

MCP server for Buda.com — the leading cryptocurrency exchange in Chile, Colombia, and Peru. Gives any MCP-compatible AI assistant live access to market data, order books, trade history, spreads, technical indicators, and price simulation — no account or API key required.

---

Quick Start

npx @guiie/buda-mcp

Or install permanently:

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

---

Install in your 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

All tools are public — no API key or account required.

get_market_summary ⭐ Start here

One-call summary: last price, bid/ask, spread %, 24h volume, price change, and liquidity_rating (high / medium / low). Best first tool when a user asks about any specific market.

Parameter	Type	Required	Description
market_id	string	Yes	Market ID (e.g. BTC-CLP).

---

get_markets

List all trading pairs on Buda.com, or get details for a specific market (fees, minimum order size, discount tiers).

Parameter	Type	Required	Description
market_id	string	No	Market ID (e.g. BTC-CLP). Omit to list all markets.

---

get_ticker

Current snapshot: last price, best bid/ask, 24h volume, and price change over 24h and 7d.

Parameter	Type	Required	Description
market_id	string	Yes	Market ID (e.g. BTC-CLP, ETH-COP).

---

get_orderbook

Current order book: sorted bids and asks as {price, amount} objects.

Parameter	Type	Required	Description
market_id	string	Yes	Market ID.
limit	number	No	Max price levels per side (default: all).

---

get_trades

Recent trade history as typed objects: {timestamp_ms, amount, price, direction}.

Parameter	Type	Required	Description
market_id	string	Yes	Market ID.
limit	number	No	Number of trades (default 50, max 100).
timestamp	number	No	Unix seconds — returns trades older than this (pagination).

---

get_market_volume

24h and 7-day transacted volume by side (bid = buys, ask = sells).

Parameter	Type	Required	Description
market_id	string	Yes	Market ID.

---

get_spread

Bid/ask spread: absolute value and percentage of the ask price.

Parameter	Type	Required	Description
market_id	string	Yes	Market ID.

---

compare_markets

Side-by-side ticker data for all pairs of a given base currency across all quote currencies.

Parameter	Type	Required	Description
base_currency	string	Yes	Base currency (e.g. BTC, ETH).

---

get_price_history

OHLCV candles aggregated from raw trade history (Buda has no native candlestick endpoint). Supports 5m, 15m, 30m, 1h, 4h, 1d periods.

Parameter	Type	Required	Description
`market_i

... View full README on GitHub