Luno MCP Server

Name: Luno MCP Server
Author: luno

Local

github.com/lunoFinance28Updated 5w ago

Repository

About Luno MCP Server

Luno MCP Server is an MCP server for the Luno cryptocurrency exchange API. It targets users of Claude Code, VS Code, Cursor and other MCP clients who want market data, balances and transaction history, with trading write operations available only when enabled.

Key features

01Ticker, order book, trade and candle market data
02Account balances and transaction details
03Order creation, cancellation and conversion when enabled
04Read-only by default; writes require explicit opt-in
05Supports stdio and SSE transports

Use cases

01Checking the current price of Bitcoin in ZAR
02Reviewing Luno account balances and transaction history
03Viewing market data inside an AI coding or chat client

MCP support

The server runs as an MCP server and exposes exchange market, account and transaction functions to MCP clients as tools and resources.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config

{
  "mcpServers": {
    "luno": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "\\"
      ]
    }
  }
}

Run commanddocker run -i --rm '\'

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages

oci\stdio

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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.

Getting started

Some tools require your Luno API key and secret. Get these from your Luno account settings.

Standard config (Docker) works with most MCP clients:

{
  "mcpServers": {
    "luno": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "LUNO_API_KEY_ID=YOUR_API_KEY_ID",
        "-e", "LUNO_API_SECRET=YOUR_API_SECRET",
        "ghcr.io/luno/luno-mcp:latest"
      ]
    }
  }
}

Claude Code

Using Docker:

claude mcp add luno -- docker run --rm -i -e LUNO_API_KEY_ID=YOUR_API_KEY_ID -e LUNO_API_SECRET=YOUR_API_SECRET ghcr.io/luno/luno-mcp:latest

Or if you've built from source:

claude mcp add luno -e LUNO_API_KEY_ID=YOUR_API_KEY_ID -e LUNO_API_SECRET=YOUR_API_SECRET -- luno-mcp

Claude Desktop

One-line install and configure (macOS):

curl -fsSL https://raw.githubusercontent.com/luno/luno-mcp/main/claude-desktop-install.sh | \
  LUNO_API_KEY_ID=<key> LUNO_API_SECRET=<secret> sh

Or add the standard config to your claude_desktop_config.json manually (setup guide).

Cursor

Go to Cursor Settings → MCP → Add new MCP Server. Use command type with command docker and the args from the standard config above.

Or add the standard config to your .cursor/mcp.json.

Windsurf

Follow the Windsurf MCP documentation. Use the standard config above.

VS Code (manual configuration)

Click the badges above for one-click Docker install, or add the following to your VS Code settings.json or .vscode/mcp.json:

With Docker

{
  "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}
  ],
  "servers": {
    "luno": {
      "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"
      ]
    }
  }
}

From source

{
  "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}
  ],
  "servers": {
    "luno": {
      "command": "luno-mcp",
      "env": {
        "LUNO_API_KEY_ID": "${input:luno_api_key_id}",
        "LUNO_API_SECRET": "${input:luno_api_secret}"
      }
    }
  }
}

SSE transport

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

Building from source

Requires Go 1.25 or later.

Install directly:

go install github.com/luno/luno-mcp/cmd/server@latest

Or clone and build:

git clone https://github.com/luno/luno-mcp
cd luno-mcp
go build -o luno-mcp ./cmd/server

Optionally make it available system-wide:

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

Homebrew (macOS)

Install via Homebrew using the luno/homebrew-luno-mcp tap:

brew tap luno/luno-mcp
brew install luno-mcp

Then configure your MCP client:

{
  "mcpServers": {
    "luno": {
      "command": "luno-mcp",
      "args": ["--transport", "stdio"],
      "env": {
        "LUNO_API_KEY_ID": "YOUR_API_KEY_ID",
        "LUNO_API_SECRET": "YOUR_API_SECRET"
      }
    }
  }
}

Or with Claude Code:

claude mcp add luno -e LUNO_API_KEY_ID=YOUR_API_KEY_ID -e LUNO_API_SECRET=YOUR_API_SECRET -- luno-mcp

