Luno

You can connect to the Luno API through an MCP server that exposes market data, account operations, and trading functionality. This server lets you query prices, balances, orders, and transactions from Luno using MCP-compatible clients like Claude Code or VS Code, enabling powerful context-aware automation and workflows.

How to use

You will run an MCP client that talks to the Luno MCP Server. Use a supporting client to request market data such as tickers, order books, and recent trades. When you need to manage your account, create or cancel orders, or view transactions, provide your Luno API credentials through your client’s prompts and let the MCP server handle the requests securely. The server is designed to work with standard MCP clients, so you can integrate it into your existing AI-assisted development workflows, trading tools, or analytics dashboards.

To begin, ensure you have a valid Luno API key and secret from your Luno account settings. Use these credentials when prompted by your MCP client to enable authenticated endpoints such as getting balances or listing transactions.

How to install

Prerequisites You need Go 1.24 or later installed on your system. You also need a Luno account with API credentials (key and secret). Ensure Docker is available if you plan to run the Docker-based MCP configuration.

Install from source and build the MCP server:

# 1) Clone the MCP repository
# Replace this URL with the actual repository URL you are using
# git clone https://github.com/luno/luno-mcp
# cd luno-mcp

# 2) Build the binary for the MCP server
# go 1.24+ is required
go build -o luno-mcp ./cmd/server

# 3) Optional: Install system-wide
sudo mv luno-mcp /usr/local/bin/

Configuration and running the MCP server

The MCP server supports multiple ways to run locally. If you prefer running directly via a command, you can start the server using the provided binary and supply credentials through the client prompts. The following stdio-based configuration demonstrates how to run the server locally with the required environment variables.

{
  "mcp": {
    "servers": {
      "luno": {
        "command": "luno-mcp",
        "args": [],
        "env": {
          "LUNO_API_KEY_ID": "${input:luno_api_key_id}",
          "LUNO_API_SECRET": "${input:luno_api_secret}"
        },
        "inputs": [
          {"id": "luno_api_key_id", "type": "promptString", "description": "Luno API Key ID", "password": true},
          {"id": "luno_api_secret", "type": "promptString", "description": "Luno API Secret", "password": true}
        ]
      }
    }
  }
}

If you prefer running via Docker, you can use the Docker-based MCP command shown in the configuration example. This runs the MCP server inside a container and passes your API credentials as environment variables.

{
  "mcp": {
    "servers": {
      "luno-docker": {
        "command": "docker",
        "args": [
          "run", "--rm", "-i",
          "-e", "LUNO_API_KEY_ID=${input:luno_api_key_id}",
          "-e", "LUNO_API_SECRET=${input:luno_api_secret}",
          "ghcr.io/luno/luno-mcp:latest"
        ],
        "env": {
          "LUNO_API_KEY_ID": "${input:luno_api_key_id}",
          "LUNO_API_SECRET": "${input:luno_api_secret}"
        },
        "inputs": [
          {"id": "luno_api_key_id", "type": "promptString", "description": "Luno API Key ID", "password": true},
          {"id": "luno_api_secret", "type": "promptString", "description": "Luno API Secret", "password": true}
        ]
      }
    }
  }
}

Security considerations and best practices

This tool requires API credentials that grant access to your Luno account. Treat keys as sensitive data. Use keys with permissions scoped to your needs and rotate them periodically. Do not commit credentials to version control and monitor usage for any unauthorized activity.

Notes and examples

Practical usage scenarios include getting real-time market data, listing and managing orders, and reviewing transaction history. You can query ticker information, order books, candles, and trades, and you can perform trading actions by creating or cancelling orders through MCP endpoints.

Where to get credentials

Obtain your Luno API key and secret from your Luno account settings. Use these credentials to authenticate with endpoints that require authorization.

Available tools

get_ticker

Get current ticker information for a trading pair

get_tickers

List tickers for given pairs (or all)

get_order_book

Get the order book for a trading pair

list_trades

List recent trades for a currency pair

get_candles

Get candlestick market data for a currency pair

get_markets_info

List all supported markets parameter information

get_balances

Get balances for all accounts

create_order

Create a new buy or sell order

cancel_order

Cancel an existing order

list_orders

List open orders

list_transactions

List transactions for an account

get_transaction

Get details of a specific transaction