Skip to main content
Glama
deenesjakoruzh

Luno MCP Server

by amanasmuei
GitHub
Python
2
  • Apple
  • Linux
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

🚀 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

🔧 Technical Details

  • Python: 3.12.10 (in virtual environment)
  • Framework: FastMCP 2.5.1
  • API Client: httpx for async HTTP requests
  • Transport: STDIO (JSON-RPC 2.0)
  • Architecture: Async/await with proper error handling

📚 Documentation

📚 Documentation Site

Visit our GitHub Pages documentation: https://amanasmuei.github.io/mcp-luno

Note: If you encounter GitHub Pages deployment errors, see docs/GITHUB_PAGES_FIX.md for the complete fix guide.

🔒 Security

  • API credentials stored as environment variables
  • All communications use HTTPS
  • Virtual environment isolation
  • No credentials logged or exposed

🚨 Troubleshooting

Common Issues

  1. Import errors: Make sure you're using the virtual environment
  2. API errors: Check your Luno API credentials
  3. Connection issues: Verify internet connectivity

Get Help

  1. Check the logs in Claude Desktop
  2. Test the server directly: python src/luno_mcp_server/server.py
  3. Verify dependencies: pip list | grep fastmcp

💖 Support This Project

If this Luno MCP server has been helpful for your cryptocurrency trading and analysis, consider supporting its development!

☕ Support This Project

🌍 Global donation options that work worldwide:

🪙 Crypto Donations

  • Bitcoin (BTC): 3CPb1HP6Gfpx3MZFdrm4nhoHk4VbX2eZRj
  • Ethereum (ETH): 0x54dC4eDf6c940C52A1434824634d8cE8629767b3
  • Luno Trading: Use this MCP server to trade! 📈

Your support helps maintain and improve this free, open-source trading tool! 🚀

🎉 Success!

You should now have a fully working Luno MCP server with:

  • ✅ Real-time cryptocurrency prices
  • ✅ Historical price data and candlestick charts
  • ✅ Price range analysis and statistics
  • ✅ Multi-currency support (ZAR, EUR, GBP, USD)
  • ✅ Account management tools
  • ✅ Trading capabilities
  • ✅ FastMCP 2.0 architecture

Ask Claude: "What's the Bitcoin price in EUR?" or "Show me XBTZAR price history for the past week" to test!

This server cannot be installed

-
security - not tested
F
license - not found
-
quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

A Model Context Protocol server that provides a standardized interface for AI models and applications to interact with the Luno cryptocurrency exchange API for trading operations.

  1. Features
    1. Prerequisites
      1. Installation
        1. Docker Support
          1. Using Docker Compose (Recommended)
          2. Using Docker Directly
          3. Using with AI Assistants
          4. SSL Support with Docker
        2. Manual Installation
          1. Running the Server
            1. STDIO Transport (Default, Single Client)
            2. WebSockets Transport (Multiple Clients)
            3. Command Line Options
            4. Environment Variables
            5. Testing with the Standard Client
          2. MCP Protocol Integration
            1. VS Code Integration
              1. VS Code Configuration
            2. Available Methods
              1. Example Requests
            3. Development
              1. Project Structure
              2. Running Tests
              3. Adding New Features
            4. Architecture
              1. Troubleshooting
                1. Common Issues
                2. Configuration Priority
              2. Multi-Client Support
                1. Transport Options
                2. Running with WebSockets Transport
                3. WebSocket Client Tools
              3. License

                Related MCP Servers

                • MCP Ethers Wallet

                  crazyrabbitLTC
                  A
                  security
                  A
                  license
                  A
                  quality
                  A Model Context Protocol server that gives LLMs the ability to interact with Ethereum networks, manage wallets, query blockchain data, and execute smart contract operations through a standardized interface.
                  Last updated -
                  45
                  11
                  8
                  MIT License

                • AMOCA Solana MCP Server

                  manolaz
                  -
                  security
                  A
                  license
                  -
                  quality
                  A Model Context Protocol server that enables AI models to interact with the Solana blockchain, providing RPC methods, wallet management, DeFi trading capabilities, and Helius API integration for enhanced Solana development.
                  Last updated -
                  3
                  MIT License

                • EVM MCP Server

                  mcpdotdirect
                  A
                  security
                  A
                  license
                  A
                  quality
                  A Model Context Protocol server that enables AI agents to interact with 30+ Ethereum-compatible blockchain networks, providing services like token transfers, contract interactions, and ENS resolution through a unified interface.
                  Last updated -
                  28
                  2,922
                  307
                  MIT License

                • EVM MCP Server

                  lugondev
                  -
                  security
                  -
                  license
                  -
                  quality
                  Comprehensive Model Context Protocol server that enables AI agents to interact with 30+ Ethereum-compatible blockchain networks, supporting token transfers, smart contract interactions, and ENS name resolution through a unified interface.
                  Last updated -
                  1
                  MIT License

                View all related MCP servers

                New MCP Servers

                MCP directory API

                We provide all the information about MCP servers via our MCP API.

                curl -X GET 'https://glama.ai/api/mcp/v1/servers/amanasmuei/mcp-luno'

                If you have feedback or need assistance with the MCP directory API, please join our Discord server