jobseek-mcp 0.8.0 → 0.9.0

package/README.md

@@ -129,7 +129,7 @@ Update the status of a job application. Perfect for tracking application progres
 - `date` (optional) - Date of the status change (YYYY-MM-DD format, defaults to today)
 - `notes` (optional) - Additional context (e.g., "Interview with Sarah scheduled")
 
-**Example:** "Update my Interplay application to interviewing status - interview scheduled for January 13th with Stacy Greco"
+**Example:** "Update my Acme Corp application to interviewing status - interview scheduled for January 15th with the hiring manager"
 
 ## Automated Job Search (with Claude for Chrome)
 

package/dist/server.js

@@ -10,6 +10,7 @@ import { myApplicationsTool, handleMyApplications } from "./tools/my-application
 import { getFormDataTool, handleGetFormData } from "./tools/get-form-data.js";
 import { evaluateJobTool, handleEvaluateJob } from "./tools/evaluate-job.js";
 import { updateApplicationStatusTool, handleUpdateApplicationStatus } from "./tools/update-application-status.js";
+import { tokenBalanceTool, handleGetTokenBalance } from "./tools/token-balance.js";
 import { allResources, handleReadResource } from "./resources.js";
 import { allPrompts, getPromptMessages } from "./prompts.js";
 export function createServer(apiKey) {
@@ -19,7 +20,7 @@ export function createServer(apiKey) {
     // Create the MCP server
     const server = new Server({
         name: "jobseek-mcp",
-        version: "0.7.0",
+        version: "0.8.0",
     }, {
         capabilities: {
             tools: {},
@@ -41,6 +42,7 @@ export function createServer(apiKey) {
                 getFormDataTool,
                 evaluateJobTool,
                 updateApplicationStatusTool,
+                tokenBalanceTool,
             ],
         };
     });
@@ -68,6 +70,8 @@ export function createServer(apiKey) {
                 return handleEvaluateJob(args, JOBSEEK_API_URL, apiKey);
             case "update_application_status":
                 return handleUpdateApplicationStatus(args, JOBSEEK_API_URL, apiKey);
+            case "get_token_balance":
+                return handleGetTokenBalance(args, JOBSEEK_API_URL, apiKey);
             default:
                 throw new Error(`Unknown tool: ${name}`);
         }

package/dist/tools/token-balance.d.ts

@@ -0,0 +1,15 @@
+export declare const tokenBalanceTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {};
+        required: never[];
+    };
+};
+export declare function handleGetTokenBalance(args: unknown, apiUrl: string, apiKey?: string): Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+}>;

package/dist/tools/token-balance.js

@@ -0,0 +1,98 @@
+import { z } from "zod";
+// Tool definition
+export const tokenBalanceTool = {
+    name: "get_token_balance",
+    description: "Check your current AI credit/token balance. Shows how many tokens you've used, your total budget, and how many remain. Use this to understand your usage before performing token-intensive operations.",
+    inputSchema: {
+        type: "object",
+        properties: {},
+        required: []
+    }
+};
+// Input validation (no inputs required)
+const TokenBalanceInput = z.object({});
+// Tool handler
+export async function handleGetTokenBalance(args, apiUrl, apiKey) {
+    TokenBalanceInput.parse(args);
+    if (!apiKey) {
+        return {
+            content: [{
+                    type: "text",
+                    text: `❌ **API Key Required**\n\nGet your API key at: ${apiUrl}/dashboard/api-keys`
+                }]
+        };
+    }
+    try {
+        const response = await fetch(`${apiUrl}/api/usage`, {
+            headers: {
+                "Authorization": `Bearer ${apiKey}`,
+            },
+        });
+        if (!response.ok) {
+            if (response.status === 401) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: `❌ **Invalid API Key**\n\nGenerate a new key at: ${apiUrl}/dashboard/api-keys`
+                        }]
+                };
+            }
+            const error = await response.json().catch(() => ({}));
+            return {
+                content: [{
+                        type: "text",
+                        text: `❌ **Error**\n\n${error.error || 'Failed to fetch token balance'}`
+                    }]
+            };
+        }
+        const data = await response.json();
+        const { tokenUsage, tokenBudget, isAdmin } = data;
+        const remaining = tokenBudget - tokenUsage;
+        const percentUsed = tokenBudget > 0 ? Math.round((tokenUsage / tokenBudget) * 100) : 0;
+        let statusEmoji = '🟢';
+        let statusText = 'Healthy';
+        if (percentUsed >= 90) {
+            statusEmoji = '🔴';
+            statusText = 'Low - Consider purchasing more credits';
+        }
+        else if (percentUsed >= 70) {
+            statusEmoji = '🟡';
+            statusText = 'Moderate';
+        }
+        let output = `# ⚡ AI Credit Balance\n\n`;
+        if (isAdmin) {
+            output += `| Metric | Value |\n`;
+            output += `|--------|-------|\n`;
+            output += `| **Tokens Used** | ${tokenUsage.toLocaleString()} |\n`;
+            output += `| **Budget** | ∞ Unlimited (Admin) |\n`;
+            output += `| **Status** | 🟢 No limits |\n`;
+        }
+        else {
+            output += `| Metric | Value |\n`;
+            output += `|--------|-------|\n`;
+            output += `| **Tokens Used** | ${tokenUsage.toLocaleString()} |\n`;
+            output += `| **Total Budget** | ${tokenBudget.toLocaleString()} |\n`;
+            output += `| **Remaining** | ${remaining.toLocaleString()} |\n`;
+            output += `| **Used** | ${percentUsed}% |\n`;
+            output += `| **Status** | ${statusEmoji} ${statusText} |\n`;
+            if (percentUsed >= 70) {
+                output += `\n---\n\n`;
+                output += `💡 **Tip:** Purchase more credits at: ${apiUrl}/dashboard/tokens\n`;
+            }
+        }
+        return {
+            content: [{
+                    type: "text",
+                    text: output
+                }]
+        };
+    }
+    catch (error) {
+        return {
+            content: [{
+                    type: "text",
+                    text: `❌ **Error**\n\nFailed to fetch token balance: ${error.message}`
+                }]
+        };
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "jobseek-mcp",
-    "version": "0.8.0",
+    "version": "0.9.0",
     "description": "JobSeek MCP Server - AI-powered job search automation for Claude. Enables automated job searching with Claude for Chrome browser control.",
     "author": "Shawn Mitchell",
     "license": "MIT",