@calybur/mcp 0.1.0 → 0.2.0

package/README.md

@@ -19,10 +19,7 @@ Add to `.cursor/mcp.json`:
       "command": "npx",
       "args": ["-y", "@calybur/mcp@latest"],
       "env": {
-        "CALYBUR_API_KEY": "ezg_live_your_key_here",
-        "CALYBUR_API_BASE_URL": "https://YOUR_PROJECT.supabase.co/functions/v1",
-        "CALYBUR_SUPABASE_PUBLISHABLE_KEY": "your_supabase_publishable_key",
-        "CALYBUR_PLAN": "starter"
+        "CALYBUR_API_KEY": "ezg_live_your_key_here"
       }
     }
   }
@@ -36,9 +33,9 @@ Restart Cursor and enable the Calybur MCP tools.
 | Variable | Required | Description |
 |----------|----------|-------------|
 | `CALYBUR_API_KEY` | Yes | Partner API key (`ezg_live_*`) |
-| `CALYBUR_API_BASE_URL` | Yes | Supabase Edge Functions base URL |
-| `CALYBUR_SUPABASE_PUBLISHABLE_KEY` | Yes | Supabase publishable key (same as app frontend) |
 | `CALYBUR_PLAN` | No | `starter` (default), `professional`, or `enterprise` |
+| `CALYBUR_API_BASE_URL` | No | Defaults to `https://api.calybur.com` |
+| `CALYBUR_SUPABASE_PUBLISHABLE_KEY` | No | Only if bypassing the gateway with a direct Supabase URL |
 
 ## Tools (MVP — read-only)
 
@@ -66,7 +63,7 @@ cd packages/calybur-mcp
 npm install
 npm test
 npm run build
