reset-beer-mcp 1.0.0

package/README.md

@@ -0,0 +1,63 @@
+# @reset-beer/mcp
+
+> MCP (Model Context Protocol) server for [Reset Beer](https://reset.beer) — AI quota reset tracking across 15+ products.
+
+Query AI quota reset signals directly from Claude, Cursor, or any MCP-compatible AI assistant.
+
+## Quick Start
+
+```bash
+npm install -g @reset-beer/mcp
+export RESET_BEER_API_KEY="rb_your_key_here"
+reset-beer-mcp resets
+```
+
+## Claude Desktop Config
+
+```json
+{
+  "mcpServers": {
+    "reset-beer": {
+      "command": "npx",
+      "args": ["-y", "@reset-beer/mcp"],
+      "env": { "RESET_BEER_API_KEY": "rb_your_key_here" }
+    }
+  }
+}
+```
+
+## Cursor Config
+
+Add to `.cursor/mcp.json`:
+```json
+{
+  "mcpServers": {
+    "reset-beer": {
+      "url": "https://reset.beer/api/mcp",
+      "headers": { "Authorization": "Bearer rb_your_key_here" }
+    }
+  }
+}
+```
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `list_recent_resets` | List recent AI quota reset events |
+| `get_product_status` | Get latest reset event for a product |
+| `list_products` | List all tracked AI products |
+
+## Supported Products
+
+OpenAI Codex, ChatGPT Work, Claude/Claude Code, Google Gemini, xAI Grok, DeepSeek, Kimi/Moonshot, Alibaba Qwen, Zhipu GLM, Volcengine Ark, OpenRouter, Cursor, MiniMax, Tencent Hunyuan, Baidu Qianfan
+
+## Get an API Key
+
+1. Sign up at [reset.beer](https://reset.beer)
+2. Upgrade to Pro ($9.99 one-time, lifetime access)
+3. Generate key at [reset.beer/account](https://reset.beer/en-US/account)
+
+## License
+
+MIT

package/index.js

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+/**
+ * Reset Beer MCP Server
+ * Query AI quota reset signals from Claude, Cursor, or any MCP client.
+ * 
+ * Setup:
+ *   1. Get an API key at https://reset.beer/en-US/account (Pro required)
+ *   2. Set RESET_BEER_API_KEY environment variable
+ *   3. Add to your MCP client config
+ */
+
+const API_BASE = "https://reset.beer/api/mcp";
+const apiKey = process.env.RESET_BEER_API_KEY;
+
+if (!apiKey) {
+  console.error("Error: RESET_BEER_API_KEY environment variable is required.");
+  console.error("Get your key at https://reset.beer/en-US/account");
+  process.exit(1);
+}
+
+async function callMcp(method, params = {}) {
+  const response = await fetch(API_BASE, {
+    method: "POST",
+    headers: {
+      "Authorization": `Bearer ${apiKey}`,
+      "Content-Type": "application/json"
+    },
+    body: JSON.stringify({ jsonrpc: "2.0", id: Date.now(), method, params })
+  });
+  return response.json();
+}
+
+// CLI usage
+const [,, command, ...args] = process.argv;
+switch (command) {
+  case "resets": {
+    const hours = args[0] || "24";
+    const result = await callMcp("tools/call", { name: "list_recent_resets", arguments: { hours: Number(hours) } });
+    console.log(JSON.stringify(JSON.parse(result.result.content[0].text), null, 2));
+    break;
+  }
+  case "status": {
+    const productId = args[0];
+    if (!productId) { console.error("Usage: reset-beer-mcp status <product_id>"); process.exit(1); }
+    const result = await callMcp("tools/call", { name: "get_product_status", arguments: { productId } });
+    console.log(JSON.stringify(JSON.parse(result.result.content[0].text), null, 2));
+    break;
+  }
+  case "products": {
+    const result = await callMcp("tools/call", { name: "list_products", arguments: {} });
+    console.log(JSON.stringify(JSON.parse(result.result.content[0].text), null, 2));
+    break;
+  }
+  default:
+    console.log(`
+Reset Beer MCP Server
+
+Usage:
+  reset-beer-mcp resets [hours]     List recent quota resets
+  reset-beer-mcp status <product>   Get product status
+  reset-beer-mcp products           List all tracked products
+
+Environment:
+  RESET_BEER_API_KEY                Your API key from reset.beer/account
+`);
+}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "reset-beer-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for Reset Beer — AI quota reset tracking across 15+ products (Codex, Claude, Gemini, Cursor, etc.)",
+  "main": "index.js",
+  "type": "module",
+  "bin": {
+    "reset-beer-mcp": "./index.js"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "ai",
+    "quota",
+    "reset",
+    "tracking",
+    "openai",
+    "codex",
+    "claude",
+    "gemini",
+    "cursor",
+    "deepseek",
+    "rate-limit",
+    "developer-tools",
+    "notification",
+    "alerts"
+  ],
+  "author": {
+    "name": "Sunny Su",
+    "url": "https://x.com/SunnySu_AI"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/suxinsk/reset-beer-mcp.git"
+  },
+  "homepage": "https://reset.beer",
+  "bugs": {
+    "url": "https://github.com/suxinsk/reset-beer-mcp/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}