Lighter MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| LIGHTER_URL | No | API base URL | mainnet |
| LIGHTER_READ_ONLY | No | If 'true', disables order-placement tools | |
| LIGHTER_PRIVATE_KEY | No | API-key private key for TRADE mode | |
| LIGHTER_MAX_SLIPPAGE | No | Max slippage fraction on market orders | 0.005 |
| LIGHTER_ACCOUNT_INDEX | No | Sub-account index for READ+ mode | |
| LIGHTER_API_KEY_INDEX | No | Index of the API key | 2 |
| LIGHTER_MAX_QUOTE_USD | No | Cap on opening trade size in USDC | 100 |
| LIGHTER_MCP_LOG_LEVEL | No | Log level on stderr | INFO |
| LIGHTER_NO_INTEGRATOR | No | If 'true', strips integrator params entirely | |
| LIGHTER_ALLOWED_SYMBOLS | No | Comma-separated symbol allowlist | |
| LIGHTER_INTEGRATOR_MAKER_FEE | No | Override maker fee (raw int) | 100 |
| LIGHTER_INTEGRATOR_TAKER_FEE | No | Override taker fee (raw int) | 200 |
| LIGHTER_INTEGRATOR_ACCOUNT_INDEX | No | Override integrator account (forks) | 725426 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| how_to_approve_integratorA | How to opt in to sending integrator fees to the lighter-mcp maintainer. Use this if a user asks how to support the project, how integrator attribution works in practice, or how to make fees actually flow. Returns instructions for both the browser-based flow (recommended — wallet UI handles the L1 signature, no private key exposure) and the CLI fallback for power users. No call is made to Lighter from this tool. |
| get_statusA | Server diagnostics: current mode, safety policy, and integrator attribution. Reveals no secrets — safe to call from any client. Use this to verify:
Anyone curious about fees should call this tool — it's the authoritative answer. |
| list_marketsA | List all tradeable perpetual markets on Lighter. Returns symbol, market_index, min_base_amount, min_quote_amount, price_tick, size_tick, max_leverage for each market. |
| get_marketA | Get metadata for a single market by symbol (e.g. 'HYPE', 'ETH'). Returns None if the symbol is not listed. |
| get_candlesA | OHLCV candles for a market. Args: symbol: e.g. 'HYPE', 'ETH' interval: minutes per candle — 1, 5, 15, 60, 240, or 1440 (1d) limit: number of candles back from now (max ~500) |
| get_tickerB | Current best bid / best ask / last price for a market. |
| get_orderbookC | Top-N order book levels. Returns {"bids": [[price, size], ...], "asks": [[price, size], ...]}. |
| get_funding_rateB | Current funding rate and next funding timestamp for a perp market. Funding occurs every 8h. Positive rate = longs pay shorts. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 8 tools
Each tool targets a distinct piece of information or action: candles, funding rate, market metadata, order book, server status, ticker, integrator instructions, and market listing. No two tools have overlapping responsibilities.
Most tools follow a 'get_' prefix, but 'list_markets' uses 'list_' and 'how_to_approve_integrator' is a descriptive phrase rather than a standard verb-noun pattern. This mix of conventions reduces consistency.
With 8 tools, the set feels appropriately scoped for a market data and server information provider. It is neither too sparse nor bloated for its apparent purpose.
The server covers market data retrieval well (candles, orderbook, ticker, funding rate) and adds list/meta tools, but lacks any trading or account management tools. Given the 'TRADE' tier mentioned in get_status, this gap is notable.