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"
      ]
    }
  }
}

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

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).

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.

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

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"
    }
  }
}

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/

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

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"
      ]
    }
  }
}

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

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).

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.

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

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"
    }
  }
}

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/

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

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
5. 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