io.github.gtorreal/buda-mcp

NPM · @GUIIE/BUDA-MCP · SCANNED AUG 3

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

Available components

+21 this week 63 63 Trust /100

Trust breakdown (6 categories)

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. How we score →

Supply Chain Security87

No malware found by supply-chain analysis.Pass
Only part of the dependency tree could be resolved (95 of 96), so this covers what we could see, not the whole tree.Partial
No install/post-install scripts declared.Pass
Only part of the dependency tree could be resolved (95 of 96), so this covers what we could see, not the whole tree. View diagnostics → Partial

Provenance & Transparency45

Source repository is publicly reachable at the declared URL. View diagnostics → Pass
Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
Clear OSI-approved license (MIT).Pass
Actively maintained (last published 113 days ago).Pass
Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail

Schema Quality & AI Usability43

0% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Fail
AI-judged instruction clarity (excellent).Pass
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. See how to fix → Fail
Usage-examples check failed: none of the tools include examples. See how to fix → Fail

Stability & Change Management27

Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial

Tool Coverage100

100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
100% of tool parameters carry a description.Pass

Capabilities100

Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · @guiie/buda-mcp

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

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

# add to Codex CLI

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
    }
  }
}

# add to OpenClaw

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

# ~/.hermes/config.yaml

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

// mcp.json

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

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

3 Aug 26 +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.
2 Aug 26 +39
- Provenance: unverified → fail ▼ security
- Known CVEs: unverified → partial ▲ security
- Install scripts: unverified → pass ▲ security
- Malware scan: unverified → pass ▲ security
- Maintenance: unverified → pass ▲ functional
- Dependency health: unverified → partial ▲ functional
- Stability: unverified → 0.23 ▲ functional
- License: unverified → pass ▲ functional
- Schema quality: unverified → excellent ▲ functional
- Licence: MIT functional
1 Aug 26 +18
- Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
- MCP protocol: unverified → pass ▲ functional
- Schema quality: unverified → 0 ▲ functional
- Tool coverage: unverified → 100 ▲ functional
31 Jul 26 −1
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
30 Jul 26 −36
- Malware scan: pass → unverified ▼ security
- Tool coverage: 100 → unverified ▼ functional
- Schema quality: 0 → unverified ▼ functional
28 Jul 26 0
- Security disclosure: unverified → fail ▼ functional
27 Jul 26 42

First indexed and scored.

Show 3 earlier entries Hide earlier entries

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Analysed npm/@guiie/[email protected]

Provenance none

Ecosystem: npm · Outcome: none

Dependencies 95 packages

95 packages in the resolved dependency tree · 95 deprecated · 29 stale.

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools — 16 exposed · ~2,605 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens

calculate_position_size ~240

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 Output Examples

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

No output schema declared.

No examples provided.

compare_markets ~125

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 Output Examples

Name	Type	Req	Description
base_currency	string	yes	Base currency to compare across all available markets (e.g. 'BTC', 'ETH', 'XRP').

No output schema declared.

No examples provided.

get_arbitrage_opportunities ~221

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 Output Examples

Name	Type	Req	Description
base_currency	string	yes	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.

No output schema declared.

No examples provided.

get_available_banks ~99

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 Output Examples

Name	Type	Req	Description
currency	string	yes	Currency code (e.g. 'CLP', 'COP', 'PEN').

No output schema declared.

No examples provided.

get_market_sentiment ~123

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 Output Examples

Name	Type	Req	Description
market_id	string	yes	Market ID (e.g. 'BTC-CLP', 'ETH-BTC', 'BTC-USDT').

No output schema declared.

No examples provided.

get_market_summary ~158

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 Output Examples

Name	Type	Req	Description
market_id	string	yes	Market ID (e.g. 'BTC-CLP', 'ETH-COP', 'BTC-PEN').

No output schema declared.

No examples provided.

get_market_volume ~105

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 Output Examples

Name	Type	Req	Description
market_id	string	yes	Market ID (e.g. 'BTC-CLP', 'ETH-BTC').

No output schema declared.

No examples provided.

get_markets ~117

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 Output Examples

Name	Type	Req	Description
market_id	string	—	Optional market ID (e.g. 'BTC-CLP', 'ETH-BTC'). Omit to list all markets.

No output schema declared.

No examples provided.

get_orderbook ~122

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 Output Examples

Name	Type	Req	Description
limit	integer	—	Maximum number of levels to return per side (default: all).
market_id	string	yes	Market ID (e.g. 'BTC-CLP', 'ETH-BTC').

No output schema declared.

No examples provided.

get_price_history ~223

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 Output Examples

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

No output schema declared.

No examples provided.

get_real_quotation ~194

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 Output Examples

Name	Type	Req	Description
amount	number	yes	Order size (positive number).
limit	number	—	Optional limit price in quote currency.
market_id	string	yes	Market ID (e.g. 'BTC-CLP', 'ETH-BTC').
type	string	yes	'Bid' to buy base currency, 'Ask' to sell base currency.

No output schema declared.

No examples provided.

get_spread ~129

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 Output Examples

Name	Type	Req	Description
market_id	string	yes	Market ID (e.g. 'BTC-CLP', 'ETH-BTC', 'BTC-COP').

No output schema declared.

No examples provided.

get_technical_indicators ~271

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 Output Examples

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

No output schema declared.

No examples provided.

get_ticker ~132

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 Output Examples

Name	Type	Req	Description
market_id	string	yes	Market ID (e.g. 'BTC-CLP', 'ETH-BTC', 'BTC-COP').

No output schema declared.

No examples provided.

get_trades ~145

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 Output Examples

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

No output schema declared.

No examples provided.

simulate_order ~201

[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 Output Examples

Name	Type	Req	Description
amount	number	yes	Order size in base currency (e.g. BTC for BTC-CLP).
market_id	string	yes	Market ID (e.g. 'BTC-CLP', 'ETH-BTC').
price	number	—	Limit price in quote currency. Omit for a market order simulation.
side	string	yes	'buy' or 'sell'.

No output schema declared.

No examples provided.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

27 Jul 3 Aug