integrate-sdk 0.9.27-dev.0 → 0.9.27-dev.2

package/README.md

@@ -132,6 +132,88 @@ const result = await client.github.createIssue({
 console.log("Issue created:", result);
 ```
 
+### API Key Integrations
+
+Use API-key integrations like Granola by passing the credential directly to the integration helper:
+
+```typescript
+import { createMCPClient, granolaIntegration } from "integrate-sdk";
+
+const client = createMCPClient({
+  integrations: [
+    granolaIntegration({
+      apiKey: process.env.GRANOLA_API_KEY!,
+    }),
+  ],
+});
+
+const notes = await client.callTool("granola_list_notes", {
+  page_size: 10,
+});
+
+const note = await client.callTool("granola_get_note", {
+  note_id: "not_123",
+  include_transcript: true,
+});
+
+const folders = await client.callTool("granola_list_folders", {
+  page_size: 10,
+});
+```
+
+Mercury uses the same API-token pattern:
+
+```typescript
+import { createMCPClient, mercuryIntegration } from "integrate-sdk";
+
+const client = createMCPClient({
+  integrations: [
+    mercuryIntegration({
+      apiKey: process.env.MERCURY_API_KEY!,
+    }),
+  ],
+});
+
+const org = await client.callTool("mercury_get_organization");
+const accounts = await client.callTool("mercury_list_accounts", {
+  limit: 50,
+});
+const txns = await client.callTool("mercury_list_transactions", {
+  start: "2026-01-01",
+  end: "2026-01-31",
+  limit: 100,
+});
+```
+
+### OAuth File Storage Integrations
+
+Dropbox follows the standard OAuth integration flow:
+
+```typescript
+import { createMCPClient, dropboxIntegration } from "integrate-sdk";
+
+const client = createMCPClient({
+  integrations: [
+    dropboxIntegration({
+      scopes: [
+        "account_info.read",
+        "files.metadata.read",
+        "files.content.read",
+        "files.content.write",
+        "sharing.read",
+        "sharing.write",
+      ],
+    }),
+  ],
+});
+
+const account = await client.callTool("dropbox_get_current_account");
+const files = await client.callTool("dropbox_list_folder", {
+  path: "/",
+  limit: 50,
+});
+```
+
 **That's it!** The SDK automatically:
 
 - ✅ Connects on first method call (no manual `connect()` needed)

package/dist/adapters/index.js

@@ -2737,6 +2737,34 @@ class OAuthManager {
 
 // ../client.ts
 var CLIENT_LOG_CONTEXT = "client";
+var NON_TOOL_PROXY_PROPERTIES = new Set([
+  "then",
+  "catch",
+  "finally",
+  "constructor",
+  "prototype",
+  "toString",
+  "valueOf",
+  "toJSON",
+  "inspect",
+  "hasOwnProperty",
+  "isPrototypeOf",
+  "propertyIsEnumerable",
+  "__proto__",
+  "__defineGetter__",
+  "__defineSetter__",
+  "__lookupGetter__",
+  "__lookupSetter__",
+  "__esModule",
+  Symbol.toStringTag,
+  Symbol.toPrimitive,
+  Symbol.iterator,
+  Symbol.asyncIterator,
+  Symbol.for("nodejs.util.inspect.custom")
+]);
+function isToolProxyProperty(property) {
+  return typeof property === "string" && !NON_TOOL_PROXY_PROPERTIES.has(property);
+}
 
 class SimpleEventEmitter {
   handlers = new Map;
@@ -2959,6 +2987,8 @@ class MCPClientBase {
     }
     return new Proxy({}, {
       get: (_target, methodName) => {
+        if (!isToolProxyProperty(methodName))
+          return;
         return async (args, options) => {
           const toolName = methodToToolName(methodName, integrationId);
           return await this.callToolWithRetry(toolName, args, 0, options);
@@ -2972,6 +3002,8 @@ class MCPClientBase {
   createServerProxy() {
     return new Proxy({}, {
       get: (_target, methodName) => {
+        if (!isToolProxyProperty(methodName))
+          return;
         if (methodName === "listConfiguredIntegrations") {
           return async (options) => {
             const transportHeaders = this.transport.headers || {};
@@ -3192,6 +3224,9 @@ class MCPClientBase {
   async _callToolByName(name, args, options) {
     return await this.callToolWithRetry(name, args, 0, options);
   }
+  async callTool(name, args, options) {
+    return await this.callToolWithRetry(name, args, 0, options);
+  }
   async callServerTool(name, args) {
     try {
       const response = await this.callToolThroughHandler(name, args);
@@ -3202,35 +3237,38 @@ class MCPClientBase {
     }
   }
   async callToolThroughHandler(name, args, provider, options) {
+    const integrationHeaders = this.getHeadersForTool(name);
     const transportHeaders = this.transport.headers || {};
     const hasApiKey = !!transportHeaders["X-API-KEY"];
     if (hasApiKey) {
       await this.ensureConnected();
+      const temporaryHeaders = { ...integrationHeaders };
       if (provider) {
         const tokenData = await this.oauthManager.getProviderToken(provider, undefined, options?.context);
-        if (tokenData && this.transport.setHeader) {
-          const previousAuthHeader = transportHeaders["Authorization"];
-          try {
-            this.transport.setHeader("Authorization", `Bearer ${tokenData.accessToken}`);
-            const result3 = await this.transport.sendRequest("tools/call", {
-              name,
-              arguments: args || {}
-            });
-            return result3;
-          } finally {
-            if (previousAuthHeader && this.transport.setHeader) {
-              this.transport.setHeader("Authorization", previousAuthHeader);
-            } else if (this.transport.removeHeader) {
-              this.transport.removeHeader("Authorization");
-            }
+        if (tokenData) {
+          temporaryHeaders["Authorization"] = `Bearer ${tokenData.accessToken}`;
+        }
+      }
+      const previousHeaders = new Map;
+      for (const [key, value] of Object.entries(temporaryHeaders)) {
+        previousHeaders.set(key, transportHeaders[key]);
+        this.transport.setHeader(key, value);
+      }
+      try {
+        const result2 = await this.transport.sendRequest("tools/call", {
+          name,
+          arguments: args || {}
+        });
+        return result2;
+      } finally {
+        for (const [key, previousValue] of previousHeaders.entries()) {
+          if (previousValue !== undefined) {
+            this.transport.setHeader(key, previousValue);
+          } else {
+            this.transport.removeHeader(key);
           }
         }
       }
-      const result2 = await this.transport.sendRequest("tools/call", {
-        name,
-        arguments: args || {}
-      });
-      return result2;
     }
     const url = this.apiBaseUrl ? `${this.apiBaseUrl}${this.apiRouteBase}/mcp` : `${this.apiRouteBase}/mcp`;
     const headers = {
@@ -3240,6 +3278,7 @@ class MCPClientBase {
     if (integrationsHeader) {
       headers["X-Integrations"] = integrationsHeader;
     }
+    Object.assign(headers, integrationHeaders);
     if (provider) {
       const tokenData = await this.oauthManager.getProviderToken(provider, undefined, options?.context);
       if (tokenData) {
@@ -3329,6 +3368,14 @@ class MCPClientBase {
     }
     return;
   }
+  getHeadersForTool(toolName) {
+    for (const integration of this.integrations) {
+      if (integration.tools.includes(toolName) && integration.getHeaders) {
+        return integration.getHeaders();
+      }
+    }
+    return {};
+  }
   getTool(name) {
     return this.availableTools.get(name);
   }
@@ -3709,45 +3756,48 @@ var logger22 = createLogger("Ramp");
 // ../integrations/onedrive.ts
 init_logger();
 var logger23 = createLogger("OneDrive");
+// ../integrations/dropbox.ts
+init_logger();
+var logger24 = createLogger("Dropbox");
 // ../integrations/word.ts
 init_logger();
-var logger24 = createLogger("Word");
+var logger25 = createLogger("Word");
 // ../integrations/excel.ts
 init_logger();
-var logger25 = createLogger("Excel");
+var logger26 = createLogger("Excel");
 // ../integrations/powerpoint.ts
 init_logger();
-var logger26 = createLogger("PowerPoint");
+var logger27 = createLogger("PowerPoint");
 // ../integrations/gdocs.ts
 init_logger();
-var logger27 = createLogger("Google Docs");
+var logger28 = createLogger("Google Docs");
 // ../integrations/gdrive.ts
 init_logger();
-var logger28 = createLogger("Google Drive");
+var logger29 = createLogger("Google Drive");
 // ../integrations/gsheets.ts
 init_logger();
-var logger29 = createLogger("Google Sheets");
+var logger30 = createLogger("Google Sheets");
 // ../integrations/gslides.ts
 init_logger();
-var logger30 = createLogger("Google Slides");
+var logger31 = createLogger("Google Slides");
 // ../integrations/polar.ts
 init_logger();
-var logger31 = createLogger("Polar");
+var logger32 = createLogger("Polar");
 // ../integrations/figma.ts
 init_logger();
-var logger32 = createLogger("Figma");
+var logger33 = createLogger("Figma");
 // ../integrations/intercom.ts
 init_logger();
-var logger33 = createLogger("Intercom");
+var logger34 = createLogger("Intercom");
 // ../integrations/hubspot.ts
 init_logger();
-var logger34 = createLogger("HubSpot");
+var logger35 = createLogger("HubSpot");
 // ../integrations/youtube.ts
 init_logger();
-var logger35 = createLogger("YouTube");
+var logger36 = createLogger("YouTube");
 // ../integrations/cursor.ts
 init_logger();
-var logger36 = createLogger("Cursor");
+var logger37 = createLogger("Cursor");
 // ../ai/trigger-tools.ts
 init_utils();
 
@@ -3766,7 +3816,7 @@ init_tool_builder();
 init_tool_builder();
 // ../server.ts
 var SERVER_LOG_CONTEXT3 = "server";
-var logger37 = createLogger("MCPServer", SERVER_LOG_CONTEXT3);
+var logger38 = createLogger("MCPServer", SERVER_LOG_CONTEXT3);
 var codeVerifierStorage = new Map;
 var unauthenticatedCodeModeWarnings = new Set;
 function toSolidStartHandler(clientOrHandlerOrOptions, _redirectOptions) {

package/dist/adapters/solid-start.js

@@ -2737,6 +2737,34 @@ class OAuthManager {
 
 // ../client.ts
 var CLIENT_LOG_CONTEXT = "client";
+var NON_TOOL_PROXY_PROPERTIES = new Set([
+  "then",
+  "catch",
+  "finally",
+  "constructor",
+  "prototype",
+  "toString",
+  "valueOf",
+  "toJSON",
+  "inspect",
+  "hasOwnProperty",
+  "isPrototypeOf",
+  "propertyIsEnumerable",
+  "__proto__",
+  "__defineGetter__",
+  "__defineSetter__",
+  "__lookupGetter__",
+  "__lookupSetter__",
+  "__esModule",
+  Symbol.toStringTag,
+  Symbol.toPrimitive,
+  Symbol.iterator,
+  Symbol.asyncIterator,
+  Symbol.for("nodejs.util.inspect.custom")
+]);
+function isToolProxyProperty(property) {
+  return typeof property === "string" && !NON_TOOL_PROXY_PROPERTIES.has(property);
+}
 
 class SimpleEventEmitter {
   handlers = new Map;
@@ -2959,6 +2987,8 @@ class MCPClientBase {
     }
     return new Proxy({}, {
       get: (_target, methodName) => {
+        if (!isToolProxyProperty(methodName))
+          return;
         return async (args, options) => {
           const toolName = methodToToolName(methodName, integrationId);
           return await this.callToolWithRetry(toolName, args, 0, options);
@@ -2972,6 +3002,8 @@ class MCPClientBase {
   createServerProxy() {
     return new Proxy({}, {
       get: (_target, methodName) => {
+        if (!isToolProxyProperty(methodName))
+          return;
         if (methodName === "listConfiguredIntegrations") {
           return async (options) => {
             const transportHeaders = this.transport.headers || {};
@@ -3192,6 +3224,9 @@ class MCPClientBase {
   async _callToolByName(name, args, options) {
     return await this.callToolWithRetry(name, args, 0, options);
   }
+  async callTool(name, args, options) {
+    return await this.callToolWithRetry(name, args, 0, options);
+  }
   async callServerTool(name, args) {
     try {
       const response = await this.callToolThroughHandler(name, args);
@@ -3202,35 +3237,38 @@ class MCPClientBase {
     }
   }
   async callToolThroughHandler(name, args, provider, options) {
+    const integrationHeaders = this.getHeadersForTool(name);
     const transportHeaders = this.transport.headers || {};
     const hasApiKey = !!transportHeaders["X-API-KEY"];
     if (hasApiKey) {
       await this.ensureConnected();
+      const temporaryHeaders = { ...integrationHeaders };
       if (provider) {
         const tokenData = await this.oauthManager.getProviderToken(provider, undefined, options?.context);
-        if (tokenData && this.transport.setHeader) {
-          const previousAuthHeader = transportHeaders["Authorization"];
-          try {
-            this.transport.setHeader("Authorization", `Bearer ${tokenData.accessToken}`);
-            const result3 = await this.transport.sendRequest("tools/call", {
-              name,
-              arguments: args || {}
-            });
-            return result3;
-          } finally {
-            if (previousAuthHeader && this.transport.setHeader) {
-              this.transport.setHeader("Authorization", previousAuthHeader);
-            } else if (this.transport.removeHeader) {
-              this.transport.removeHeader("Authorization");
-            }
+        if (tokenData) {
+          temporaryHeaders["Authorization"] = `Bearer ${tokenData.accessToken}`;
+        }
+      }
+      const previousHeaders = new Map;
+      for (const [key, value] of Object.entries(temporaryHeaders)) {
+        previousHeaders.set(key, transportHeaders[key]);
+        this.transport.setHeader(key, value);
+      }
+      try {
+        const result2 = await this.transport.sendRequest("tools/call", {
+          name,
+          arguments: args || {}
+        });
+        return result2;
+      } finally {
+        for (const [key, previousValue] of previousHeaders.entries()) {
+          if (previousValue !== undefined) {
+            this.transport.setHeader(key, previousValue);
+          } else {
+            this.transport.removeHeader(key);
           }
         }
       }
-      const result2 = await this.transport.sendRequest("tools/call", {
-        name,
-        arguments: args || {}
-      });
-      return result2;
     }
     const url = this.apiBaseUrl ? `${this.apiBaseUrl}${this.apiRouteBase}/mcp` : `${this.apiRouteBase}/mcp`;
     const headers = {
@@ -3240,6 +3278,7 @@ class MCPClientBase {
     if (integrationsHeader) {
       headers["X-Integrations"] = integrationsHeader;
     }
+    Object.assign(headers, integrationHeaders);
     if (provider) {
       const tokenData = await this.oauthManager.getProviderToken(provider, undefined, options?.context);
       if (tokenData) {
@@ -3329,6 +3368,14 @@ class MCPClientBase {
     }
     return;
   }
+  getHeadersForTool(toolName) {
+    for (const integration of this.integrations) {
+      if (integration.tools.includes(toolName) && integration.getHeaders) {
+        return integration.getHeaders();
+      }
+    }
+    return {};
+  }
   getTool(name) {
     return this.availableTools.get(name);
   }
@@ -3709,45 +3756,48 @@ var logger22 = createLogger("Ramp");
 // ../integrations/onedrive.ts
 init_logger();
 var logger23 = createLogger("OneDrive");
+// ../integrations/dropbox.ts
+init_logger();
+var logger24 = createLogger("Dropbox");
 // ../integrations/word.ts
 init_logger();
-var logger24 = createLogger("Word");
+var logger25 = createLogger("Word");
 // ../integrations/excel.ts
 init_logger();
-var logger25 = createLogger("Excel");
+var logger26 = createLogger("Excel");
 // ../integrations/powerpoint.ts
 init_logger();
-var logger26 = createLogger("PowerPoint");
+var logger27 = createLogger("PowerPoint");
 // ../integrations/gdocs.ts
 init_logger();
-var logger27 = createLogger("Google Docs");
+var logger28 = createLogger("Google Docs");
 // ../integrations/gdrive.ts
 init_logger();
-var logger28 = createLogger("Google Drive");
+var logger29 = createLogger("Google Drive");
 // ../integrations/gsheets.ts
 init_logger();
-var logger29 = createLogger("Google Sheets");
+var logger30 = createLogger("Google Sheets");
 // ../integrations/gslides.ts
 init_logger();
-var logger30 = createLogger("Google Slides");
+var logger31 = createLogger("Google Slides");
 // ../integrations/polar.ts
 init_logger();
-var logger31 = createLogger("Polar");
+var logger32 = createLogger("Polar");
 // ../integrations/figma.ts
 init_logger();
-var logger32 = createLogger("Figma");
+var logger33 = createLogger("Figma");
 // ../integrations/intercom.ts
 init_logger();
-var logger33 = createLogger("Intercom");
+var logger34 = createLogger("Intercom");
 // ../integrations/hubspot.ts
 init_logger();
-var logger34 = createLogger("HubSpot");
+var logger35 = createLogger("HubSpot");
 // ../integrations/youtube.ts
 init_logger();
-var logger35 = createLogger("YouTube");
+var logger36 = createLogger("YouTube");
 // ../integrations/cursor.ts
 init_logger();
-var logger36 = createLogger("Cursor");
+var logger37 = createLogger("Cursor");
 // ../ai/trigger-tools.ts
 init_utils();
 
@@ -3766,7 +3816,7 @@ init_tool_builder();
 init_tool_builder();
 // ../server.ts
 var SERVER_LOG_CONTEXT3 = "server";
-var logger37 = createLogger("MCPServer", SERVER_LOG_CONTEXT3);
+var logger38 = createLogger("MCPServer", SERVER_LOG_CONTEXT3);
 var codeVerifierStorage = new Map;
 var unauthenticatedCodeModeWarnings = new Set;
 function toSolidStartHandler(clientOrHandlerOrOptions, _redirectOptions) {