Skip to main content
Glama
llmkit-mcp-server

llmkit-mcp-server

by smigolsmigol

@f3d1/llmkit-mcp-server

AI cost inspection for supported Claude Code sessions and Cline task data found in VS Code-family storage. Eleven tools cover local session evidence, authenticated gateway spend, and budget queries.

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": ["-y", "@f3d1/llmkit-mcp-server"]
    }
  }
}

The local tools (llmkit_local_*) need no API key. They read supported Claude Code sessions and Cline task data from supported editor storage. Proxy tools require an existing LLMKit API key in LLMKIT_API_KEY. Check llmkit.sh for current account and service availability.

Related MCP server: Langfuse MCP Server

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)

The local tools detect supported installations and aggregate their session data.

Tool

What it does

llmkit_local_session

Current Claude Code session or latest detected Cline task cost

llmkit_local_projects

Cumulative cost across all projects and sessions

llmkit_local_cache

Claude Code prompt caching savings using model-bound prices

llmkit_local_forecast

30-day API-rate projection from detected local history

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

LLMKIT_SCAN_WSL

No

Set to 1 to scan WSL homes for Claude Code and Cline data

Supported tools

The local tools read data from:

  • Claude Code (~/.claude/projects/)

  • Cline extension storage in VS Code, Insiders, VSCodium, Cursor, and Windsurf

  • WSL installations when LLMKIT_SCAN_WSL=1 (scans distro homes via UNC paths on Windows)

  • VS Code, Cursor, and Windsurf server directories for supported remote extension storage

License

MIT

Available Tools

11 tools
llmkit_budget_statusA
Read-onlyIdempotent

Check budget limits and remaining balance

Inputs: budgetId. Returns: budgets

llmkit_cost_queryB
Read-onlyIdempotent

Query cost breakdown grouped by provider, model, session, or day

Inputs: groupBy (required), days, provider, model. Returns: groupBy, days, breakdown

llmkit_healthA
Read-onlyIdempotent

Check proxy health and response time

Inputs: no named parameters. Returns: status, responseTimeMs

llmkit_list_keysA
Read-onlyIdempotent

List all API keys with status and creation date

Inputs: no named parameters. Returns: keys

llmkit_local_agentsA
Read-onlyIdempotent

Subagent cost attribution for the current Claude Code session. Shows which agents cost the most.

Inputs: no named parameters. Returns: sessionId, totalCostUsd, mainConversationCostUsd, subagentsTotalCostUsd, +2 more

llmkit_local_cacheA
Read-onlyIdempotent

Cache savings analysis across all detected AI coding tools. Shows how much prompt caching saved.

Inputs: no named parameters. Returns: savings, totalSavedUsd

llmkit_local_forecastA
Read-onlyIdempotent

Monthly cost projection based on local AI tool usage. Compares to Max subscription.

Inputs: no named parameters. Returns: projectedMonthlyUsd, dailyAverageUsd, totalTrackedUsd, totalSessions, +1 more

llmkit_local_projectsA
Read-onlyIdempotent

Cumulative cost across all projects and sessions from all detected AI coding tools, ranked by spend.

Inputs: no named parameters. Returns: projects, totalCostUsd

llmkit_local_sessionA
Read-onlyIdempotent

Current session cost across all detected AI coding tools (Claude Code, Cline). No API key needed.

Inputs: no named parameters. Returns: sessions, totalCostUsd, sourceCount

llmkit_session_summaryA
Read-onlyIdempotent

Get recent proxy sessions with cost, duration, and models used

Inputs: sessionId, limit. Returns: sessions

llmkit_usage_statsC
Read-onlyIdempotent

Get usage statistics (spend, requests, top models) for a time period

Inputs: period. Returns: period, requests, totalSpendUsd, inputTokens, +4 more

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 11 tools

    Disambiguation4/5

    Tools are mostly distinct, targeting different aspects like budget, cost breakdown, health, keys, local session, etc. However, llmkit_cost_query, llmkit_usage_stats, and llmkit_session_summary have overlapping purposes (cost/spend/usage data) which could cause some confusion.

    Naming Consistency5/5

    All tools follow a consistent pattern with the 'llmkit_' prefix and descriptive noun phrases separated by underscores, e.g., llmkit_budget_status, llmkit_cost_query. No mixing of conventions.

    Tool Count5/5

    With 11 tools, the count is well within the recommended 3-15 range. Each tool covers a distinct aspect of proxy cost monitoring and management, justifying its inclusion.

    Completeness4/5

    The tool surface covers major monitoring needs: health, budget, cost, keys, sessions, and local attribution. However, it lacks management capabilities (e.g., create/update keys or budgets) and could include actions like setting usage limits, which are minor gaps for a read-only analytics server.

    Maintenance

    ActivityStale
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      C
      quality
      D
      maintenance
      Enables interaction with Google Cloud services including billing cost analysis, log querying, and metrics monitoring through natural language commands. Provides comprehensive tools for managing GCP resources, analyzing costs, detecting anomalies, and retrieving operational insights.
      40
      1
      Apache 2.0
    • A
      license
      B
      quality
      D
      maintenance
      Enables querying Langfuse analytics, cost metrics, and usage data across multiple projects. Provides tools for trace analysis, model/service cost breakdowns, and daily usage trends through natural language queries.
      24
      67 npm
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables querying and analyzing AWS cost and usage data through the AWS Cost Explorer API. Supports cost comparisons, forecasting, dimension filtering, and cost change driver analysis with streamable HTTP deployment to Amazon Bedrock Agentcore Runtime.
      -
    • A
      license
      B
      quality
      D
      maintenance
      An MCP server for unified cost tracking and analysis across AWS, OpenAI, and Anthropic. It enables users to query expenditures, compare costs across providers, and analyze usage trends through natural language.
      10
      MIT