# llmkit

Monitors AI expenses and checks agent budgets. Inspects Claude Code sessions and Cline tasks without sending data to a remote proxy.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 15
- Author: smigolsmigol
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/smigolsmigol/llmkit
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/mcp/llmkit

## What it does

The server brings AI cost visibility to developer environments. It tracks token usage directly in the workspace. Agents can look up spending metrics before running heavy jobs.

The package bundles 11 tools in total. Five tools run locally to parse stored Claude Code history and Cline task logs straight from your machine. The other six tools reach out to the LLMKit gateway via `LLMKIT_API_KEY` to retrieve active budget allocations and key statuses.

Cost calculations rely on an offline pricing snapshot rather than real-time provider billing APIs. Registering new LLMKit accounts is paused right now, so gateway features only work if you already own an existing API key.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `LLMKIT_API_KEY`, `LLMKIT_PROXY_URL` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env LLMKIT_API_KEY=<LLMKIT_API_KEY> --env LLMKIT_PROXY_URL=<LLMKIT_PROXY_URL> --transport stdio llmkit -- npx -y @f3d1/llmkit-mcp-server
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add llmkit --env LLMKIT_API_KEY=<LLMKIT_API_KEY> --env LLMKIT_PROXY_URL=<LLMKIT_PROXY_URL> -- npx -y @f3d1/llmkit-mcp-server
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "llmkit": {
            "command": "npx",
            "args": [
                "-y",
                "@f3d1/llmkit-mcp-server"
            ],
            "env": {
                "LLMKIT_API_KEY": "<LLMKIT_API_KEY>",
                "LLMKIT_PROXY_URL": "<LLMKIT_PROXY_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "llmkit": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@f3d1/llmkit-mcp-server"
            ],
            "env": {
                "LLMKIT_API_KEY": "<LLMKIT_API_KEY>",
                "LLMKIT_PROXY_URL": "<LLMKIT_PROXY_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e LLMKIT_API_KEY=<LLMKIT_API_KEY> -e LLMKIT_PROXY_URL=<LLMKIT_PROXY_URL> llmkit npx -y @f3d1/llmkit-mcp-server
```
Replace <…> with your own values

## When to use it
- inspect costs of local Claude Code sessions
- audit Cline task spend without cloud accounts
- check remaining budget balances before triggering requests
- look up model pricing from the bundled reference catalog

## Example prompts
- Show the total cost of my current Claude Code session.
- Check remaining budget balance using my LLMKit key.
- Compare pricing for Sonnet and GPT-4o from the local catalog.

## Similar
- [cost-summary](https://affpapa.org/en/nevibecode/skills/cost-summary.md) — skill · 683 installs
- [cost-budget-check](https://affpapa.org/en/nevibecode/skills/cost-budget-check.md) — skill · 692 installs
- [SatGate – Economic Firewall for AI Agents](https://affpapa.org/en/nevibecode/mcp/satgate-economic-firewall-for-ai-agents.md) — MCP server · ★ 11
- [Agent Cost Report](https://affpapa.org/en/nevibecode/skills/agent-cost-report.md) — skill · 381 installs
- [LLM Usage](https://affpapa.org/en/nevibecode/mcp/llm-usage.md) — MCP server · ★ 6
- [budget-optimizer](https://affpapa.org/en/nevibecode/skills/onewave-ai-budget-optimizer.md) — skill · 429 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md