Docker

Use the standard config above, or run directly:

docker run --rm -i \
  -e LUNO_API_KEY_ID=YOUR_API_KEY_ID \
  -e LUNO_API_SECRET=YOUR_API_SECRET \
  ghcr.io/luno/luno-mcp:latest

For SSE mode:

docker run --rm \
  -e LUNO_API_KEY_ID=YOUR_API_KEY_ID \
  -e LUNO_API_SECRET=YOUR_API_SECRET \
  -p 8080:8080 \
  ghcr.io/luno/luno-mcp:latest \
  --transport sse --sse-address 0.0.0.0:8080

Optional environment variables:

LUNO_API_DEBUG=true — Enable debug logging
LUNO_API_DOMAIN=api.staging.luno.com — Override API domain
ALLOW_WRITE_OPERATIONS=true — Enable write operations (create_order, cancel_order, convert)

Standard config (Docker) works with most MCP clients:

{
  "mcpServers": {
    "luno": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "LUNO_API_KEY_ID=YOUR_API_KEY_ID",
        "-e", "LUNO_API_SECRET=YOUR_API_SECRET",
        "ghcr.io/luno/luno-mcp:latest"
      ]
    }
  }
}

Claude Code

Using Docker:

claude mcp add luno -- docker run --rm -i -e LUNO_API_KEY_ID=YOUR_API_KEY_ID -e LUNO_API_SECRET=YOUR_API_SECRET ghcr.io/luno/luno-mcp:latest

Or if you've built from source:

claude mcp add luno -e LUNO_API_KEY_ID=YOUR_API_KEY_ID -e LUNO_API_SECRET=YOUR_API_SECRET -- luno-mcp

Claude Desktop

One-line install and configure (macOS):

curl -fsSL https://raw.githubusercontent.com/luno/luno-mcp/main/claude-desktop-install.sh | \
  LUNO_API_KEY_ID=<key> LUNO_API_SECRET=<secret> sh

Or add the standard config to your claude_desktop_config.json manually (setup guide).

Cursor

Go to Cursor Settings → MCP → Add new MCP Server. Use command type with command docker and the args from the standard config above.

Or add the standard config to your .cursor/mcp.json.

Windsurf

Follow the Windsurf MCP documentation. Use the standard config above.

VS Code (manual configuration)

Click the badge above for one-click Docker install, or add the following to your VS Code settings.json or .vscode/mcp.json:

With Docker

{
  "servers": {
    "luno": {
      "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"
      ],
      "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}
      ]
    }
  }
}

From source

{
  "servers": {
    "luno": {
      "command": "luno-mcp",
      "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}
      ]
    }
  }
}

SSE transport

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

Building from source

Requires Go 1.25 or later.

Install directly:

go install github.com/luno/luno-mcp/cmd/server@latest

Or clone and build:

git clone https://github.com/luno/luno-mcp
cd luno-mcp
go build -o luno-mcp ./cmd/server

Optionally make it available system-wide:

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

Docker

Use the standard config above, or run directly:

docker run --rm -i \
  -e LUNO_API_KEY_ID=YOUR_API_KEY_ID \
  -e LUNO_API_SECRET=YOUR_API_SECRET \
  ghcr.io/luno/luno-mcp:latest

For SSE mode:

docker run --rm \
  -e LUNO_API_KEY_ID=YOUR_API_KEY_ID \
  -e LUNO_API_SECRET=YOUR_API_SECRET \
  -p 8080:8080 \
  ghcr.io/luno/luno-mcp:latest \
  --transport sse --sse-address 0.0.0.0:8080

Optional environment variables:

LUNO_API_DEBUG=true — Enable debug logging
LUNO_API_DOMAIN=api.staging.luno.com — Override API domain
ALLOW_WRITE_OPERATIONS=true — Enable write operations (create_order, cancel_order, convert)

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

Available Tools

