Lighter Agent MCP Server

lighter-agent

A TypeScript client and an MCP server for Lighter, the zero-knowledge perpetuals exchange, written for agents that read markets and place bounded orders.

Built by Prism. Not affiliated with, endorsed by, or operated by Lighter or elliottech.

Install

npm install lighter-agent-sdk

The MCP server runs straight from npm:

npx -y lighter-mcp

Node 20 or newer. Reading markets needs no credentials.

Hedge an H100 bill

Lighter lists market 182, H100, a perpetual on the rental cost of an NVIDIA H100. A GPU renter who is short that market gains when compute gets more expensive, which offsets the larger bill.

import { LighterRestClient, h100Snapshot, hedgeH100 } from 'lighter-agent-sdk';

const rest = new LighterRestClient({ network: 'mainnet' });

const h100 = await h100Snapshot(rest);
console.log(h100.markPrice, 'per GPU hour, funding paid by', h100.funding.paidBy);

const plan = await hedgeH100(rest, {
  gpuHours: 500,
  side: 'short',
  maxNotionalUsd: 2_000,
});

console.log(plan.hedgedGpuHours, 'hours covered, worst case', plan.worstCaseNotionalUsd, 'USD');

hedgeH100 sizes the position from GPU hours and prices it against the live book. Anything above maxNotionalUsd is refused, and dryRun defaults to true, so a mistyped call returns a plan and not a position.

Run it: node examples/hedge-h100.mjs 500.

Use it from an MCP client

{
  "mcpServers": {
    "lighter": {
      "command": "npx",
      "args": ["-y", "lighter-mcp"],
      "env": {
        "LIGHTER_NETWORK": "mainnet"
      }
    }
  }
}

That configuration is read-only. To let the agent trade, add LIGHTER_ACCOUNT_INDEX, LIGHTER_API_KEY_INDEX, LIGHTER_API_KEY_PRIVATE_KEY, and LIGHTER_MAX_NOTIONAL_USD. The last one is a per-order ceiling with no default, so orders stay refused until you choose a number.

Nine tools:

There is no transfer tool and no change-pubkey tool. Neither the SDK nor the server exposes a path to move balance off the account.

Why this exists

Lighter has no official TypeScript SDK and no registered MCP server, so an agent that wants to trade there starts by reimplementing Schnorr signatures over ECgFp5 and the transaction encoding behind them. It also lists an H100 perpetual, which makes the price of GPU time a tradable instrument rather than a quote in a rental agreement. Prism rents H100s, so hedging that price was the first thing we wanted an agent to do without a human in the loop.

Limitations

• The H100 book is thin. Measured on 2026-08-26, it traded about $7,100 over 24 hours, held open interest near $10,000, and showed 4.00 of size at the top of book on each side, with a minimum order of 2.00. Treat it as an early instrument and size to the book.
• A Lighter API key is full write authority over the account it is bound to, with no spend cap of its own. Run the agent on a dedicated sub-account funded with only what it may lose.
• Lighter's WebSocket stream is blocked from some hosts, Render among them. REST polling is a first-class path in the SDK for that reason.
• The Standard rate tier allows 60 requests per minute. The MCP server caches the market list for 30 seconds so repeat lookups do not spend that budget.

Packages

Development

npm install
npm run build
npm test
node scripts/live-check.mjs   # read-only, hits mainnet

Tests run against fixtures and never open a socket. The live check is the only script that talks to the exchange.

License

Apache-2.0. See LICENSE and NOTICE. The signer is the official WebAssembly build from elliottech/lighter-go, vendored unmodified with its provenance recorded in vendor/wasm/PROVENANCE.md.