claudestat-mcp-bundle
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@claudestat-mcp-bundle list available tools"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
claudestat-mcp-bundle
MCP server bundle for @statforge/claudestat — wraps createMcpServer() into a standalone package with CLI and programmatic import.
Install
npm install -g @statforge/claudestat-mcp-bundleRelated MCP server: wrapmcp
Quick start
claudestat-mcpThen add to Claude Code's claude.json:
{
"mcpServers": {
"claudestat": {
"command": "claudestat-mcp"
}
}
}Programmatic usage
import { createMcpServer } from '@statforge/claudestat-mcp-bundle'
const server = createMcpServer({
contextPolling: true,
tools: [
{ name: 'my_tool', description: 'Does something', inputSchema: {}, handler: () => 'hello' },
],
})
server.start()API
createMcpServer(options?) returns an McpServer with:
start()— begin listening on stdinstop()— close stdin listeneraddTool(def)— register a tool at runtimeremoveTool(name)— unregister a tooltools— current tool list (readonly)
Options: { tools?, name?, version?, contextPolling? }
License
MIT
Available Tools
9 toolsget_context_statusA
Get current context window usage for the latest session: used tokens, window size, percentage, and model
Inputs: no named parameters.
get_current_sessionA
Get details about the most recent Claude Code session: cost, tokens, efficiency score, and loops detected
Inputs: no named parameters.
get_daily_summaryB
Get today's usage summary vs yesterday and 7-day personal average: cost, sessions, tokens, top tool, and weekly pace
Inputs: no named parameters.
get_model_breakdownB
Get cost and session count broken down by Claude model (Sonnet, Haiku, Opus) for the last N days
Inputs: days.
get_quota_statusB
Get current Claude Code quota status: 5h cycle usage %, plan type, weekly hours per model, and burn rate (tokens/min)
Inputs: no named parameters.
get_session_statsA
Get aggregated session statistics for the last N days: session count, total cost, total tokens, loops, and average efficiency
Inputs: days.
get_top_toolsB
Get the top 10 most used tools by cost, call count, or duration in the last N days
Inputs: days, sort_by.
get_usage_insightsB
Get unique usage insights not available in /usage: cost per project, cache savings, output/input ratio, efficiency trend, and peak hours
Inputs: days.
get_weekly_insightB
Get the weekly usage summary with an actionable tip (same as claudestat weekly command)
Inputs: days.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
Each tool targets a distinct aspect of Claude Code usage (quota, session, context, model breakdown, etc.) with clear descriptions, eliminating ambiguity.
All tools use a consistent 'get_' prefix followed by a descriptive noun phrase in snake_case, e.g., get_quota_status, get_current_session.
9 tools is an appropriate size for a usage analytics server, covering various queries without being excessive or insufficient.
The tool set covers all major usage analytics: quota, session details, aggregated stats, top tools, insights, model breakdown, context, daily and weekly summaries, with no obvious gaps.
Maintenance
Related MCP Connectors
Hosted Amazon Seller and Vendor MCP server for Claude, ChatGPT, Cursor, Codex, Gemini, Copilot.
Shared memory MCP server for Claude Code, Codex, Gemini CLI and Cursor. Cited, editable.
Focused MCP server for OpenAI image/audio generation (v2.0.0). Wraps endpoints via HAPI CLI.
Hosted Amazon Seller Central and Amazon Ads MCP server for Claude, ChatGPT, Cursor, and agents.
Related MCP Servers
- AlicenseAqualityBmaintenanceLocal MCP server that wraps the headless Claude Code CLI as MCP tools, providing stateless access to Claude's coding capabilities through prompt-based interactions. It enables users to execute Claude Code commands with various prompt formats and structured outputs directly from MCP clients.3MIT
- AlicenseNot gradedqualityCmaintenanceUniversal MCP server that wraps any CLI tool, enabling AI assistants to run commands via natural language.1MIT
- AlicenseNot gradedqualityDmaintenanceTurns any CLI tool or REST API into an MCP server for Claude, enabling Claude to use git, databases, or any API through natural language.MIT
- FlicenseAqualityDmaintenanceProvides a secure interface to run Anthropic's Claude Code CLI as an MCP server, enabling task execution, persistent memory, and integration with MCP-enabled IDEs.12-