Skip to content
MCP server

Lighter MCP

Read Lighter perpetual markets and place guarded orders, including the H100…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.1.1
Listing updated
4 days ago

About Lighter MCP

Lighter MCP is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Read Lighter perpetual markets and place guarded orders, including the H100 compute-price market.

Install

Run in a terminal

claude mcp add lighter-mcp --env LIGHTER_API_KEY_PRIVATE_KEY='<LIGHTER_API_KEY_PRIVATE_KEY>' --env LIGHTER_READ_ONLY_TOKEN='<LIGHTER_READ_ONLY_TOKEN>' -- npx -y lighter-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "lighter-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "lighter-mcp"
      ],
      "env": {
        "LIGHTER_API_KEY_PRIVATE_KEY": "<LIGHTER_API_KEY_PRIVATE_KEY>",
        "LIGHTER_READ_ONLY_TOKEN": "<LIGHTER_READ_ONLY_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "lighter-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "lighter-mcp"
      ],
      "env": {
        "LIGHTER_API_KEY_PRIVATE_KEY": "<LIGHTER_API_KEY_PRIVATE_KEY>",
        "LIGHTER_READ_ONLY_TOKEN": "<LIGHTER_READ_ONLY_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "lighter-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "lighter-mcp"
      ],
      "env": {
        "LIGHTER_API_KEY_PRIVATE_KEY": "<LIGHTER_API_KEY_PRIVATE_KEY>",
        "LIGHTER_READ_ONLY_TOKEN": "<LIGHTER_READ_ONLY_TOKEN>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "lighter-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "lighter-mcp"
      ],
      "env": {
        "LIGHTER_API_KEY_PRIVATE_KEY": "<LIGHTER_API_KEY_PRIVATE_KEY>",
        "LIGHTER_READ_ONLY_TOKEN": "<LIGHTER_READ_ONLY_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "lighter-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "lighter-mcp"
      ],
      "env": {
        "LIGHTER_API_KEY_PRIVATE_KEY": "<LIGHTER_API_KEY_PRIVATE_KEY>",
        "LIGHTER_READ_ONLY_TOKEN": "<LIGHTER_READ_ONLY_TOKEN>"
      }
    }
  }
}

Configuration

  • LIGHTER_NETWORKDeployment to read: mainnet, testnet, or robinhood. Defaults to mainnet.
  • LIGHTER_ACCOUNT_INDEXSub-account the agent trades from. Read-only tools work without it.
  • LIGHTER_API_KEY_INDEXAPI key slot bound to the sub-account, 0 to 254.
  • LIGHTER_API_KEY_PRIVATE_KEYAPI key private key. Full write authority over the account it is bound to, so use a dedicated sub-account.
  • LIGHTER_MAX_NOTIONAL_USDPer-order notional ceiling in USD. Required before any order can be signed.
  • LIGHTER_CHAIN_IDLayer-2 chain id bound into every signature. Mainnet uses 304 and testnet 300, so this is only needed on a deployment that publishes none.
  • LIGHTER_READ_ONLY_TOKENRead-only token for account observation without a signing key.

Pricing

Open source

Lighter MCP FAQ

Is Lighter MCP free?

Yes. Lighter MCP is open source, so you can use and self-host it for free.

How do I add Lighter MCP to Claude Code?

Run this command in your terminal: claude mcp add lighter-mcp --env LIGHTER_API_KEY_PRIVATE_KEY='<LIGHTER_API_KEY_PRIVATE_KEY>' --env LIGHTER_READ_ONLY_TOKEN='<LIGHTER_READ_ONLY_TOKEN>' -- npx -y lighter-mcp