🚀 Luno MCP Server - FastMCP 2.0

Created By

amanasmuei10 months ago

mcp server for luno

Content

🚀 Luno MCP Server - FastMCP 2.0

A modern Model Context Protocol (MCP) server for the Luno cryptocurrency exchange, built with FastMCP 2.0 and Python 3.12.

✅ Quick Start

1. Install Dependencies

# Activate the virtual environment
source venv/bin/activate

# Dependencies are already installed:
# - fastmcp 2.5.1
# - httpx
# - pydantic
# - python-dotenv

2. Configure Claude Desktop

Add this to your ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "luno": {
      "command": "/Users/aman-asmuei/Documents/mcp/mcp-luno/venv/bin/python",
      "args": [
        "/Users/aman-asmuei/Documents/mcp/mcp-luno/src/luno_mcp_server/server.py"
      ],
      "cwd": "/Users/aman-asmuei/Documents/mcp/mcp-luno",
      "env": {
        "LUNO_API_KEY": "your_api_key_here",
        "LUNO_API_SECRET": "your_api_secret_here"
      }
    }
  }
}

3. Test

Restart Claude Desktop and ask:

"What's the Bitcoin price in EUR?"
"Get ETHZAR price"
"Show me my account balance"
"Get historical prices for XBTZAR over the last 7 days"
"Show me Bitcoin price range analysis for the past 30 days"

🛠️ Available Tools

Public Tools (No API credentials required)

get_crypto_price - Real-time prices for any trading pair
get_market_overview - Market data and available pairs

Historical Data Tools (API credentials required)

get_historical_prices - OHLC candlestick data for any trading pair
get_price_range - Price analysis over specified time periods (1-30 days)

Private Tools (API credentials required)

get_account_balance - Account balances
place_order - Place buy/sell orders
cancel_order - Cancel orders
get_order_status - Check order status
get_transaction_history - Transaction history
get_fees - Trading fees

📈 Historical Price Data Features

Candlestick Data (`get_historical_prices`)

Timeframes: 1m, 5m, 15m, 30m, 1h, 3h, 4h, 8h, 24h, 3d, 7d
Data: OHLC (Open, High, Low, Close) + Volume
Limit: Up to 1000 candles per request
Format: Standard candlestick data with timestamps

Price Range Analysis (`get_price_range`)

Period: 1-30 days of historical data
Statistics: High, Low, Open, Close, Average prices
Metrics: Price change, percentage change, total volume
Convenience: Automatic daily candle aggregation

🌍 Supported Trading Pairs

ZAR (South Africa): XBTZAR, ETHZAR, ADAZAR
EUR (Europe): XBTEUR, ETHEUR
GBP (UK): XBTGBP, ETHGBP, SOLGBP
USD (US): XBTUSD, ETHUSD
And more!

🏗️ Project Structure

luno-mcp/
├── src/
│   ├── luno_mcp/              # Modern FastMCP 2.0 implementation
│   │   ├── server.py          # Main server with all tools
│   │   ├── client.py          # Luno API client
│   │   ├── config.py          # Configuration management
│   │   └── tools/             # Modular tool organization
│   ├── luno_mcp_server/       # Working FastMCP server (CURRENT)
│   │   ├── server.py          # ← Currently used by Claude Desktop
│   │   └── luno_client.py     # Luno API client
│   └── main.py                # Alternative entry point
├── tests/                     # Test suite
├── docs/                      # Documentation
├── archive/                   # Old implementations
├── venv/                      # Python 3.12 virtual environment
└── README.md                  # This file