feat: add Inception Mercury provider

Integrate the Inception Labs Mercury 2 provider with settings, schema updates,
and migrations. Update provider-aware configs and docs to reflect the new
provider and reasoning options.

Made-with: Cursor

Author: unstackedapps-admin

CHANGELOG.md

@@ -5,6 +5,22 @@ All notable changes to OpenSuiteMCP will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.4.0] - 2026-02-28
+
+### ✨ Added
+
+- **Inception Labs provider**
+  - Added Mercury 2 as a selectable provider for speed and enhanced reasoning
+  - New Inception API key support in Settings and user configuration
+  - OpenAI-compatible chat completions integration with Mercury 2
+  - Reasoning effort parameters forwarded for Mercury 2 reasoning mode
+
+### 🧰 Technical
+
+- Added `@ai-sdk/openai-compatible` for Inception Labs integration
+
+---
+
 ## [2.3.0] - 2026-01-30
 
 ### ✨ Added
@@ -344,6 +360,7 @@ First stable release of OpenSuiteMCP - an open source, production-ready NetSuite
 
 ---
 
+[2.4.0]: https://github.com/unstackedapps/opensuitemcp/releases/tag/v2.4.0
 [2.3.0]: https://github.com/unstackedapps/opensuitemcp/releases/tag/v2.3.0
 [2.2.0]: https://github.com/unstackedapps/opensuitemcp/releases/tag/v2.2.0
 [2.1.0]: https://github.com/unstackedapps/opensuitemcp/releases/tag/v2.1.0

README.md

@@ -1,18 +1,18 @@
 # <img src="./app/icon.svg" alt="OpenSuiteMCP Icon" width="24" height="24" /><span style="font-weight: 200;"> OpenSuite</span>MCP NetSuite AI Assistant
 
-An AI-powered chat assistant that integrates with NetSuite via MCP (Model Context Protocol), enabling natural language interactions with your NetSuite data. Built with Next.js, Vercel AI SDK, and supporting multiple AI providers (Google Gemini, Anthropic Claude, and OpenAI GPT).
+An AI-powered chat assistant that integrates with NetSuite via MCP (Model Context Protocol), enabling natural language interactions with your NetSuite data. Built with Next.js, Vercel AI SDK, and supporting multiple AI providers (Google Gemini, Anthropic Claude, OpenAI GPT, and Inception Labs Mercury).
 
 <img src="./docs/screenshot1.png" alt="OpenSuiteMCP Main UI" width="100%" />
 
-*Chat interface in dark mode showing the welcome prompt and main UI.*
+_Chat interface in dark mode showing the welcome prompt and main UI._
 
 ### NetSuite MCP Tool Integration
 
 The assistant seamlessly integrates with NetSuite's MCP tools to execute complex queries and retrieve real-time data directly from your NetSuite instance.
 
 <img src="./docs/screenshot2.png" alt="NetSuite MCP Tool Usage" width="100%" />
 
-*Example query requesting the top ten customers by sales order count, demonstrating the power of NetSuite MCP tool usage in the app.*
+_Example query requesting the top ten customers by sales order count, demonstrating the power of NetSuite MCP tool usage in the app._
 
 ## Quick Start
 
@@ -52,8 +52,9 @@ The assistant seamlessly integrates with NetSuite's MCP tools to execute complex
 
 5. **Configure your API key:**
    - Open the **Settings** modal from the sidebar