Tool	Category	Description	Auth Required	Write
`get_ticker`	Market Data	Get current ticker information for a trading pair	❌	❌
`get_tickers`	Market Data	List tickers for given pairs (or all)	❌	❌
`get_order_book`	Market Data	Get the order book for a trading pair	❌	❌
`list_trades`	Market Data	List recent trades for a currency pair	❌	❌
`get_candles`	Market Data	Get candlestick market data for a currency pair	❌	❌
`get_markets_info`	Market Data	List all supported markets parameter information	❌	❌
`get_balances`	Account Information	Get balances for all accounts	✅	❌
`create_order`	Trading	Create a new buy or sell order	✅	✅
`cancel_order`	Trading	Cancel an existing order	✅	✅
`list_orders`	Trading	List open orders	✅	❌
`list_transactions`	Transactions	List transactions for an account	✅	❌
`get_transaction`	Transactions	Get details of a specific transaction	✅	❌
`convert`	Trading	Instantly convert between two currencies	✅	✅

Command-line options

--transport: Transport type (stdio, sse, or streamable-http; default: stdio)
--sse-address: Address for SSE and Streamable HTTP transports (default: localhost:8080)
--domain: Luno API domain (default: api.luno.com)
--log-level: Log level (debug, info, warn, error, default: info)
--allow-write-operations: Enable write operations (create_order, cancel_order, convert). Also configurable via ALLOW_WRITE_OPERATIONS env var

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?

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.

Write Operations Control

By default, the MCP server runs in read-only mode — create_order, cancel_order, and convert are not exposed. To enable them, set ALLOW_WRITE_OPERATIONS to true, 1, or yes. See the config examples above for where to add this flag.

Best Practices for API Credentials

Create Limited-Permission API Keys: Only grant the permissions absolutely necessary for your use case
Never Commit Credentials to Version Control: Ensure .env files are always in your .gitignore
Rotate API Keys Regularly: Periodically regenerate your API keys to limit the impact of potential leaks
Monitor API Usage: Regularly check your Luno account for any unauthorized activity
Use Read-Only Mode by Default: Only enable write operations when specifically needed

Contributing

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

License

MIT License

Comments

Markdown supported

Details

License: MIT
Author: luno
Language: go
Transports: stdio
Listed on: Jun 1, 2025
Last updated: 5w ago

Report

Similar servers

Finance

CCXT

ccxt.com

44.6k

Official CCXT MCP server for market data and trading across 100+ exchanges and prediction markets

basebalance.cloud — x402 RPC & MCP gateway

basebalance.cloud

7.6k

USDC-gated Base JSON-RPC: free 10 req/min, $0.50 per 10k. Failover, cache, /mcp, ledger

Tradingview Mcp Server

tradingmcp.ai

5.2k

TradingMCP puts a market analyst inside your AI assistant. Paste one URL into Claude, ChatGPT, Cursor, VS Code or any MCP client and ask in plain language: screen for breakouts, run a multi-timeframe analysis, backtest a

EdgarTools

github.com/dgunning

2.8k

Open-source SEC EDGAR toolkit. 11 tools and 7 research prompts covering every major filing type — 10-K, 10-Q, 8-K, Form 4 insider trades, 13F institutional holdings, Form D private placements, Form ADV investment advisers, DEF 14A proxy statements, SC 13D/G ownership, and NPORT.

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

Read the getting-started guide

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.

Luno MCP Server

About Luno MCP Server

Key features

Use cases

MCP support

Configuration

Tools

Details

Luno MCP Server

Getting started

With Docker

From source

SSE transport

With Docker

From source

SSE transport

Features

Available Tools

Command-line options

Examples

Working with wallets

Trading

Transaction history

Market Data

Security Considerations

Write Operations Control

Best Practices for API Credentials

Contributing

License

Comments

New to MCP?

What is MCP (Model Context Protocol)?

How do MCP servers differ from clients?

Should I use a local or a remote server?

How do I install a server in Claude, Cursor and others?

Are listed projects reviewed? What does “Verified” mean?

My project is listed. How do I claim it?