luno-mcp

Getting started

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

<img src="https://img.shields.io/badge/VS_Code-VS_Code?style=flat-square&label=Install%20Server&color=0098FF" alt="Install in VS Code"> <img alt="Install in VS Code Insiders" src="https://img.shields.io/badge/VS_Code_Insiders-VS_Code_Insiders?style=flat-square&label=Install%20Server&color=24bfa5"> <img src="https://cursor.com/deeplink/mcp-install-dark.svg" alt="Install in Cursor">

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

<details> <summary>Claude Code</summary>

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

</details>

<details> <summary>Claude Desktop</summary>

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

</details>

<details> <summary>Cursor</summary>

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.

</details>

<details> <summary>Windsurf</summary>

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

</details>

<details> <summary>VS Code (manual configuration)</summary>

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

Examples

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

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