-   - Enter your AI provider API key (Google, Anthropic, or OpenAI)
-   - API keys are encrypted and stored securely in your database
+
+- Enter your AI provider API key (Google, Anthropic, OpenAI, or Inception Labs)
+- API keys are encrypted and stored securely in your database
 
 The app will be running at [http://localhost:3000](http://localhost:3000).
 

app/(chat)/actions.ts

@@ -43,7 +43,7 @@ export async function generateTitleFromUserMessage({
 }: {
   message: UIMessage;
   apiKey?: string | null;
-  provider?: "google" | "anthropic" | "openai";
+  provider?: "google" | "anthropic" | "openai" | "inception";
 }): Promise<{ title: string; summary: string | null }> {
   const text = getTextFromMessage(message);
 

app/api/chat/route.ts

@@ -117,19 +117,25 @@ export async function POST(request: Request) {
     } else {
       // Get user API key and provider for title generation
       let titleApiKey: string | null = null;
-      let titleProvider: "google" | "anthropic" | "openai" = "google";
+      let titleProvider: "google" | "anthropic" | "openai" | "inception" =
+        "google";
       if (session.user?.id) {
         try {
           const settings = await getUserSettings({ userId: session.user.id });
           titleProvider =
-            (settings?.aiProvider as "google" | "anthropic" | "openai") ||
-            "google";
+            (settings?.aiProvider as
+              | "google"
+              | "anthropic"
+              | "openai"
+              | "inception") || "google";
           const apiKeyField =
             titleProvider === "anthropic"
               ? settings?.anthropicApiKey
               : titleProvider === "openai"
                 ? settings?.openaiApiKey
-                : settings?.googleApiKey;
+                : titleProvider === "inception"
+                  ? settings?.inceptionApiKey
+                  : settings?.googleApiKey;
           if (apiKeyField) {
             titleApiKey = decrypt(apiKeyField);
           }
@@ -187,7 +193,11 @@ export async function POST(request: Request) {
         try {
           // Get user settings (API key, provider, timezone, and maxIterations)
           let userApiKey: string | null = null;
-          let userProviderType: "google" | "anthropic" | "openai" = "google";
+          let userProviderType:
+            | "google"
+            | "anthropic"
+            | "openai"
+            | "inception" = "google";
           let userTimezone = "UTC";
           let userMaxIterations = 10; // Default to 10
           let selectedSearchDomainIds: string[] = [];
@@ -203,12 +213,16 @@ export async function POST(request: Request) {
                 hasGoogleKey: !!settings?.googleApiKey,
                 hasAnthropicKey: !!settings?.anthropicApiKey,
                 hasOpenAIKey: !!settings?.openaiApiKey,
+                hasInceptionKey: !!settings?.inceptionApiKey,
                 maxIterations: settings?.maxIterations,
               });
               if (settings) {
                 userProviderType =
-                  (settings.aiProvider as "google" | "anthropic" | "openai") ||
-                  "google";
+                  (settings.aiProvider as
+                    | "google"
+                    | "anthropic"
+                    | "openai"
+                    | "inception") || "google";
                 // Parse maxIterations, default to 10 if invalid
                 const maxIterationsValue = settings.maxIterations
                   ? Number.parseInt(settings.maxIterations, 10)
@@ -226,7 +240,9 @@ export async function POST(request: Request) {
                     ? settings.anthropicApiKey
                     : userProviderType === "openai"
                       ? settings.openaiApiKey
-                      : settings.googleApiKey;
+                      : userProviderType === "inception"
+                        ? settings.inceptionApiKey
+                        : settings.googleApiKey;
 
                 if (apiKeyField) {
                   try {
@@ -277,7 +293,13 @@ export async function POST(request: Request) {
           } catch (error) {
             // If no API key is configured, return an error to the user
             const providerName =
-              userProviderType === "anthropic" ? "Anthropic" : "Google";
+              userProviderType === "anthropic"
+                ? "Anthropic"
+                : userProviderType === "openai"
+                  ? "OpenAI"
+                  : userProviderType === "inception"
+                    ? "Inception Labs"
+                    : "Google";
             const errorMessage =
               error instanceof Error
                 ? error.message
@@ -433,34 +455,51 @@ export async function POST(request: Request) {
               tools: allToolsWithConfig,
               // Apply reasoning/thinking config based on provider
               // Both use similar token budgets (4K) for thinking/reasoning
-              ...(modelId === "chat-model-reasoning" && {
-                providerOptions:
-                  userProviderType === "google"
-                    ? {
+              ...(modelId === "chat-model-reasoning" &&
+                (userProviderType === "google"
+                  ? {
+                      providerOptions: {
                         google: {
                           thinkingConfig: {
                             thinkingBudget: 4096, // Allocates 4K tokens for thought
                             includeThoughts: true,
                           },
                         },
-                      }
-                    : userProviderType === "anthropic"
-                      ? {
+                      },
+                    }
+                  : userProviderType === "anthropic"
+                    ? {
+                        providerOptions: {
                           anthropic: {
                             thinking: {
                               type: "enabled",
                               budgetTokens: 4096, // Matches Google's 4K token budget
                             },
                           },
-                        }
-                      : {
-                          // OpenAI reasoning configuration for o4-mini
-                          openai: {
-                            reasoningEffort: "high", // Equivalent to adjusting thinking budget
-                            reasoningSummary: "detailed", // Show thought process in UI
-                          },
                         },
-              }),
+                      }
+                    : userProviderType === "openai"
+                      ? {
+                          providerOptions: {
+                            // OpenAI reasoning configuration for o4-mini
+                            openai: {
+                              reasoningEffort: "high", // Equivalent to adjusting thinking budget
+                              reasoningSummary: "detailed", // Show thought process in UI
+                            },
+                          },
+                        }
+                      : userProviderType === "inception"
+                        ? {
+                            providerOptions: {
+                              // Inception Labs reasoning configuration for Mercury 2
+                              inception: {
+                                reasoningEffort: "high",
+                                reasoning_summary: true,
+                                reasoning_summary_wait: false,
+                              },
+                            },
+                          }
+                        : {})),
               experimental_telemetry: {
                 isEnabled: isProductionEnvironment,
                 functionId: "stream-text",

app/api/settings/route.ts

@@ -8,7 +8,11 @@ const settingsSchema = z.object({
   googleApiKey: z.string().optional().nullable(),
   anthropicApiKey: z.string().optional().nullable(),
   openaiApiKey: z.string().optional().nullable(),
-  aiProvider: z.enum(["google", "anthropic", "openai"]).optional().nullable(),
+  inceptionApiKey: z.string().optional().nullable(),
+  aiProvider: z
+    .enum(["google", "anthropic", "openai", "inception"])
+    .optional()
+    .nullable(),
   netsuiteAccountId: z.string().max(64).optional().nullable(),
   netsuiteClientId: z.string().max(128).optional().nullable(),
   timezone: z.string().max(64).optional().nullable(),
@@ -39,6 +43,7 @@ export async function GET() {
       hasGoogleKey: !!settings?.googleApiKey,
       hasAnthropicKey: !!settings?.anthropicApiKey,
       hasOpenAIKey: !!settings?.openaiApiKey,
+      hasInceptionKey: !!settings?.inceptionApiKey,
       aiProvider: settings?.aiProvider,
     });
 
@@ -47,6 +52,7 @@ export async function GET() {
         googleApiKey: null,
         anthropicApiKey: null,
         openaiApiKey: null,
+        inceptionApiKey: null,
         aiProvider: "google",
         netsuiteAccountId: null,
         netsuiteClientId: null,
@@ -105,18 +111,36 @@ export async function GET() {
       console.log("[Settings API] No OpenAI key in DB");
     }
 
+    let decryptedInceptionKey: string | null = null;
+    if (settings.inceptionApiKey) {
+      try {
+        decryptedInceptionKey = decrypt(settings.inceptionApiKey);
+        console.log("[Settings API] Successfully decrypted Inception key");
+      } catch (error) {
+        console.error(
+          "[Settings API] Error decrypting Inception API key on GET:",
+          error,
+        );
+        decryptedInceptionKey = null;
+      }
+    } else {
+      console.log("[Settings API] No Inception key in DB");
+    }
+
     // Ensure aiProvider is always a valid value
     const provider =
       settings.aiProvider === "google" ||
       settings.aiProvider === "anthropic" ||
-      settings.aiProvider === "openai"
+      settings.aiProvider === "openai" ||
+      settings.aiProvider === "inception"
         ? settings.aiProvider
         : "google";
 
     const response = {
       googleApiKey: decryptedGoogleKey,
       anthropicApiKey: decryptedAnthropicKey,
       openaiApiKey: decryptedOpenAIKey,
+      inceptionApiKey: decryptedInceptionKey,
       aiProvider: provider,
       netsuiteAccountId: settings.netsuiteAccountId,
       netsuiteClientId: settings.netsuiteClientId,
@@ -129,10 +153,12 @@ export async function GET() {
       hasGoogleKey: !!response.googleApiKey,
       hasAnthropicKey: !!response.anthropicApiKey,
       hasOpenAIKey: !!response.openaiApiKey,
+      hasInceptionKey: !!response.inceptionApiKey,
       aiProvider: response.aiProvider,
       googleKeyLength: response.googleApiKey?.length ?? 0,
       anthropicKeyLength: response.anthropicApiKey?.length ?? 0,
       openaiKeyLength: response.openaiApiKey?.length ?? 0,
+      inceptionKeyLength: response.inceptionApiKey?.length ?? 0,
     });
 
     return NextResponse.json(response);
@@ -234,11 +260,39 @@ export async function POST(request: Request) {
       encryptedOpenAIKey = existing.openaiApiKey;
     }
 
+    // Encrypt Inception API key if provided
+    let encryptedInceptionKey: string | null | undefined;
+    if (validated.inceptionApiKey !== undefined) {
+      const trimmedKey = validated.inceptionApiKey?.trim();
+      if (trimmedKey) {
+        try {
+          encryptedInceptionKey = encrypt(trimmedKey);
+        } catch (error) {
+          console.error(
+            "[Settings] Error encrypting Inception API key:",
+            error,
+          );
+          return NextResponse.json(
+            {
+              error:
+                "Failed to encrypt Inception API key. Please check ENCRYPTION_KEY environment variable.",
+            },
+            { status: 500 },
+          );
+        }
+      } else {
+        encryptedInceptionKey = null;
+      }
+    } else if (existing?.inceptionApiKey) {
+      encryptedInceptionKey = existing.inceptionApiKey;
+    }
+
     await upsertUserSettings({
       userId: session.user.id,
       googleApiKey: encryptedGoogleKey,
       anthropicApiKey: encryptedAnthropicKey,
       openaiApiKey: encryptedOpenAIKey,
+      inceptionApiKey: encryptedInceptionKey,
       aiProvider: validated.aiProvider,
       netsuiteAccountId: validated.netsuiteAccountId,
       netsuiteClientId: validated.netsuiteClientId,

app/layout.tsx

@@ -10,7 +10,7 @@ export const metadata: Metadata = {
   metadataBase: new URL("https://chat.vercel.ai"),
   title: "OpenSuiteMCP",
   description:
-    "OpenSuiteMCP NetSuite AI Assistant, powered by Gemini and Next.js",
+    "OpenSuiteMCP NetSuite AI Assistant, powered by Gemini, Claude, GPT, and Mercury",
 };
 
 export const viewport = {

components/chat.tsx

@@ -338,6 +338,7 @@ export function Chat({
         /responseBody/i,
         /api\.openai\.com/i,
         /api\.anthropic\.com/i,
+        /api\.inceptionlabs\.ai/i,
         /generativeai\.googleapis\.com/i,
       ];
 

components/model-selector.tsx

@@ -26,7 +26,8 @@ async function fetchSettings() {
     aiProvider: (data.aiProvider || "google") as
       | "google"
       | "anthropic"
-      | "openai",
+      | "openai"
+      | "inception",
   };
 }
 

components/multimodal-input.tsx

@@ -279,7 +279,8 @@ async function fetchSettings() {
     aiProvider: (data.aiProvider || "google") as
       | "google"
       | "anthropic"
-      | "openai",
+      | "openai"
+      | "inception",
   };
 }