@f3d1/llmkit-mcp-server

AI cost tracking for Claude Code, Cline, Cursor, and Claude Desktop. 11 tools for spend queries, budgets, local session costs, and agent attribution across 11 LLM providers.

Part of LLMKit, an open-source API gateway with cost tracking and budget enforcement.

Quick start

Add to your .mcp.json (Claude Code) or .cursor/mcp.json (Cursor):

{
  "mcpServers": {
    "llmkit": {
      "command": "npx",
      "args": ["@f3d1/llmkit-mcp-server"],
      "env": {
        "LLMKIT_API_KEY": "llmk_your_key_here"
      }
    }
  }
}

The local tools (llmkit_local_*) work immediately with no API key. They auto-detect Claude Code, Cline, and Cursor data on your machine. For the proxy tools, create a free key at the dashboard.

Tools

Proxy tools (need API key)

| Tool | What it does | |------|-------------| | llmkit_usage_stats | Spend, requests, top models for a period | | llmkit_cost_query | Costs grouped by provider, model, session, or day | | llmkit_budget_status | Budget limits and remaining balance | | llmkit_session_summary | Recent sessions with cost, duration, models | | llmkit_list_keys | All keys with status and creation date | | llmkit_health | Proxy ping with response time |

Local tools (no key needed)

Auto-detect installed AI coding tools and aggregate data from all of them.

| Tool | What it does | |------|-------------| | llmkit_local_session | Current session cost across all detected tools | | llmkit_local_projects | Cumulative cost across all projects and sessions | | llmkit_local_cache | Prompt caching savings analysis | | llmkit_local_forecast | Monthly projection vs Max subscription | | llmkit_local_agents | Subagent cost attribution (Claude Code) |

SessionEnd hook

Auto-log session costs when Claude Code exits:

{
  "hooks": {
    "SessionEnd": [
      {
        "type": "command",
        "command": "npx @f3d1/llmkit-mcp-server --hook"
      }
    ]
  }
}

Environment variables

| Variable | Required | Description | |----------|----------|-------------| | LLMKIT_API_KEY | No | API key for proxy tools. Local tools work without it. | | LLMKIT_PROXY_URL | No | Proxy URL (defaults to hosted service) | | LLMKIT_CLINE_DIR | No | Override Cline data directory path |

Supported tools

The local tools detect data from:

• Claude Code (~/.claude/projects/)
• Cline (VS Code, Insiders, VSCodium, Cursor, Windsurf globalStorage)
• WSL installations (scans all distros via UNC paths on Windows)
• VS Code Server / Cursor Server (remote SSH/WSL extensions)

License

MIT