Luno MCP

🚀 Luno MCP Server

A Model Context Protocol (MCP) server that provides access to the Luno cryptocurrency exchange API. It enables integration with VS Code's Copilot and other MCP-compatible clients, offering contextual information and functionality related to the Luno cryptocurrency exchange.

🚀 Quick Start

The Luno MCP Server provides access to the Luno cryptocurrency exchange API and can be integrated with MCP - compatible clients like VS Code's Copilot. Before you start, make sure you have a Luno account with API key and secret, and Go 1.24 or later installed.

✨ Features

• Resources: Access account balances, transaction history, and more.
• Tools: Create and manage orders, check prices, and view transaction details.
• Security: Secure authentication using Luno API keys.
• VS Code Integration: Easily integrate with VS Code's Copilot features.

⚠️ Important Note

This project is currently in beta phase. While we've made every effort to ensure stability and reliability, you may encounter unexpected behavior or limitations. Please use it with care and consider the following:

• This MCP server config may change without prior notice.
• Performance and reliability might not be optimal.
• Not all Luno API endpoints are implemented yet.

We welcome feedback and bug reports to help improve the project. Please report any issues you encounter via the GitHub issue tracker.

📦 Installation

Prerequisites

• Go 1.24 or later
• Luno account with API key and secret

Building from Source

1. Clone the repository:

git clone https://github.com/luno/luno-mcp
cd luno-mcp

2. Build the binary:

go build -o luno-mcp ./cmd/server

3. Make it available system - wide (optional):

sudo mv luno-mcp /usr/local/bin/

💻 Usage Examples

Setting up credentials

The server requires your Luno API key and secret. These can be obtained from your Luno account settings, see here for more info: https://www.luno.com/developers.

Command - line options

• --transport: Transport type (stdio or sse, default: stdio)
• --sse-address: Address for SSE transport (default: localhost:8080)
• --domain: Luno API domain (default: api.luno.com)
• --log-level: Log level (debug, info, warn, error, default: info)

Basic Usage

Working with wallets

You can ask Copilot to show your wallet balances:

What are my current wallet balances on Luno?

Trading

You can ask Copilot to help you trade:

Create a limit order to buy 0.001 BTC at 50000 ZAR

Transaction history

You can ask Copilot to show your transaction history:

Show me my recent Bitcoin transactions

Market Data

You can ask Copilot to show market data:

Show me recent trades for XBTZAR

What's the latest price for Bitcoin in ZAR?

Advanced Usage

VS Code Integration

To integrate with VS Code, add the following to your settings.json file (or click on the badge at the top of this README for the docker config).

With Docker

This configuration will make VS Code run the Docker container. Ensure Docker is running on your system.

"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}",
        // Optional: Pass LUNO_API_DEBUG=true
        // "-e", "LUNO_API_DEBUG=true",
        "ghcr.io/luno/luno-mcp:latest"
        // Optional: Pass additional arguments to luno-mcp
        // "--log-level", "debug"
      ],
      "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}
      ]
    }
  }
}

Building from source

As well as adding one of these config options, you'll need to follow the "Build from source" instructions below.

For stdio transport

"mcp": {
  "servers": {
    "luno": {
      "command": "luno-mcp",
      "args": [],
      "env": {
        "LUNO_API_KEY_ID": "${env:LUNO_API_KEY_ID}",
        "LUNO_API_SECRET": "${env:LUNO_API_SECRET}"
      }
    }
  }
}

For SSE transport

"mcp": {
  "servers": {
    "luno": {
      "type": "sse",
      "url": "http://localhost:8080/sse"
    }
  }
}

📚 Documentation

Available Tools

🔧 Technical Details

Testing

The project includes both unit tests and integration tests. Unit tests can be run without any credentials, while integration tests require Luno API credentials.

# Run unit tests only
go test -v ./... -short

# Run integration tests (requires API credentials)
go test -v ./internal/tests -run "Integration" -skip=""

GitHub Actions

This repository is configured with GitHub Actions for continuous integration testing:

1. Unit Tests: Automatically run on all push events and pull requests to the main branch.
2. Integration Tests: Can be run manually using the "Manual Integration Tests" workflow in the GitHub Actions tab.

For integration tests to work in GitHub Actions, you need to set up the following secrets in your repository:

• LUNO_API_KEY: Your Luno API key
• LUNO_API_SECRET: Your Luno API secret
• RUN_INTEGRATION_TESTS: Set to any non - empty value to enable integration tests on the main branch

The integration tests are set up to run only when explicitly triggered or on the main branch when configured.

Contributing

If you'd like to contribute to the development of this project, please see the CONTRIBUTING.md file for guidelines.

📄 License

MIT License