LCX Exchange MCP Server

Trade on LCX Exchange using natural language through any AI assistant. Place orders, check balances, monitor markets - works with Claude, ChatGPT, Cursor, Windsurf, GitHub Copilot, Gemini and any MCP-compatible client.

Quick Start

Claude Code

claude mcp add lcx-exchange \
  -e LCX_API_KEY=your_api_key \
  -e LCX_SECRET_KEY=your_secret_key \
  -- npx -y lcx-exchange-mcp

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "lcx-exchange": {
      "command": "npx",
      "args": ["-y", "lcx-exchange-mcp"],
      "env": {
        "LCX_API_KEY": "your_api_key",
        "LCX_SECRET_KEY": "your_secret_key"
      }
    }
  }
}

ChatGPT Desktop

ChatGPT supports MCP servers via Settings > Connectors > Advanced > Developer Mode.

Add the server with command npx -y lcx-exchange-mcp and set LCX_API_KEY and LCX_SECRET_KEY as environment variables.

Requires ChatGPT Plus, Pro, Business, Enterprise, or Education plan.

Cursor

Add to .cursor/mcp.json in your project root (or ~/.cursor/mcp.json globally):

{
  "mcpServers": {
    "lcx-exchange": {
      "command": "npx",
      "args": ["-y", "lcx-exchange-mcp"],
      "env": {
        "LCX_API_KEY": "your_api_key",
        "LCX_SECRET_KEY": "your_secret_key"
      }
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "lcx-exchange": {
      "command": "npx",
      "args": ["-y", "lcx-exchange-mcp"],
      "env": {
        "LCX_API_KEY": "your_api_key",
        "LCX_SECRET_KEY": "your_secret_key"
      }
    }
  }
}

GitHub Copilot (VS Code)

Add to .vscode/mcp.json in your workspace:

{
  "servers": {
    "lcx-exchange": {
      "command": "npx",
      "args": ["-y", "lcx-exchange-mcp"],
      "env": {
        "LCX_API_KEY": "your_api_key",
        "LCX_SECRET_KEY": "your_secret_key"
      }
    }
  }
}

Requires VS Code 1.99+ with GitHub Copilot extension.

Gemini CLI

Add to ~/.gemini/settings.json:

{
  "mcpServers": {
    "lcx-exchange": {
      "command": "npx",
      "args": ["-y", "lcx-exchange-mcp"],
      "env": {
        "LCX_API_KEY": "your_api_key",
        "LCX_SECRET_KEY": "your_secret_key"
      }
    }
  }
}

Any MCP Client

This server uses the standard stdio transport. Any MCP-compatible client can connect by running:

npx -y lcx-exchange-mcp

Set LCX_API_KEY and LCX_SECRET_KEY as environment variables for trading. Market data tools work without any keys.

Market Data Only (No API Keys Needed)

Want to explore LCX markets without trading? Skip the API keys entirely:

Claude Code:

claude mcp add lcx-exchange -- npx -y lcx-exchange-mcp

Any platform - just omit the env block from the config above.

Getting Your API Keys

1. Go to LCX Exchange
2. Navigate to Settings > API Management
3. Create a new API key
4. Save both the API Key and Secret Key (secret is shown only once)

What You Can Do

Check Markets

"What trading pairs are available on LCX?"

"What's the current price of LCX/EUR?"

"Show me the order book for BTC/USDC"

"Get 1-hour candles for ETH/EUR for the last 24 hours"

Trade

"Buy 500 LCX at 0.04 EUR"

"Place a market sell order for 100 AVAX/USDC"

"Change my LCX buy order to 0.05 EUR"

"Cancel order abc-123-def"

"Cancel all my open orders"

Manage Account

"Show my balances"

"How much ETH do I have?"

"Show my trade history for this week"

"What are my open orders?"

Available Tools (17)

Market Data (no auth required)

| Tool | Description | |------|-------------| | lcx_get_pairs | List all trading pairs | | lcx_get_pair | Get details for a specific pair | | lcx_get_tickers | Market overview for all pairs | | lcx_get_ticker | Market data for a single pair | | lcx_get_order_book | Order book (bids/asks) | | lcx_get_public_trades | Recent trade history | | lcx_get_kline | OHLCV candlestick data |

Trading (auth required)

| Tool | Description | |------|-------------| | lcx_create_order | Place LIMIT or MARKET order | | lcx_modify_order | Modify an open limit order | | lcx_cancel_order | Cancel a single order | | lcx_cancel_orders | Cancel up to 25 orders | | lcx_get_open_orders | List pending orders | | lcx_get_order | Get order details | | lcx_get_order_history | Closed/cancelled orders | | lcx_get_trade_history | Executed trade history |

Account (auth required)

| Tool | Description | |------|-------------| | lcx_get_balances | All coin balances | | lcx_get_balance | Balance for a specific coin |

Build Autonomous Trading Agents

Use the Claude Agent SDK or OpenAI Agents SDK to build bots that trade on LCX 24/7. Our MCP server plugs right in.

DCA Bot (Dollar Cost Averaging)

pip install claude-agent-sdk
python examples/dca-bot.py --pair LCX/EUR --amount 50 --interval 24h

Portfolio Rebalancer

# Rebalance to 50% BTC, 30% ETH, 20% LCX
python examples/portfolio-rebalancer.py --targets "BTC:50,ETH:30,LCX:20" --threshold 5

# Dry run first
python examples/portfolio-rebalancer.py --targets "BTC:50,ETH:30,LCX:20" --dry-run

Price Alert Bot

# Buy 0.001 BTC when price drops below 55000 EUR
python examples/price-alert-bot.py --pair BTC/EUR --condition "below:55000" --action "buy:0.001" --check 5m

# Alert only (no auto-trade)
python examples/price-alert-bot.py --pair LCX/EUR --condition "above:0.05" --action "alert" --check 1m

Agent SDK Integration

from claude_agent_sdk import query, ClaudeAgentOptions

options = ClaudeAgentOptions(
    mcp_servers={
        "lcx-exchange": {
            "command": "npx",
            "args": ["-y", "lcx-exchange-mcp"],
            "env": {
                "LCX_API_KEY": "your_key",
                "LCX_SECRET_KEY": "your_secret",
            },
        }
    },
    allowed_tools=["mcp__lcx-exchange__*"],
)

async for message in query(prompt="Buy 100 LCX at 0.03 EUR", options=options):
    print(message)

See examples/ for complete bot implementations.

Trading Skill

Copy skills/lcx-trading.md to ~/.claude/skills/ to give Claude expert knowledge of LCX trading best practices, order validation rules, and workflow templates. Works with Claude Code, Claude.ai, and other Agent Skills compatible tools.

Development

# Clone and install
git clone https://github.com/tech-lcx/LCX-Exchange-MCP.git
cd LCX-Exchange-MCP
npm install

# Build
npm run build

# Run locally
LCX_API_KEY=xxx LCX_SECRET_KEY=yyy npm start

# Development with hot reload
LCX_API_KEY=xxx LCX_SECRET_KEY=yyy npm run dev

# Test with MCP Inspector
npx @modelcontextprotocol/inspector node dist/index.js

Architecture

Any AI (Claude, ChatGPT, Cursor, Copilot, Gemini, ...)
          |
       stdio (MCP)
          |
    MCP Server (npx lcx-exchange-mcp)
          |
       HTTPS
          |
    LCX Exchange API

• Protocol: Model Context Protocol (stdio transport)
• Authentication: HMAC-SHA256 signed requests
• Rate limiting: Built-in token-bucket limiter (25 req/s market, 5 req/s trading)
• Zero external HTTP deps: Uses Node.js built-in fetch and crypto
• Graceful degradation: Market tools work without API keys

Compatibility

| Platform | Status | Config Location | |----------|--------|----------------| | Claude Code | Supported | claude mcp add | | Claude Desktop | Supported | claude_desktop_config.json | | ChatGPT Desktop | Supported | Settings > Connectors | | Cursor | Supported | .cursor/mcp.json | | Windsurf | Supported | ~/.codeium/windsurf/mcp_config.json | | GitHub Copilot | Supported | .vscode/mcp.json | | Gemini CLI | Supported | ~/.gemini/settings.json | | Any MCP Client | Supported | stdio transport |

License

MIT