home / mcp / luno mcp server

Luno MCP Server

mcp server for luno

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "amanasmuei-mcp-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"
      ],
      "env": {
        "LUNO_API_KEY": "YOUR_API_KEY",
        "LUNO_API_SECRET": "YOUR_API_SECRET"
      }
    }
  }
}

You are deploying a modern MCP server that provides real-time prices, historical data, and trading-related capabilities for the Luno cryptocurrency exchange. Built on FastMCP 2.0 and Python 3.12, this server lets you query live prices, historical OHLC data, price ranges, and manage your accounts and orders through a consistent MCP interface.

How to use

To use the Luno MCP server, run the local MCP process in your environment and connect your MCP client to the local stdio endpoint. The server exposes a set of public and private tools you can invoke through your client to fetch prices, market data, and OHLC charts, as well as to manage accounts and orders when you provide valid credentials.

How to install

Prerequisites: Python 3.12 installed on your system. A Python virtual environment is recommended to isolate dependencies.

1. Create and activate a virtual environment.

python -m venv venv
source venv/bin/activate

2. Install dependencies. The necessary packages are already prepared in the environment.

3. Run the MCP server using the stdio configuration shown in the next section.

Configuration and run details

Configure the MCP server for your environment by setting up the Local Python runtime and the required environment variables for access to the Luno API.

Use the following MCP client configuration to connect Claude Desktop (or your MCP client) to the local server. This is the stdio-based entry that runs the Python interpreter and the server script inside your virtual environment.

{
  "mcpServers": {
    "luno": {
      "command": "/Users/you/your_project/venv/bin/python",
      "args": [
        "/Users/you/your_project/src/luno_mcp_server/server.py"
      ],
      "cwd": "/Users/you/your_project",
      "env": {
        "LUNO_API_KEY": "your_api_key_here",
        "LUNO_API_SECRET": "your_api_secret_here"
      }
    }
  }
}

Testing basic usage

After starting the server, you can ask your MCP client for price data, market overviews, and historical prices. Try queries like: get real-time price for a trading pair, fetch a 1-hour OHLC dataset, or retrieve the price range over the last 7 days. If you have a private account, you can also retrieve your balance and manage orders through the provided tools.

Security and operational notes

- API credentials are provided via environment variables and are not logged. - Communications use HTTPS for remote endpoints when applicable. - The server runs inside a Python virtual environment to isolate dependencies and minimize conflicts.

Troubleshooting

If you encounter issues, verify that you are using the active virtual environment, confirm that your LUNO_API_KEY and LUNO_API_SECRET are set, and check the server logs for any import or connection errors. You can also run the server directly to isolate issues: python src/luno_mcp_server/server.py.

Available tools

get_crypto_price

Fetch real-time prices for any trading pair.

get_market_overview

Retrieve market data and available trading pairs.

get_historical_prices

Obtain OHLC candlestick data for a trading pair over a specified period.

get_price_range

Analyze price movements and statistics over a defined window (1-30 days).

get_account_balance

Retrieve your account balances for private operations.

place_order

Place buy or sell orders on the exchange.

cancel_order

Cancel a previously placed order.

get_order_status

Check the status of a specific order.

get_transaction_history

View your past transactions on the exchange.

get_fees

Query trading fees applied to your account.