@insforge/mcp 1.1.7-dev.1 → 1.1.7-dev.10

package/dist/{chunk-CGHSBGKB.js → chunk-3KG7LI73.js}

@@ -161,10 +161,11 @@ var deleteTableResponse = z2.object({
 });
 var rawSQLRequestSchema = z2.object({
   query: z2.string().min(1, "Query is required"),
-  params: z2.array(z2.any()).optional()
+  params: z2.array(z2.unknown()).optional()
+  // z.unknown() generates JSON Schema with items: {}
 });
 var rawSQLResponseSchema = z2.object({
-  rows: z2.array(z2.any()),
+  rows: z2.array(z2.record(z2.string(), z2.unknown())),
   rowCount: z2.number().nullable(),
   fields: z2.array(z2.object({
     name: z2.string(),
@@ -222,7 +223,8 @@ var exportJsonDataSchema = z2.object({
       newTable: z2.string().nullable(),
       oldTable: z2.string().nullable()
     })),
-    rows: z2.array(z2.any()).optional()
+    rows: z2.array(z2.record(z2.string(), z2.unknown())).optional(),
+    recordCount: z2.number().optional()
   })),
   functions: z2.array(z2.object({
     functionName: z2.string(),
@@ -364,7 +366,19 @@ var userSchema = z5.object({
   updatedAt: z5.string()
   // PostgreSQL timestamp
 });
-var oAuthProvidersSchema = z5.enum(["google", "github"]);
+var oAuthProvidersSchema = z5.enum([
+  "google",
+  "github",
+  "discord",
+  "linkedin",
+  "facebook",
+  "instagram",
+  "tiktok",
+  "apple",
+  "x",
+  "spotify",
+  "microsoft"
+]);
 var oAuthStateSchema = z5.object({
   provider: oAuthProvidersSchema,
   redirectUri: z5.string().url().optional()
@@ -462,15 +476,20 @@ var authMetadataSchema = z7.object({
   oauths: z7.array(oAuthConfigSchema)
 });
 var databaseMetadataSchema = z7.object({
-  tables: z7.array(tableSchema),
-  totalSize: z7.number()
+  tables: z7.array(z7.object({
+    schema: z7.string(),
+    tableName: z7.string(),
+    recordCount: z7.number()
+  })),
+  totalSizeInGB: z7.number(),
+  hint: z7.string().optional()
 });
 var bucketMetadataSchema = storageBucketSchema.extend({
   objectCount: z7.number().optional()
 });
 var storageMetadataSchema = z7.object({
   buckets: z7.array(bucketMetadataSchema),
-  totalSize: z7.number()
+  totalSizeInGB: z7.number()
 });
 var edgeFunctionMetadataSchema = z7.object({
   slug: z7.string(),
@@ -583,44 +602,13 @@ var imageGenerationResponseSchema = z9.object({
     }).optional()
   }).optional()
 });
-var openRouterModelSchema = z9.object({
+var aiModelSchema = z9.object({
   id: z9.string(),
-  name: z9.string(),
-  created: z9.number(),
-  description: z9.string().optional(),
-  architecture: z9.object({
-    inputModalities: z9.array(z9.string()),
-    outputModalities: z9.array(z9.string()),
-    tokenizer: z9.string(),
-    instructType: z9.string()
-  }).optional(),
-  topProvider: z9.object({
-    isModerated: z9.boolean(),
-    contextLength: z9.number(),
-    maxCompletionTokens: z9.number()
-  }).optional(),
-  pricing: z9.object({
-    prompt: z9.string(),
-    completion: z9.string(),
-    image: z9.string().optional(),
-    request: z9.string().optional(),
-    webSearch: z9.string().optional(),
-    internalReasoning: z9.string().optional(),
-    inputCacheRead: z9.string().optional(),
-    inputCacheWrite: z9.string().optional()
-  })
-});
-var listModelsResponseSchema = z9.object({
-  text: z9.array(z9.object({
-    provider: z9.string(),
-    configured: z9.boolean(),
-    models: z9.array(openRouterModelSchema)
-  })),
-  image: z9.array(z9.object({
-    provider: z9.string(),
-    configured: z9.boolean(),
-    models: z9.array(openRouterModelSchema)
-  }))
+  inputModality: z9.array(modalitySchema).min(1),
+  outputModality: z9.array(modalitySchema).min(1),
+  provider: z9.string(),
+  modelId: z9.string(),
+  priceLevel: z9.number().min(0).max(3).optional()
 });
 var createAIConfigurationRequestSchema = aiConfigurationSchema.omit({
   id: true
@@ -656,6 +644,23 @@ var auditLogSchema = z10.object({
   createdAt: z10.string(),
   updatedAt: z10.string()
 });
+var logSourceSchema = z10.object({
+  id: z10.string(),
+  name: z10.string(),
+  token: z10.string()
+});
+var logSchema = z10.object({
+  id: z10.string(),
+  eventMessage: z10.string(),
+  timestamp: z10.string(),
+  body: z10.record(z10.string(), z10.unknown()),
+  source: z10.string().optional()
+});
+var logStatsSchema = z10.object({
+  source: z10.string(),
+  count: z10.number(),
+  lastActivity: z10.string()
+});
 
 // node_modules/@insforge/shared-schemas/dist/logs-api.schema.js
 import { z as z11 } from "zod";
@@ -693,6 +698,10 @@ var clearAuditLogsResponseSchema = z11.object({
   message: z11.string(),
   deleted: z11.number()
 });
+var getLogsResponseSchema = z11.object({
+  logs: z11.array(logSchema),
+  total: z11.number()
+});
 
 // node_modules/@insforge/shared-schemas/dist/functions.schema.js
 import { z as z12 } from "zod";
@@ -726,10 +735,74 @@ var functionUpdateRequestSchema = z13.object({
 
 // src/shared/tools.ts
 import FormData from "form-data";
+var TOOL_VERSION_REQUIREMENTS = {
+  "upsert-schedule": "1.1.1",
+  // 'get-schedules': '1.1.1',
+  // 'get-schedule-logs': '1.1.1',
+  "delete-schedule": "1.1.1"
+};
 function registerInsforgeTools(server, config = {}) {
   const GLOBAL_API_KEY = config.apiKey || process.env.API_KEY || "";
   const API_BASE_URL = config.apiBaseUrl || process.env.API_BASE_URL || "http://localhost:7130";
   const usageTracker = new UsageTracker(API_BASE_URL, GLOBAL_API_KEY);
+  let versionCache = null;
+  const VERSION_CACHE_TTL = 5 * 60 * 1e3;
+  async function getBackendVersion() {
+    const now = Date.now();
+    if (versionCache && now - versionCache.timestamp < VERSION_CACHE_TTL) {
+      return versionCache.version;
+    }
+    try {
+      const response = await fetch2(`${API_BASE_URL}/api/health`, {
+        method: "GET",
+        headers: {
+          "Content-Type": "application/json"
+        }
+      });
+      if (!response.ok) {
+        throw new Error(`Health check failed with status ${response.status}`);
+      }
+      const health = await response.json();
+      versionCache = {
+        version: health.version,
+        timestamp: now
+      };
+      return health.version;
+    } catch (error) {
+      const errMsg = error instanceof Error ? error.message : "Unknown error";
+      throw new Error(`Failed to fetch backend version: ${errMsg}`);
+    }
+  }
+  function compareVersions(v1, v2) {
+    const parts1 = v1.split(".").map(Number);
+    const parts2 = v2.split(".").map(Number);
+    for (let i = 0; i < Math.max(parts1.length, parts2.length); i++) {
+      const part1 = parts1[i] || 0;
+      const part2 = parts2[i] || 0;
+      if (part1 > part2) return 1;
+      if (part1 < part2) return -1;
+    }
+    return 0;
+  }
+  async function checkToolVersion(toolName) {
+    const requiredVersion = TOOL_VERSION_REQUIREMENTS[toolName];
+    if (!requiredVersion) {
+      return;
+    }
+    try {
+      const currentVersion = await getBackendVersion();
+      if (compareVersions(currentVersion, requiredVersion) < 0) {
+        throw new Error(
+          `Tool '${toolName}' requires backend version ${requiredVersion} or higher, but current version is ${currentVersion}. Please upgrade your Insforge backend server.`
+        );
+      }
+    } catch (error) {
+      if (error instanceof Error && error.message.includes("requires backend version")) {
+        throw error;
+      }
+      console.warn(`Warning: Could not verify backend version for tool '${toolName}': ${error instanceof Error ? error.message : "Unknown error"}`);
+    }
+  }
   async function trackToolUsage(toolName, success = true) {
     if (GLOBAL_API_KEY) {
       await usageTracker.trackUsage(toolName, success);
@@ -764,7 +837,8 @@ function registerInsforgeTools(server, config = {}) {
       const result = await handleApiResponse(response);
       if (result && typeof result === "object" && "content" in result) {
         let content = result.content;
-        content = content.replace(/http:\/\/localhost:7130/g, API_BASE_URL);
+        content = content.replace(/http:\/\/localhost:7130\/?/g, API_BASE_URL);
+        content = content.replace(/https:\/\/your-app\.region\.insforge\.app\/?/g, API_BASE_URL);
         return content;
       }
       throw new Error("Invalid response format from documentation endpoint");
@@ -774,12 +848,16 @@ function registerInsforgeTools(server, config = {}) {
     }
   };
   server.tool(
-    "get-instructions",
-    "Instruction Essential backend setup tool. <critical>MANDATORY: You MUST use this tool FIRST before attempting any backend operations. Contains required API endpoints, authentication details, and setup instructions.</critical>",
-    {},
-    withUsageTracking("get-instructions", async () => {
+    "fetch-docs",
+    'Fetch Insforge documentation. Use "instructions" for essential backend setup (MANDATORY FIRST), or select specific SDK docs for database, auth, storage, functions, or AI integration.',
+    {
+      docType: z14.enum(["instructions", "db-sdk", "storage-sdk", "functions-sdk", "ai-integration-sdk", "auth-components-nextjs", "auth-components-react"]).describe(
+        'Documentation type: "instructions" (essential backend setup - use FIRST), "db-sdk" (database operations), "storage-sdk" (file storage), "functions-sdk" (edge functions), "ai-integration-sdk" (AI features), "auth-components-nextjs" (authentication components for Next.js applications), "auth-components-react" (authentication components for React applications),'
+      )
+    },
+    withUsageTracking("fetch-docs", async ({ docType }) => {
       try {
-        const content = await fetchDocumentation("instructions");
+        const content = await fetchDocumentation(docType);
         return {
           content: [
             {
@@ -791,7 +869,46 @@ function registerInsforgeTools(server, config = {}) {
       } catch (error) {
         const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
         return {
-          content: [{ type: "text", text: `Error: ${errMsg}` }]
+          content: [{ type: "text", text: `Error fetching ${docType} documentation: ${errMsg}` }]
+        };
+      }
+    })
+  );
+  server.tool(
+    "get-anon-key",
+    "Generate an anonymous JWT token that never expires. Requires admin API key. Use this for client-side applications that need public access.",
+    {
+      apiKey: z14.string().optional().describe("API key for authentication (optional if provided via --api_key)")
+    },
+    withUsageTracking("get-anon-key", async ({ apiKey }) => {
+      try {
+        const actualApiKey = getApiKey(apiKey);
+        const response = await fetch2(`${API_BASE_URL}/api/auth/tokens/anon`, {
+          method: "POST",
+          headers: {
+            "x-api-key": actualApiKey,
+            "Content-Type": "application/json"
+          }
+        });
+        const result = await handleApiResponse(response);
+        return {
+          content: [
+            {
+              type: "text",
+              text: formatSuccessMessage("Anonymous token generated", result)
+            }
+          ]
+        };
+      } catch (error) {
+        const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Error generating anonymous token: ${errMsg}`
+            }
+          ],
+          isError: true
         };
       }
     })
@@ -1304,12 +1421,20 @@ ${JSON.stringify(metadata, null, 2)}`
         const actualApiKey = getApiKey(apiKey);
         const queryParams = new URLSearchParams();
         if (limit) queryParams.append("limit", limit.toString());
-        const response = await fetch2(`${API_BASE_URL}/api/logs/analytics/${source}?${queryParams}`, {
+        let response = await fetch2(`${API_BASE_URL}/api/logs/${source}?${queryParams}`, {
           method: "GET",
           headers: {
             "x-api-key": actualApiKey
           }
         });
+        if (response.status === 404) {
+          response = await fetch2(`${API_BASE_URL}/api/logs/analytics/${source}?${queryParams}`, {
+            method: "GET",
+            headers: {
+              "x-api-key": actualApiKey
+            }
+          });
+        }
         const result = await handleApiResponse(response);
         return {
           content: [
@@ -1333,10 +1458,114 @@ ${JSON.stringify(metadata, null, 2)}`
       }
     })
   );
+  server.tool(
+    "upsert-schedule",
+    "Create or update a cron job schedule. If id is provided, updates existing schedule; otherwise creates a new one.",
+    {
+      apiKey: z14.string().optional().describe("API key for authentication (optional if provided via --api_key)"),
+      id: z14.string().uuid().optional().describe("The UUID of the schedule to update. If omitted, a new schedule will be created."),
+      name: z14.string().min(3).describe("Schedule name (at least 3 characters)"),
+      cronSchedule: z14.string().describe('Cron schedule format (5 or 6 parts, e.g., "0 */2 * * *" for every 2 hours)'),
+      functionUrl: z14.string().url().describe("The URL to call when the schedule triggers"),
+      httpMethod: z14.enum(["GET", "POST", "PUT", "PATCH", "DELETE"]).optional().default("POST").describe("HTTP method to use"),
+      headers: z14.record(z14.string()).optional().describe('HTTP headers. Values starting with "secret:" will be resolved from secrets store.'),
+      body: z14.record(z14.unknown()).optional().describe("JSON body to send with the request")
+    },
+    withUsageTracking("upsert-schedule", async ({ apiKey, id, name, cronSchedule, functionUrl, httpMethod, headers, body }) => {
+      try {
+        await checkToolVersion("upsert-schedule");
+        const actualApiKey = getApiKey(apiKey);
+        const requestBody = {
+          name,
+          cronSchedule,
+          functionUrl,
+          httpMethod: httpMethod || "POST"
+        };
+        if (id) {
+          requestBody.id = id;
+        }
+        if (headers) {
+          requestBody.headers = headers;
+        }
+        if (body) {
+          requestBody.body = body;
+        }
+        const response = await fetch2(`${API_BASE_URL}/api/schedules`, {
+          method: "POST",
+          headers: {
+            "x-api-key": actualApiKey,
+            "Content-Type": "application/json"
+          },
+          body: JSON.stringify(requestBody)
+        });
+        const result = await handleApiResponse(response);
+        const action = id ? "updated" : "created";
+        return {
+          content: [
+            {
+              type: "text",
+              text: formatSuccessMessage(`Schedule '${name}' ${action} successfully`, result)
+            }
+          ]
+        };
+      } catch (error) {
+        const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Error upserting schedule: ${errMsg}`
+            }
+          ],
+          isError: true
+        };
+      }
+    })
+  );
+  server.tool(
+    "delete-schedule",
+    "Delete a cron job schedule permanently",
+    {
+      apiKey: z14.string().optional().describe("API key for authentication (optional if provided via --api_key)"),
+      scheduleId: z14.string().uuid().describe("The UUID of the schedule to delete")
+    },
+    withUsageTracking("delete-schedule", async ({ apiKey, scheduleId }) => {
+      try {
+        await checkToolVersion("delete-schedule");
+        const actualApiKey = getApiKey(apiKey);
+        const response = await fetch2(`${API_BASE_URL}/api/schedules/${scheduleId}`, {
+          method: "DELETE",
+          headers: {
+            "x-api-key": actualApiKey
+          }
+        });
+        const result = await handleApiResponse(response);
+        return {
+          content: [
+            {
+              type: "text",
+              text: formatSuccessMessage(`Schedule ${scheduleId} deleted successfully`, result)
+            }
+          ]
+        };
+      } catch (error) {
+        const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Error deleting schedule: ${errMsg}`
+            }
+          ],
+          isError: true
+        };
+      }
+    })
+  );
   return {
     apiKey: GLOBAL_API_KEY,
     apiBaseUrl: API_BASE_URL,
-    toolCount: 14
+    toolCount: 16
   };
 }
 

package/dist/http-server.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   registerInsforgeTools
-} from "./chunk-CGHSBGKB.js";
+} from "./chunk-3KG7LI73.js";
 
 // src/http/server.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   registerInsforgeTools
-} from "./chunk-CGHSBGKB.js";
+} from "./chunk-3KG7LI73.js";
 
 // src/stdio/index.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@insforge/mcp",
-  "version": "1.1.7-dev.1",
+  "version": "1.1.7-dev.10",
   "description": "MCP (Model Context Protocol) server for Insforge backend-as-a-service",
+  "mcpName": "io.github.InsForge/insforge-mcp",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
@@ -31,10 +32,11 @@
   },
   "files": [
     "dist",
-    "mcp.json"
+    "mcp.json",
+    "server.json"
   ],
   "dependencies": {
-    "@insforge/shared-schemas": "^1.1.1",
+    "@insforge/shared-schemas": "^1.1.7",
     "@modelcontextprotocol/sdk": "^1.15.1",
     "@types/express": "^5.0.3",
     "commander": "^14.0.0",

package/server.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-10-17/server.schema.json",
+  "name": "io.github.InsForge/insforge-mcp",
+  "title": "Insforge",
+  "description": "MCP server for Insforge BaaS - database, auth, storage, edge functions, and container logs",
+  "version": "1.1.5",
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "@insforge/mcp",
+      "version": "1.1.5",
+      "transport": {
+        "type": "stdio"
+      }
+    }
+  ]
+}