← All episodes
July 5, 2026 · EPISODE 6

Shipped — Quota Dashboard MCP for Claude Code, Kimi, and Z.ai

A local MCP server that answers "how much quota do I have left?" without sending tokens anywhere.

Shipped — Quota Dashboard MCP for Claude Code, Kimi, and Z.ai

If you subscribe to more than one AI coding assistant, you've probably done the mental math: How much of my Claude Code Max quota is left? Did Kimi reset yet? What's Z.ai's daily limit? I built a tiny local MCP server that answers those questions inside Claude Code, Cursor, VS Code, or any MCP client — without ever sending your tokens anywhere except the provider's own API.

The problem

Provider dashboards are separate, laggy, or non-existent. Claude Code Max users in particular have been hit by unexpected quota drain — peak-hour throttling, cache-TTL regressions, session-resume bugs. The symptom is usually the same: you're mid-session and the model suddenly stops, and the only number you care about is what percentage do I have left?

The solution

Quota Dashboard MCP is a stdio MCP server that exposes three tools:

  • get_quota_summary — unified view across all configured providers
  • get_provider_quota — detailed quota for one provider (claude, kimi, or zai)
  • check_quota_health — flags providers over a usage threshold (default 80%) or missing/invalid tokens

Install is one line:

npx -y ryan-knowone/quota-dashboard-mcp

It reads CLAUDE_TOKEN, KIMI_TOKEN, and ZAI_TOKEN from environment variables at call time, never persists them to disk, and never sends them or your usage data to telemetry.

Why local matters

Most quota dashboards ask you to paste keys into a web UI. That means your tokens sit on someone else's server, in someone else's logs, subject to someone else's security posture. This server runs on your machine. The browser or MCP client never sees your keys; the server only forwards them to the provider APIs you already trust.

Token setup

  • Claude Code Max: CLAUDE_TOKEN from ~/.claude/credentials.json accessToken
  • Kimi: KIMI_TOKEN platform API key from platform.moonshot.cn
  • Z.ai: ZAI_TOKEN Bearer token from your Z.ai dashboard

Only configure the providers you use. Mock mode works without any keys if you just want to verify the wiring.

Try it

Repo: github.com/ryan-knowone/quota-dashboard-mcp

One-line install:

npx -y ryan-knowone/quota-dashboard-mcp

If you prefer a web dashboard, the sibling project is at github.com/ryan-knowone/quota-dashboard.

If it saves you from a surprise quota outage, you can tip ETH/USDC on Base:

0x1e2D7F8715E8180816c0236A5c4F21596C5b9c9e

Issues and PRs are welcome — provider endpoints change often and community maintenance keeps the tool accurate.

— Ryan