广告合作
MCP.so
登录

Claude Usage MCP Server

@Orellius

代码仓库

基本信息

分类

AI 与智能体

传输方式

stdio

作者

Orellius

提交者

Orel

关于 Claude Usage MCP Server

MCP server for Claude Pro/Max subscription usage — session limits, weekly limits, per-model breakdown, extra credits. Zero config, reads your existing OAuth token.

#cli#oauth#subscription#typescript#mcp#rate-limits#max#usage#developer-tools#statusline#pro#claude#anthropic#model-context-protocol#claude-code

Claude Usage MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "claudeusage": {
      "command": "node",
      "args": [
        "/absolute/path/to/claudeusage-mcp/dist/index.js"
      ]
    }
  }
}

Claude Usage MCP Server 工具

4

Full dashboard — session, weekly, per-model, extra usage with progress bars

Current 5-hour session window only

7-day limits with per-model breakdown (All, Opus, Sonnet)

Am I about to be rate-limited? Returns LOW / MODERATE / HIGH / RATE LIMITED

概览

What is Claude Usage Mcp?

Claude Usage Mcp is an MCP server that gives real‑time visibility into your Claude Pro/Max subscription usage directly inside Claude Code. It reads the OAuth token already stored on your machine and calls Anthropic’s usage endpoint—no API keys, scraping, or browser automation required.

How to use Claude Usage Mcp?

Clone the repository, run npm install && npm run build, then add the server via claude mcp add claudeusage -- node $(pwd)/dist/index.js or manually in your MCP config. After restarting Claude Code, ask “what’s my usage?” or type /usage. Optional statusline integration adds a persistent usage line.

Key features of Claude Usage Mcp

  • Reads OAuth credentials from macOS Keychain or ~/.claude/.credentials.json
  • Provides four MCP tools: get_usage, get_session_usage, get_weekly_limits, check_rate_status
  • Caches responses for 60 seconds with stale‑data fallback on rate limits
  • Color‑coded progress bars (green/orange/red) for usage levels
  • Statusline script shows usage in the Claude Code status bar
  • Works on macOS and Linux with Node.js 18+

Use cases of Claude Usage Mcp

  • Monitor current 5‑hour session window utilization and reset countdown
  • Check weekly usage across all models and per‑model (Opus, Sonnet)
  • See if you are approaching or currently rate‑limited
  • Track extra usage credits and monthly limits
  • Get all usage data without leaving the terminal or opening a browser

常见问题

1

How does Claude Usage Mcp authenticate?

It uses the same OAuth token that Claude Code creates when you sign in with a Pro/Max subscription. No API keys, environment variables, or `.env` files are required.

2

What are the runtime requirements?

Node.js 18 or later, macOS or Linux, and a Claude Code session logged in with a Pro or Max subscription.

3

Where does my usage data come from?

The server calls `GET https://api.anthropic.com/api/oauth/usage` with the stored OAuth token. It caches the response for 60 seconds and serves stale data if the endpoint rate‑limits the request.

4

Does Claude Usage Mcp work with API keys?

No. This server is for Pro/Max subscribers only. API users should use the official [Usage and Cost API](https://platform.claude.com/docs/en/build-with-claude/usage-cost-api) instead.

5

What happens if my token expires?

Restart Claude Code to trigger a fresh OAuth login. If you previously used `claude setup-token` or `/login`, the token may have the wrong scopes; delete the credentials file and restart Claude Code.

评论

AI 与智能体 分类下的更多 MCP 服务器

Gemina

Gemina Tech Ltd.

Extract, search and tag any document — invoices, receipts, contracts, forms, or your own templates. 13 tools, one sign-in (OAuth 2.1) or API key, free FileTag tier, data residency in the EU, US, Israel or Asia.

Nero AI Image Processing

nero-com

We provide AI-powered tools for image enhancement, upscaling, background removal, photo restoration, colorization, denoising, and compression. All features are available through our API documentation.

Cartesia MCP

cartesia-ai

Cartesia MCP is a remote MCP server for Cartesia (https://cartesia.ai) available at https://mcp.cartesia.ai.

Hypnothera

La-Salida

Agent skill: turn what your AI assistant knows about you into a personalized hypnosis session on hypnothera.ai

Agentery

ntlgnc

Free MCP for live and historical pricing for 13,000+ agents and MCPs. Never knowingly pay too much... or charge too little. Know the going rate. https://agentery.com.

广告合作