Log inSubmit server
Lighter MCP logo

Lighter MCP

by 0xDegenMo

Trade and monitor Lighter perpetual markets through tiered MCP tools with optional account access and server-side trading limits.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Lighter MCP

Pick your client, then add it in one click or paste the config.

STDIOPython
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "0xdegenmo-lighter-mcp": {
      "command": "uvx",
      "args": [
        "0xdegenmo-lighter-mcp"
      ],
      "env": {
        "LIGHTER_URL": "YOUR_VALUE_HERE",
        "LIGHTER_ACCOUNT_INDEX": "YOUR_VALUE_HERE",
        "LIGHTER_PRIVATE_KEY": "YOUR_VALUE_HERE",
        "LIGHTER_API_KEY_INDEX": "YOUR_VALUE_HERE",
        "LIGHTER_READ_ONLY": "YOUR_VALUE_HERE",
        "LIGHTER_MAX_QUOTE_USD": "YOUR_VALUE_HERE",
        "LIGHTER_MAX_SLIPPAGE": "YOUR_VALUE_HERE",
        "LIGHTER_ALLOWED_SYMBOLS": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

uvx 0xdegenmo-lighter-mcp

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 1mo ago.

Overview

0xDegenMo/lighter-mcp MCP server exposes Lighter’s perpetual DEX through MCP tools for market data, account monitoring, and trading. It starts in PUBLIC mode without credentials, adds account tools with a sub-account index, and enables order placement when an API private key is configured. The server supports market and limit orders, leverage, position management, and on-chain stop-loss and take-profit orders. Reach for it when an MCP client needs controlled access to Lighter markets or a Lighter sub-account.

Use cases

  • Explore Lighter markets and funding data
  • Monitor a Lighter sub-account from an MCP client
  • Place capped perpetual trades through an API key
  • Set on-chain stop-loss and take-profit orders
  • Manage open positions and outstanding orders

Key features

  • Three credential-based access modes
  • Market discovery and perpetual market data
  • Market and limit order placement
  • On-chain stop-loss and take-profit orders
  • Server-side size, slippage, and symbol limits
  • Sub-account API-key signing

Tools4

What Lighter MCP lets your agent do. Expand a tool for its parameters.

Self-reported~66 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

19/20 checks healthy over the last 87d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned just now via OSV.dev · 0xdegenmo-lighter-mcp (PyPI)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars3Stargazers on the source repository.
Last commit5mo agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Tools exposed4Callable tools this server registers over MCP.
Directory activity4 viewsConfig copies, upvotes, and views on AllMCPs.

How Lighter MCP works

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.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Lighter MCP

Install the package with `pip install 0xdegenmo-lighter-mcp`, then configure the server to run with `python -m lighter_mcp`.

Yes. The README provides Claude Desktop configuration using `python` with `-m lighter_mcp`.

Yes. PUBLIC mode requires no credentials and provides market-data and discovery tools.

Set `LIGHTER_READ_ONLY=true`. In TRADE mode, this prevents order-placement tools from being registered.

Related MCP servers

All in Finance & Fintech All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewLighter MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/0xdegenmo-lighter-mcp?style=directory)](https://allmcps.com/mcp/0xdegenmo-lighter-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/0xdegenmo-lighter-mcp"><img src="https://allmcps.com/api/badge/0xdegenmo-lighter-mcp?style=directory" alt="Lighter MCP on AllMCPs" /></a>