-CALYBUR_API_KEY=... CALYBUR_API_BASE_URL=... npm run dev
+CALYBUR_API_KEY=ezg_live_... npm run dev
 ```
 
 ## Rate Limits

package/dist/client.js

@@ -12,14 +12,17 @@ export class CalyburClient {
         }
         const query = new URLSearchParams(params).toString();
         const url = `${this.config.baseUrl}/${functionPath}${query ? `?${query}` : ''}`;
+        const headers = {
+            'x-api-key': this.config.apiKey,
+            Accept: 'application/json',
+        };
+        if (!this.config.gatewayMode) {
+            headers.apikey = this.config.publishableKey;
+            headers.Authorization = `Bearer ${this.config.publishableKey}`;
+        }
         const response = await fetch(url, {
             method: 'GET',
-            headers: {
-                'x-api-key': this.config.apiKey,
-                apikey: this.config.publishableKey,
-                Authorization: `Bearer ${this.config.publishableKey}`,
-                Accept: 'application/json',
-            },
+            headers,
         });
         const body = await response.json().catch(() => ({}));
         if (!response.ok) {

package/dist/config.d.ts

@@ -1,9 +1,12 @@
 export type CalyburPlan = 'starter' | 'professional' | 'enterprise';
+export declare const DEFAULT_PARTNER_API_BASE_URL = "https://api.calybur.com";
 export interface CalyburConfig {
     apiKey: string;
     baseUrl: string;
     publishableKey: string;
     plan: CalyburPlan;
+    gatewayMode: boolean;
 }
+export declare function isGatewayBaseUrl(baseUrl: string): boolean;
 export declare function loadConfig(env?: NodeJS.ProcessEnv): CalyburConfig;
 export declare function defaultLimitForPlan(plan: CalyburPlan): number;

package/dist/config.js

@@ -1,27 +1,34 @@
+export const DEFAULT_PARTNER_API_BASE_URL = 'https://api.calybur.com';
 const VALID_PLANS = ['starter', 'professional', 'enterprise'];
+export function isGatewayBaseUrl(baseUrl) {
+    try {
+        return new URL(baseUrl).hostname === 'api.calybur.com';
+    }
+    catch {
+        return false;
+    }
+}
 export function loadConfig(env = process.env) {
     const apiKey = env.CALYBUR_API_KEY?.trim();
-    const baseUrl = env.CALYBUR_API_BASE_URL?.trim().replace(/\/$/, '');
+    const baseUrl = (env.CALYBUR_API_BASE_URL?.trim() || DEFAULT_PARTNER_API_BASE_URL).replace(/\/$/, '');
     const publishableKey = env.CALYBUR_SUPABASE_PUBLISHABLE_KEY?.trim() ||
         env.CALYBUR_SUPABASE_ANON_KEY?.trim() ||
         '';
     const planRaw = (env.CALYBUR_PLAN?.trim().toLowerCase() || 'starter');
+    const gatewayMode = isGatewayBaseUrl(baseUrl);
     if (!apiKey) {
         throw new Error('CALYBUR_API_KEY is required');
     }
     if (!apiKey.startsWith('ezg_')) {
         throw new Error('CALYBUR_API_KEY must start with ezg_');
     }
-    if (!baseUrl) {
-        throw new Error('CALYBUR_API_BASE_URL is required');
-    }
-    if (!publishableKey) {
-        throw new Error('CALYBUR_SUPABASE_PUBLISHABLE_KEY is required (Supabase gateway auth for Edge Functions)');
+    if (!gatewayMode && !publishableKey) {
+        throw new Error('CALYBUR_SUPABASE_PUBLISHABLE_KEY is required when using a direct Supabase API URL');
     }
     if (!VALID_PLANS.includes(planRaw)) {
         throw new Error(`CALYBUR_PLAN must be one of: ${VALID_PLANS.join(', ')}`);
     }
-    return { apiKey, baseUrl, publishableKey, plan: planRaw };
+    return { apiKey, baseUrl, publishableKey, plan: planRaw, gatewayMode };
 }
 export function defaultLimitForPlan(plan) {
     if (plan === 'enterprise')

package/dist/errors.js

@@ -12,7 +12,7 @@ export function formatApiError(error) {
     if (error.status === 401) {
         const body = error.body;
         if (body?.code === 'UNAUTHORIZED_NO_AUTH_HEADER') {
-            return 'Missing Supabase publishable key. Set CALYBUR_SUPABASE_PUBLISHABLE_KEY in MCP config.';
+            return 'Gateway misconfigured. Use https://api.calybur.com or set CALYBUR_SUPABASE_PUBLISHABLE_KEY for direct Supabase access.';
         }
         return 'API key invalid or expired. Regenerate at Calybur Settings → API Keys.';
     }

package/dist/tools/docs.js

@@ -19,8 +19,9 @@ Create keys at Calybur Settings → API Keys.`,
     {
         title: 'MCP Setup',
         keywords: ['mcp', 'cursor', 'claude', 'setup', 'config'],
-        body: `Configure Cursor MCP with npx @calybur/mcp and env vars:
-CALYBUR_API_KEY, CALYBUR_API_BASE_URL (Supabase functions/v1 base), optional CALYBUR_PLAN (starter|professional|enterprise).`,
+        body: `Configure Cursor MCP with npx @calybur/mcp and env:
+CALYBUR_API_KEY (required). Optional: CALYBUR_PLAN (starter|professional|enterprise).
+Uses https://api.calybur.com gateway — no Supabase keys needed.`,
     },
     {
         title: 'Rate Limits',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@calybur/mcp",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "MCP server for Calybur payroll and HR Partner API",
   "type": "module",
   "license": "MIT",
@@ -26,10 +26,13 @@
     "access": "public"
   },
   "bin": {
-    "calybur-mcp": "./dist/index.js"
+    "calybur-mcp": "dist/index.js"
   },
   "main": "./dist/index.js",
-  "files": ["dist", "README.md"],
+  "files": [
+    "dist",
+    "README.md"
+  ],
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "dev": "tsx src/index.ts",