# io.github.gtorreal/buda-mcp (npm · @guiie/buda-mcp)

Buda.com market data: prices, spreads, OHLCV, order books, trades, and volume for CLP, COP, PEN.

- Trust score: 63/100 (medium)
- Change this week: +21
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- npm · `@guiie/buda-mcp`: 63/100 (this document), [markdown](https://verifymcp.io/servers/gtorreal-buda-mcp/guiie-buda-mcp.md), [page](https://verifymcp.io/servers/gtorreal-buda-mcp/guiie-buda-mcp)

## Channel facts

- Registry: `npm`
- Package: `@guiie/buda-mcp`
- Version: `2.0.0`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 87/100
  - No malware found by supply-chain analysis.
  - Only part of the dependency tree could be resolved (95 of 96), so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - Only part of the dependency tree could be resolved (95 of 96), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 113 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 43/100
  - 0% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 2612 tokens (~153/item across 17 items; 16 tools + 1 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 27/100
  - Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add gtorreal-buda-mcp -- npx -y @guiie/buda-mcp
```

### Codex

```bash
codex mcp add gtorreal-buda-mcp -- npx -y @guiie/buda-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "gtorreal-buda-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@guiie/buda-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add gtorreal-buda-mcp --command npx --arg -y --arg @guiie/buda-mcp
```

### Hermes

```yaml
mcp_servers:
  gtorreal-buda-mcp:
    command: "npx"
    args: ["-y", "@guiie/buda-mcp"]
```

### Other

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

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 63, +1)

No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-08-02 (score 62, +39)

- [security regression] Provenance: unverified → fail
- [security improvement] Known CVEs: unverified → partial
- [security improvement] Install scripts: unverified → pass
- [security improvement] Malware scan: unverified → pass
- [functional improvement] Maintenance: unverified → pass
- [functional improvement] Dependency health: unverified → partial
- [functional improvement] Stability: unverified → 0.23
- [functional improvement] License: unverified → pass
- [functional improvement] Schema quality: unverified → excellent
- [functional] Licence: MIT

### 2026-08-01 (score 23, +18)

- [security] Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window).
- [functional improvement] MCP protocol: unverified → pass
- [functional improvement] Schema quality: unverified → 0
- [functional improvement] Tool coverage: unverified → 100

### 2026-07-31 (score 5, −1)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 6, −36)

- [security regression] Malware scan: pass → unverified
- [functional regression] Tool coverage: 100 → unverified
- [functional regression] Schema quality: 0 → unverified

### 2026-07-28 (score 42, 0)

- [functional regression] Security disclosure: unverified → fail

### 2026-07-27 (score 42)

First indexed and scored.

## MCP tools (16)

### `get_markets` (~117 tokens)

Lists all available trading pairs on Buda.com, or returns details for a specific market (base/quote currencies, taker/maker fees as decimals, minimum order size in base currency, and fee discount tiers). Omit market_id to get all ~26 markets at once. Example: 'What is the taker fee and minimum order size for BTC-CLP?'

Input parameters:

- `market_id` (string): Optional market ID (e.g. 'BTC-CLP', 'ETH-BTC'). Omit to list all markets.

### `get_ticker` (~132 tokens)

Returns the current market snapshot for a Buda.com market: last traded price, best bid, best ask, 24h volume, and price change over 24h and 7d. All prices are floats in the quote currency (e.g. CLP for BTC-CLP). price_variation_24h is a decimal fraction (0.012 = +1.2%). Example: 'What is the current Bitcoin price in Chilean pesos?'

Input parameters:

- `market_id` (string, required): Market ID (e.g. 'BTC-CLP', 'ETH-BTC', 'BTC-COP').

### `get_orderbook` (~122 tokens)

Returns the current order book for a Buda.com market as typed objects with float price and amount fields. Bids are sorted highest-price first; asks lowest-price first. Prices are in the quote currency; amounts are in the base currency. Example: 'What are the top 5 buy and sell orders for BTC-CLP right now?'

Input parameters:

- `limit` (integer): Maximum number of levels to return per side (default: all).
- `market_id` (string, required): Market ID (e.g. 'BTC-CLP', 'ETH-BTC').

### `get_trades` (~145 tokens)

Returns recent trade history for a Buda.com market as typed objects. Each entry has timestamp_ms (integer), amount (float, base currency), price (float, quote currency), and direction ('buy' or 'sell'). Example: 'What was the last executed price for BTC-CLP and was it a buy or sell?'

Input parameters:

- `limit` (integer): Number of trades to return (default: 50, max: 100).
- `market_id` (string, required): Market ID (e.g. 'BTC-CLP', 'ETH-BTC').
- `timestamp` (integer): Unix timestamp (seconds) to paginate from. Returns trades older than this timestamp.

### `get_market_volume` (~105 tokens)

Returns 24h and 7-day transacted volume for a Buda.com market, split by buy (bid) and sell (ask) side. All volume values are floats in the base currency (e.g. BTC for BTC-CLP). Example: 'How much Bitcoin was sold on BTC-CLP in the last 24 hours?'

Input parameters:

- `market_id` (string, required): Market ID (e.g. 'BTC-CLP', 'ETH-BTC').

### `get_spread` (~129 tokens)

Returns the best bid, best ask, absolute spread, and spread percentage for a Buda.com market. All prices are floats in the quote currency (e.g. CLP). spread_percentage is a float in percent (e.g. 0.15 means 0.15%). Use this to evaluate liquidity before placing a large order. Example: 'Is BTC-CLP liquid enough to buy 10M CLP without significant slippage?'

Input parameters:

- `market_id` (string, required): Market ID (e.g. 'BTC-CLP', 'ETH-BTC', 'BTC-COP').

### `compare_markets` (~125 tokens)

Returns side-by-side ticker data for all trading pairs of a given base currency across Buda.com's supported quote currencies (CLP, COP, PEN, BTC, USDC, ETH). All prices are floats; price_change_24h and price_change_7d are floats in percent (e.g. 1.23 means +1.23%). Example: 'In which country is Bitcoin currently most expensive on Buda?'

Input parameters:

- `base_currency` (string, required): Base currency to compare across all available markets (e.g. 'BTC', 'ETH', 'XRP').

### `get_price_history` (~223 tokens)

IMPORTANT: Candles are aggregated client-side from raw trades (Buda has no native candlestick endpoint) — fetching more trades via the 'limit' parameter gives deeper history but slower responses. Returns OHLCV candles (open/high/low/close as floats in quote currency; volume as float in base currency) for periods 5m, 15m, 30m, 1h, 4h, or 1d. Candle timestamps are UTC bucket boundaries. Example: 'Show me the hourly BTC-CLP price chart for the past 24 hours.'

Input parameters:

- `limit` (integer): Raw trades to fetch before aggregation (default: 100, max: 1000). More trades = deeper history but slower response.
- `market_id` (string, required): Market ID (e.g. 'BTC-CLP', 'ETH-BTC').
- `period` (string): Candle period: '5m', '15m', '30m', '1h', '4h', or '1d'. Default: '1h'.

### `get_arbitrage_opportunities` (~221 tokens)

Detects cross-country price discrepancies for a given asset across Buda's CLP, COP, and PEN markets, normalized to USDC. Fetches all relevant tickers, converts each local price to USDC using the current USDC-CLP / USDC-COP / USDC-PEN rates, then computes pairwise discrepancy percentages. Results above threshold_pct are returned sorted by opportunity size. Note: Buda taker fee is 0.8% per leg (~1.6% round-trip) — always deduct fees before acting on any discrepancy. Example: 'Is there an arbitrage opportunity for BTC between Chile and Peru right now?'

Input parameters:

- `base_currency` (string, required): Base asset to scan (e.g. 'BTC', 'ETH', 'XRP').
- `threshold_pct` (number): Minimum price discrepancy percentage to include in results (default: 0.5). Buda taker fee is 0.8% per leg, so a round-trip requires > 1.6% to be profitable.

### `get_market_summary` (~158 tokens)

One-call summary of everything relevant about a market: last price, best bid/ask, spread %, 24h volume, 24h and 7d price change, and a liquidity_rating ('high' / 'medium' / 'low' based on spread thresholds: < 0.3% = high, 0.3–1% = medium, > 1% = low). All prices and volumes are floats. Best first tool to call when a user asks about any specific market. Example: 'Give me a complete overview of the BTC-CLP market right now.'

Input parameters:

- `market_id` (string, required): Market ID (e.g. 'BTC-CLP', 'ETH-COP', 'BTC-PEN').

### `simulate_order` (~201 tokens)

[DEPRECATED: prefer get_real_quotation for server-side accurate quotes] Simulates a buy or sell order on Buda.com using live ticker data — no order is placed. Returns estimated fill price, fee, total cost, and slippage vs mid-price. Omit 'price' for a market order simulation; supply 'price' for a limit order simulation. All outputs are labelled simulation: true — this tool never places a real order. Example: 'How much would it cost to buy 0.01 BTC on BTC-CLP right now?'

Input parameters:

- `amount` (number, required): Order size in base currency (e.g. BTC for BTC-CLP).
- `market_id` (string, required): Market ID (e.g. 'BTC-CLP', 'ETH-BTC').
- `price` (number): Limit price in quote currency. Omit for a market order simulation.
- `side` (string, required): 'buy' or 'sell'.

### `get_real_quotation` (~194 tokens)

Gets a server-side price quotation for a buy or sell on Buda.com. Calls the Buda quotation API to compute an accurate fill estimate including fees, based on live order book state. Prefer this over simulate_order for accurate fee-tier-aware quotes. This is a POST (not idempotent) but does not place an order. Public endpoint — no API key required. Parameters: market_id, type ('Bid'|'Ask'), amount, optional limit price. Example: 'Get an accurate quote to sell 0.05 BTC on BTC-CLP.'

Input parameters:

- `amount` (number, required): Order size (positive number).
- `limit` (number): Optional limit price in quote currency.
- `market_id` (string, required): Market ID (e.g. 'BTC-CLP', 'ETH-BTC').
- `type` (string, required): 'Bid' to buy base currency, 'Ask' to sell base currency.

### `calculate_position_size` (~240 tokens)

Calculates position size based on your capital, risk tolerance, entry price, and stop-loss. Determines how many units to buy or sell so that a stop-loss hit costs exactly risk_pct% of capital. Fully client-side — no API call is made. Example: 'How many BTC can I buy on BTC-CLP if I have 1,000,000 CLP, risk 2%, entry 80,000,000 CLP, stop at 78,000,000 CLP?'

Input parameters:

- `capital` (number, required): Total available capital in the quote currency (e.g. CLP for BTC-CLP).
- `entry_price` (number, required): Planned entry price in quote currency.
- `market_id` (string, required): Market ID (e.g. 'BTC-CLP', 'ETH-COP'). Used to derive the quote currency.
- `risk_pct` (number, required): Percentage of capital to risk on this trade (0.1–10, e.g. 2 = 2%).
- `stop_loss_price` (number, required): Stop-loss price in quote currency. Must be below entry for buys, above entry for sells.

### `get_market_sentiment` (~123 tokens)

Computes a composite sentiment score (−100 to +100) for a Buda.com market based on 24h price variation (40%), volume vs 7-day average (35%), and bid/ask spread vs baseline (25%). Returns a score, a label (bearish/neutral/bullish), and a full component breakdown. Example: 'Is the BTC-CLP market currently bullish or bearish?'

Input parameters:

- `market_id` (string, required): Market ID (e.g. 'BTC-CLP', 'ETH-BTC', 'BTC-USDT').

### `get_technical_indicators` (~271 tokens)

Computes RSI (14), MACD (12/26/9), Bollinger Bands (20, 2σ), SMA 20, and SMA 50 from Buda trade history — no external data or libraries. Supports periods: 5m, 15m, 30m, 1h, 4h, 1d. Use shorter periods (5m/15m) for intraday analysis. Uses at least 500 trades for reliable results (set limit=1000 for maximum depth). Returns latest indicator values and signal interpretations (overbought/oversold, crossover, band position). If fewer than 20 candles are available after aggregation, returns a structured warning instead. Example: 'Is BTC-CLP RSI overbought on the 4-hour chart?'

Input parameters:

- `limit` (integer): Number of raw trades to fetch (default: 500, max: 1000). More trades = more candles = more reliable indicators.
- `market_id` (string, required): Market ID (e.g. 'BTC-CLP', 'ETH-BTC').
- `period` (string): Candle period: '5m', '15m', '30m', '1h', '4h', or '1d'. Default: '1h'.

### `get_available_banks` (~99 tokens)

Returns banks available for deposits and withdrawals of a fiat currency on Buda.com. Returns an empty banks array (not an error) if the currency has no associated banks (e.g. crypto currencies or unsupported fiat currencies). Results are cached for 60 seconds. Example: 'Which banks can I use for CLP deposits?'

Input parameters:

- `currency` (string, required): Currency code (e.g. 'CLP', 'COP', 'PEN').

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/gtorreal-buda-mcp/guiie-buda-mcp#diagnostics

## Score history

- 2026-08-03: 63
- 2026-08-02: 62
- 2026-08-01: 23
- 2026-07-31: 5
- 2026-07-30: 6
- 2026-07-28: 42
- 2026-07-27: 42

## Links

- npm package: https://www.npmjs.com/package/@guiie/buda-mcp
- Socket report: https://socket.dev/npm/package/@guiie/buda-mcp
- Repository: https://github.com/gtorreal/buda-mcp
- Changelog RSS feed: https://verifymcp.io/servers/gtorreal-buda-mcp/guiie-buda-mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/gtorreal-buda-mcp/guiie-buda-mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/gtorreal-buda-mcp/guiie-buda-mcp