zai-quota-mcp

Check your z.ai coding plan quota — right from your CLI/IDE.

An MCP server that surfaces your z.ai usage stats inside Claude Code, Cursor, VS Code, or any MCP-compatible client. No context switching, no browser tabs — just ask your assistant "how's my quota?".

Features

• Monthly MCP quota at a glance — current vs. total with percentage bar
• Per-model breakdown — see exactly which models are consuming your allowance
• 5-hour token window — track rolling usage before it resets
• Smart countdowns — human-readable time until each quota resets

Quick Start

1. Grab your API key from z.ai.

2. Add the server to your MCP client config:

{
  "mcpServers": {
    "zai-quota": {
      "command": "npx",
      "args": ["-y", "zai-quota-mcp"],
      "env": {
        "ZAI_API_KEY": "your-api-key-here"
      }
    }
  }
}

That's it. Restart your client and ask your assistant to check your quota.

Configuration

Pick your client below and drop the snippet into the matching config file.

Claude Code

~/.claude/settings.json

{
  "mcpServers": {
    "zai-quota": {
      "command": "npx",
      "args": ["-y", "zai-quota-mcp"],
      "env": {
        "ZAI_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Desktop

claude_desktop_config.json

{
  "mcpServers": {
    "zai-quota": {
      "command": "npx",
      "args": ["-y", "zai-quota-mcp"],
      "env": {
        "ZAI_API_KEY": "your-api-key-here"
      }
    }
  }
}

VS Code / Cursor

.vscode/mcp.json

{
  "inputs": [
    {
      "id": "zai-api-key",
      "type": "password",
      "description": "z.ai API Key"
    }
  ],
  "servers": {
    "zai-quota": {
      "command": "npx",
      "args": ["-y", "zai-quota-mcp"],
      "env": {
        "ZAI_API_KEY": "${input:zai-api-key}"
      }
    }
  }
}

Available Tools

check_quota

Check your z.ai coding plan quota and usage. No parameters needed.

Returns:

• Current plan level (Free / Pro / Enterprise)
• MCP Monthly Quota — current/total usage and percentage
• Per-model usage breakdown
• 5-Hours Token Window usage percentage
• Next reset timestamps with countdowns

Development

npm install
npm run build
npx @modelcontextprotocol/inspector node dist/index.js

License

MIT