Skip to main content
Glama

Luno MCP Server

Official
by luno
GitHub
Go
MIT License
10
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Luno MCP Server

A Model Context Protocol (MCP) server that provides access to the Luno cryptocurrency exchange API.

This server enables integration with Claude Code/VSCode/Cursor (and other MCP-compatible clients), providing contextual information and functionality related to the Luno cryptocurrency exchange.

⚠️ Beta Warning

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.

Features

  • Resources: Access to account balances, transaction history, and more
  • Tools: Functionality for creating and managing orders, checking prices, and viewing transaction details
  • Security: Secure authentication using Luno API keys
  • VS Code Integration: Easy integration with VSCode, or other AI IDEs

Usage

Setting up credentials

The server may require your Luno API key and secret for certain endpoints. 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)

Available Tools

ToolCategoryAuth RequiredDescription
get_tickerMarket DataNoGet current ticker information for a trading pair
get_tickersMarket DataNoList tickers for given pairs (or all)
get_order_bookMarket DataNoGet the order book for a trading pair
list_tradesMarket DataNoList recent trades for a currency pair
get_candlesMarket DataNoGet candlestick market data for a currency pair
get_markets_infoMarket DataNoList all supported markets parameter information
get_balancesAccount InformationYesGet balances for all accounts
create_orderTradingYesCreate a new buy or sell order
cancel_orderTradingYesCancel an existing order
list_ordersTradingYesList open orders
list_transactionsTransactionsYesList transactions for an account
get_transactionTransactionsYesGet details of a specific transaction

Examples

Working with wallets

You can ask your LLM to show your wallet balances:

What are my current wallet balances on Luno?

Trading

You can ask your LLM to help you trade:

Create a limit order to buy 0.001 BTC at 50000 ZAR

Transaction history

You can ask your LLM to show your transaction history:

Show me my recent Bitcoin transactions

Market Data

You can ask your LLM to show market data:

Show me recent trades for XBTZAR
What's the latest price for Bitcoin in ZAR?

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.

{ "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: Add debug info // "-e", "LUNO_API_DEBUG=true", // Optional: Override default API domain // "-e", "LUNO_API_DOMAIN=api.staging.luno.com", "ghcr.io/luno/luno-mcp:latest" ], "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

For MCP client usage: Add one of the config options below to your VS Code settings.json or mcp.json file. The credentials will be provided through VS Code's input prompts.

For direct development: You'll also need to set up environment variables or a .env file as described in the CONTRIBUTING.md file.

For stdio transport
"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} ] } } }
For SSE transport
"mcp": { "servers": { "luno": { "type": "sse", "url": "http://localhost:8080/sse" } } }

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/

Note: When using with MCP clients like VS Code, credentials are provided through the client's input system. For direct development and testing, see the credential setup instructions in CONTRIBUTING.md.

Security Considerations

This tool requires API credentials that have access to your Luno account. Be cautious when using API keys, especially ones with withdrawal permissions. It's recommended to create API keys with only the permissions needed for your specific use case.

Best Practices for API Credentials

  1. Create Limited-Permission API Keys: Only grant the permissions absolutely necessary for your use case
  2. Never Commit Credentials to Version Control: Ensure .env files are always in your .gitignore
  3. Rotate API Keys Regularly: Periodically regenerate your API keys to limit the impact of potential leaks
  4. Monitor API Usage: Regularly check your Luno account for any unauthorized activity

Contributing

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

License

MIT License

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

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.

Tools

View all tools

MCP Server for the Luno Cryptocurrency API, allowing trades to be made, orders and balances to be accessed

  1. ⚠️ Beta Warning
    1. Features
      1. Usage
        1. Setting up credentials
        2. Command-line options
      2. Available Tools
        1. Examples
          1. Working with wallets
          2. Trading
          3. Transaction history
          4. Market Data
        2. VS Code Integration
          1. With Docker
          2. Building from source
        3. Installation
          1. Prerequisites
          2. Building from Source
        4. Security Considerations
          1. Best Practices for API Credentials
          2. Contributing
        5. License

          Related MCP Servers

          • OKX MCP Server

            esshka
            A
            security
            F
            license
            A
            quality
            Provides real-time cryptocurrency price data from OKX exchange through a Model Context Protocol interface, allowing access to historical candlestick data and current market prices for any trading instrument.
            Last updated -
            2
            2
            JavaScript
            • Apple

          • Upbit MCP Server

            solangii
            -
            security
            A
            license
            -
            quality
            Interact with Upbit cryptocurrency exchange services to retrieve market data, manage accounts, and execute trades. Simplify your trading experience with tools for order management, deposits, withdrawals, and technical analysis.
            Last updated -
            6
            Python
            MIT License
            • Apple

          • coin-mcp-server

            pwh-pwh
            -
            security
            A
            license
            -
            quality
            use Bitget’s API to get cryptocurrency info
            Last updated -
            18
            TypeScript
            MIT License

          View all related MCP servers

          Appeared in Searches

          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/luno/luno-mcp'

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