Lighter MCP

What 0xDegenMo/lighter-mcp MCP server does

The 0xDegenMo/lighter-mcp MCP server connects MCP clients to Lighter, a zero-fee zk-rollup perpetual DEX on Ethereum. It exposes market discovery and data tools, account queries, and trading operations through the Model Context Protocol. Supported markets are discovered from Lighter’s order-book API rather than being hard-coded to a single asset set, allowing the server to work across the listed perpetual contracts.

The server is organized into three access levels. PUBLIC mode provides market information without credentials. READ mode adds account information after an account index is supplied. TRADE mode adds order and position actions when a private API key is also configured, unless read-only mode is enabled.

How it works

The 0xDegenMo/lighter-mcp MCP server runs locally as a Python module and communicates with an MCP client such as Claude Desktop, Cursor, Hermes, or a custom MCP application. At startup, it selects a mode from the environment variables that are present. Credentials are not needed for the public tools, while account and trading tools are only registered when their corresponding configuration is available.

Trading requests use Lighter’s API signing model. The README recommends using a sub-account API key rather than a main-wallet signing key. The key signs for that sub-account and is described as unable to withdraw funds or access the main wallet. Market orders can be sized in USDC notional, while limit orders use base-asset quantity and price. Price and size encoding is handled per market.

Setup and configuration

Install the Python package with pip install 0xdegenmo-lighter-mcp. The server can then be started with python -m lighter_mcp and added to an MCP client’s configuration. A public setup needs no Lighter account. READ mode requires LIGHTER_ACCOUNT_INDEX; trading additionally requires LIGHTER_PRIVATE_KEY, and can use LIGHTER_API_KEY_INDEX to select the API key.

The main endpoint is configured with LIGHTER_URL. Safety settings include LIGHTER_MAX_QUOTE_USD, LIGHTER_MAX_SLIPPAGE, and LIGHTER_ALLOWED_SYMBOLS. LIGHTER_READ_ONLY=true prevents trading tools from being registered, and LIGHTER_NO_INTEGRATOR=true omits integrator parameters from orders. The README advises keeping private keys out of source control and using a funded sub-account rather than a main wallet.

Tools and capabilities

The 0xDegenMo/lighter-mcp MCP server includes tools for:

• Listing markets and retrieving a specific market.
• Reading candles, tickers, order books, and funding rates.
• Checking status, signup information, and integrator approval instructions.
• Reading balances and open positions in READ mode.
• Setting leverage and placing market or limit orders in TRADE mode.
• Creating reduce-only stop-loss and take-profit orders.
• Closing positions and canceling one or all orders.

Stop-loss and take-profit orders are placed as on-chain orders and are intended to remain active across client restarts. Integrator approval is optional, can be revoked, and expires after the default period stated in the README.

Limitations and notes

Trading capability carries direct financial risk. The private key configured for the server can sign transactions for its associated Lighter sub-account, so it should be treated as a secret. The default opening-trade cap is 100 USDC, and market orders have a default 0.5% slippage limit. Reduce-only orders bypass the quote-size cap so positions can be closed or reduced.

The optional integrator fee is not required to install or use the server. It is activated only after an on-chain approval; Lighter Standard Accounts otherwise have the fee conditions described in the README. The supplied material does not state a software license for the repository.