# buda-mcp

Real-time market data from Buda.com — prices, order books, trades, and volume for crypto markets in Chile (CLP), Colombia (COP), and Peru (PEN). No API key required.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add guillermo-ap5g/buda-mcp

# Browse available tools
npx -y @smithery/cli@latest tool list guillermo-ap5g/buda-mcp

# Get full schema for a tool
npx -y @smithery/cli@latest tool get guillermo-ap5g/buda-mcp get_markets

# Call a tool
npx -y @smithery/cli@latest tool call guillermo-ap5g/buda-mcp get_markets '{}'
```

## Direct MCP Connection

Endpoint: `https://buda-mcp--guillermo-ap5g.run.tools`

## Tools (5)

- `get_markets` — List all available trading pairs on Buda.com, or get details for a specific market.
- `get_ticker` — Get current price, bid/ask, volume, and price change for a Buda.com market.
- `get_orderbook` — Get the full order book (bids and asks) for a Buda.com market.
- `get_trades` — Get recent trade history for a Buda.com market.
- `get_market_volume` — Get 24h and 7-day transacted volume for a Buda.com market.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get guillermo-ap5g/buda-mcp <tool-name>
```