This server integrates with the Luno cryptocurrency exchange via the Model Context Protocol, allowing AI assistants (like Claude Code, VS Code, Cursor, and Windsurf) to query market data, manage accounts, and execute trades.
Market Data (no auth required):
get_ticker/get_tickers– latest prices, best bid/ask, and 24h volume for one or all trading pairsget_order_book– top 100 bids and asks to assess liquidity and slippagelist_trades– recent public trades with price, volume, side, and timestampget_candles– OHLCV candlestick data for charting or backtestingget_markets_info– all supported markets and their trading parameters (min/max volume, tick sizes, fee tiers, etc.)
Account Information (API key required):
get_balances– available, reserved, and unconfirmed amounts across all accountslist_transactions/get_transaction– paginated ledger entries and full transaction detailslist_orders– view open orders
Trading (API key required + explicit opt-in):
create_order– place a GTC limit buy or sell ordercancel_order– cancel an existing working order by IDconvert– instantly convert funds between two currency accounts
Security: Write operations (create_order, cancel_order, convert) are disabled by default and must be explicitly enabled via ALLOW_WRITE_OPERATIONS=true or the --allow-write-operations flag. Supports Docker, Homebrew, and source builds.
Provides access to cryptocurrency trading data and functionality through the Luno exchange, including viewing wallet balances, creating buy/sell orders, checking prices, and viewing transaction history for Bitcoin and other cryptocurrencies.
Enables running the MCP server in a containerized environment, with configuration options for passing API credentials and environment variables to the Docker container.
Supports loading API credentials and configuration options from environment variables or .env files for local development and testing.
Provides integration with GitHub for issue tracking, repository access, and package distribution through GitHub Container Registry (ghcr.io).
Integrates with SonarCloud for code quality metrics, displaying badges for quality gate status, coverage, bugs, security rating, vulnerabilities, and duplicated lines.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Luno MCP Serverget my current account balances"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Luno MCP Server
👁 Quality Gate Status
👁 Coverage
👁 Bugs
👁 Security Rating
👁 Vulnerabilities
👁 Duplicated Lines (%)
👁 Go Report Card
👁 GoDoc
👁 luno-mcp 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:latestOr 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-mcpOne-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> shOr 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@latestOr clone and build:
git clone https://github.com/luno/luno-mcp
cd luno-mcp
go build -o luno-mcp ./cmd/serverOptionally 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-mcpThen 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-mcpUse 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:latestFor 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:8080Optional environment variables:
LUNO_API_DEBUG=true— Enable debug loggingLUNO_API_DOMAIN=api.staging.luno.com— Override API domainALLOW_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:latestOr 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-mcpOne-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> shOr 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@latestOr clone and build:
git clone https://github.com/luno/luno-mcp
cd luno-mcp
go build -o luno-mcp ./cmd/serverOptionally 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:latestFor 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:8080Optional environment variables:
LUNO_API_DEBUG=true— Enable debug loggingLUNO_API_DOMAIN=api.staging.luno.com— Override API domainALLOW_WRITE_OPERATIONS=true— Enable write operations (create_order,cancel_order,convert)
Related MCP server: OKX MCP Server
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 |
| Market Data | Get current ticker information for a trading pair | ❌ | ❌ |
| Market Data | List tickers for given pairs (or all) | ❌ | ❌ |
| Market Data | Get the order book for a trading pair | ❌ | ❌ |
| Market Data | List recent trades for a currency pair | ❌ | ❌ |
| Market Data | Get candlestick market data for a currency pair | ❌ | ❌ |
| Market Data | List all supported markets parameter information | ❌ | ❌ |
| Account Information | Get balances for all accounts | ✅ | ❌ |
| Trading | Create a new buy or sell order | ✅ | ✅ |
| Trading | Cancel an existing order | ✅ | ✅ |
| Trading | List open orders | ✅ | ❌ |
| Transactions | List transactions for an account | ✅ | ❌ |
| Transactions | Get details of a specific transaction | ✅ | ❌ |
| Trading | Instantly convert between two currencies | ✅ | ✅ |
Command-line options
--transport: Transport type (stdio,sse, orstreamable-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 viaALLOW_WRITE_OPERATIONSenv 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 ZARTransaction history
You can ask your LLM to show your transaction history:
Show me my recent Bitcoin transactionsMarket Data
You can ask your LLM to show market data:
Show me recent trades for XBTZARWhat'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
.envfiles are always in your.gitignoreRotate 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
Maintenance
Latest Blog Posts
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