MCP-Server-Lighter

MCP server for Lighter — a Model Context Protocol server that lets Claude, Cursor and Cline query Lighter (lighter.xyz) volume, points, rank and airdrop eligibility in natural language. Read-only — public endpoints only, no keys. Unofficial community project, not affiliated with Lighter.

---

📖 Overview

MCP Server — Lighter is a Model Context Protocol server for the Lighter DEX API that exposes trading volume, campaign points, leaderboard rank, liquidity and airdrop eligibility as MCP tools for any MCP-compatible LLM agent. It works with Claude Desktop, Cursor, and Cline — an Ethereum L2 perpetual futures DEX integration that lets you query Lighter volume, points, rank, and airdrop eligibility from Claude in natural language, built on the official MCP Python SDK.

Instead of copy-pasting wallet addresses into a web dashboard, your AI assistant calls the tools directly and reasons about your farming progress in plain language — natural-language access to Lighter airdrop farming stats with structured tool outputs for AI agents and LLM workflows:

“You’re at $142,800 campaign volume — BRONZE tier, 95% of the way to SILVER ($150k). Keep your maker ratio above 50% and provide liquidity for 9 more days to also satisfy the liquidity criterion.”

⚠️ Read-only — public endpoints only, no keys. The server exposes data tools only — no trading, no signing.

---

✨ Tools exposed

Each tool returns typed JSON the agent can reason over.

---

🚀 Quick start

git clone https://github.com/isabelpapaya/mcp-server-lighter.git
cd mcp-server-lighter
pip install -r requirements.txt

python main.py --demo      # stdio transport, bundled demo wallet

Or use the one-click launchers (they unpack a bundled standalone interpreter on first run):

run.bat        :: Windows

chmod +x run.sh && ./run.sh    # Linux / macOS

🔌 Connect your client

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "lighter": {
      "command": "python",
      "args": ["C:\\path\\to\\mcp-server-lighter\\main.py", "--demo"]
    }
  }
}

Cline / Cursor / Continue

Point the client at the server over stdio with the same command — see your client’s MCP settings page.

---

🧪 Try the tools headlessly

python main.py --tool get_eligibility --wallet 0x9f…c310 --demo

---

🗂️ Project layout

mcp-server-lighter/
├── main.py               # Entry point (unpacks bundled runtime on first launch)
├── mcp_lighter/          # Host package
│   ├── __main__.py       # `python -m mcp_lighter` entry (argparse + server bootstrap)
│   ├── server.py         # FastMCP tool definitions
│   ├── config.py         # Config loader (TOML)
│   └── core/             # models, analytics, mock data
├── base/                 # Runtime support library
├── requirements.txt
├── run.bat / run.sh      # One-click launchers
└── release/              # Pre-compiled binaries (planned)

---

⚙️ Configuration

# ~/.lighter-mcp/config.toml
[network]
rpc = "https://mainnet.optimism.io"

[campaign]
points_per_dollar    = 2.0
maker_bonus_pct      = 0.20
liquidity_multiplier = 1.25
tiers = [
    { name = "BRONZE",   volume = 50000 },
    { name = "SILVER",   volume = 150000 },
    { name = "GOLD",     volume = 300000 },
    { name = "PLATINUM", volume = 600000 },
]

---

🔒 Security

• Read-only. Data tools only — no order placement, no signing, no private keys.
• No telemetry. Queries go to the configured public RPC; nothing is phone-homed.

---

❓ FAQ

---

⚠️ Disclaimer

This is an unofficial community project, not affiliated with, endorsed by, or sponsored by Lighter XYZ or Anthropic. Provided for research purposes — not financial advice.

---

📄 License

MIT — see LICENSE.