zai-quota-mcp

MCP server for checking z.ai coding plan quota and usage.

Features

• Check MCP Monthly Quota (web search/reader usage) with percentage
• Check 5-Hours Token Window usage percentage
• Per-model usage breakdown
• Next reset times with human-readable countdowns

Prerequisites

• Node.js >= 20
• A z.ai account with an API key

Installation

Using npx (recommended, no install needed)

npx -y zai-quota-mcp

Global install

npm install -g zai-quota-mcp

Configuration

Add your ZAI_API_KEY and the server config to your MCP client:

Claude Desktop

Add to claude_desktop_config.json:

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

Claude Code

Add to .claude/settings.json:

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

VS Code / Cursor

Add to .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.

Parameters: None

Returns:

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

Development

# Install dependencies
npm install

# Build
npm run build

# Test with MCP Inspector
npx @modelcontextprotocol/inspector node dist/index.js

License

MIT