MCP 服务器

l6e-mcp

Enables AI coding agents to set budgets per task, check costs before expensive operations, and halt when budget is exhausted, with support for calibration and cloud sync.

README

l6e-mcp

l6e makes your AI coding agent cost-efficient.

Set a budget per task. Your agent checkpoints before expensive operations, gets halt signals when it's spending too much, and stops when it's done — not when it runs out of money. Import your billing data and l6e learns your actual cost patterns, so estimates get tighter over time.

No proxy. No SDK changes. Just an MCP server that works with Cursor, Claude Code, and Windsurf.

Dogfooding: docs.l6e.ai is built and maintained using l6e itself.

Quick start

1. Install

pip install l6e-mcp
# or, zero-install:
uvx l6e-mcp

2. Add to your MCP config

Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "l6e": {
      "command": "uvx",
      "args": ["l6e-mcp"]
    }
  }
}

See docs.l6e.ai/setup for Claude Code and Windsurf configs.

3. Add the enforcement rule

Copy the l6e budget enforcement rule to .cursor/rules/ so your agent knows how to use the budget tools.

That's it — start a session, set a budget, and your agent is cost-aware.

4. (Optional) Connect to the dashboard

Create a free account at app.l6e.ai for session history, spend tracking, and billing import for calibration:

{
  "mcpServers": {
    "l6e": {
      "command": "uvx",
      "args": ["l6e-mcp"],
      "env": {
        "L6E_API_KEY": "sk-l6e-...",
        "L6E_CLOUD_SYNC": "1"
      }
    }
  }
}

How it works

l6e sits as an MCP server between your IDE and your agent. At each checkpoint, the agent calls l6e_authorize_call — l6e checks the remaining budget and returns allow or halt.

allow — proceed; check budget_pressure to decide how aggressively to economize
halt — budget exhausted, stop the session

Session state is persisted locally in SQLite (~/.l6e/sessions.db). No LLM calls are proxied — l6e only sees the metadata your agent passes at each checkpoint (token estimates, model, stage label). It never sees your prompts, completions, or source code.

Calibration

Out of the box, l6e uses raw token estimates from LiteLLM pricing. These are directionally accurate but can diverge significantly from what your provider actually bills, depending on your model and usage patterns.

Import your billing CSV from Cursor or your LLM provider at app.l6e.ai and l6e computes a personal calibration factor for each model you use. The more sessions you run, the tighter the estimates get.

For manual calibration without cloud sync, add a [calibration] section to ~/.l6e/config.toml:

[calibration]
claude-4-opus = 72.0
claude-4-sonnet = 45.0
claude-3.5-haiku = 12.0

Free vs Pro

	Free	Pro ($15/mo)
Budget enforcement	✓	✓
Local session storage	✓	✓
Cloud sync + dashboard	✓ (90-day history)	✓ (unlimited)
Billing import	✓ (5/month)	✓ (unlimited)
Per-model calibration	✓	✓
Community baseline factors	✓	✓

Upgrade at app.l6e.ai →

MCP tools

Tool	Purpose
`l6e_run_start`	Open a new budget session. Returns `session_id`.
`l6e_authorize_call`	Gate before sub-agents and stage transitions. Returns `allow` or `halt`. Pass `check_only=True` for a lightweight budget pressure check.
`l6e_record_usage`	Attach exact token counts to a call (optional, improves accuracy).
`l6e_run_end`	Close the session and flush the run log.

Full tool reference at docs.l6e.ai/tools.

Environment variables

Variable	Default	Purpose
`L6E_API_KEY`	(unset)	API key for cloud sync
`L6E_CLOUD_SYNC`	`false`	Set to `1` to enable cloud sync
`L6E_CLOUD_ENDPOINT`	`https://api.l6e.ai`	Override the cloud sync endpoint
`L6E_LOG_PATH`	`.l6e/runs.jsonl`	Run log path — set to an absolute path
`L6E_SESSION_DB_PATH`	`~/.l6e/sessions.db`	Local SQLite database path
`L6E_CONFIG_PATH`	`~/.l6e/config.toml`	Config file path

Known limitations

Estimate-first by default. Exact accounting requires l6e_record_usage calls with actual token counts after each LLM call. Without them, budgets are based on the agent's pre-call estimates.
Local persistence by default. Sessions persist in a local SQLite database. Cloud sync is available with a free account at app.l6e.ai — set L6E_API_KEY and L6E_CLOUD_SYNC=1 to enable.