@artyfacts/claude 1.3.8 → 1.3.10

package/dist/cli.js

@@ -25,7 +25,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 
 // src/cli.ts
 var import_commander = require("commander");
-var import_child_process2 = require("child_process");
+var import_child_process3 = require("child_process");
 
 // src/auth.ts
 var fs = __toESM(require("fs"));
@@ -621,7 +621,9 @@ var EVENT_TYPES = [
   "task_assigned",
   "task_unblocked",
   "blocker_resolved",
-  "notification"
+  "notification",
+  "mcp_connect_request",
+  "connection_status"
 ];
 var ArtyfactsListener = class {
   config;
@@ -820,12 +822,200 @@ function createListener(config) {
   return new ArtyfactsListener(config);
 }
 
+// src/mcp.ts
+var import_child_process2 = require("child_process");
+var DEFAULT_BASE_URL3 = "https://artyfacts.dev/api/v1";
+var OAUTH_MCP_SERVERS = {
+  supabase: {
+    url: "https://mcp.supabase.com/mcp",
+    name: "supabase"
+  },
+  figma: {
+    url: "https://mcp.figma.com/mcp",
+    name: "figma"
+  }
+};
+var CREDENTIAL_MCP_CONFIGS = {
+  postgres: (config) => ({
+    command: "npx",
+    args: ["-y", "@modelcontextprotocol/server-postgres", config.connection_string]
+  }),
+  github: (config) => ({
+    command: "npx",
+    args: ["-y", "@modelcontextprotocol/server-github"],
+    env: {
+      GITHUB_PERSONAL_ACCESS_TOKEN: config.api_key
+    }
+  }),
+  filesystem: (config) => ({
+    command: "npx",
+    args: ["-y", "@modelcontextprotocol/server-filesystem", ...config.paths || []]
+  })
+};
+function addMcpServer(options) {
+  const { name, transport, url, command, args = [], env = {}, scope = "user" } = options;
+  const cliArgs = ["mcp", "add", "-s", scope, "-t", transport];
+  for (const [key, value] of Object.entries(env)) {
+    cliArgs.push("-e", `${key}=${value}`);
+  }
+  cliArgs.push(name);
+  if (transport === "http" && url) {
+    cliArgs.push(url);
+  } else if (transport === "stdio" && command) {
+    cliArgs.push("--", command, ...args);
+  } else {
+    return { success: false, error: "Invalid configuration: missing url or command" };
+  }
+  console.log(`[MCP] Running: claude ${cliArgs.join(" ")}`);
+  const result = (0, import_child_process2.spawnSync)("claude", cliArgs, {
+    encoding: "utf-8",
+    stdio: ["pipe", "pipe", "pipe"]
+  });
+  if (result.status === 0) {
+    return { success: true };
+  } else {
+    return {
+      success: false,
+      error: result.stderr || result.stdout || `Exit code ${result.status}`
+    };
+  }
+}
+var McpHandler = class {
+  config;
+  constructor(config) {
+    this.config = {
+      ...config,
+      baseUrl: config.baseUrl || DEFAULT_BASE_URL3
+    };
+  }
+  /**
+   * Handle an MCP connect request event
+   * Uses `claude mcp add` to configure the server dynamically
+   */
+  async handleConnectRequest(event) {
+    const { connection_id, platform, config: mcpConfig } = event.data;
+    try {
+      const serverName = mcpConfig?.server_name || platform;
+      const oauthServer = OAUTH_MCP_SERVERS[platform];
+      if (oauthServer) {
+        const result = addMcpServer({
+          name: serverName,
+          transport: "http",
+          url: oauthServer.url
+        });
+        if (!result.success) {
+          throw new Error(`Failed to add ${platform} MCP: ${result.error}`);
+        }
+        console.log(`[MCP] Added ${serverName} \u2192 ${oauthServer.url}`);
+        console.log(`[MCP] OAuth will prompt when you use ${platform} tools`);
+      } else {
+        const configBuilder = CREDENTIAL_MCP_CONFIGS[platform];
+        if (!configBuilder) {
+          throw new Error(`Unsupported MCP platform: ${platform}. Supported: ${[...Object.keys(OAUTH_MCP_SERVERS), ...Object.keys(CREDENTIAL_MCP_CONFIGS)].join(", ")}`);
+        }
+        if (!mcpConfig) {
+          throw new Error(`Platform ${platform} requires configuration (connection_string or api_key)`);
+        }
+        const serverConfig = configBuilder(mcpConfig);
+        const result = addMcpServer({
+          name: serverName,
+          transport: "stdio",
+          command: serverConfig.command,
+          args: serverConfig.args,
+          env: serverConfig.env
+        });
+        if (!result.success) {
+          throw new Error(`Failed to add ${platform} MCP: ${result.error}`);
+        }
+        console.log(`[MCP] Added ${serverName} for ${platform}`);
+      }
+      await this.updateConnectionStatus(connection_id, {
+        status: "active",
+        mcp_configured: true
+      });
+      this.config.onConfigured?.(connection_id, platform);
+    } catch (err) {
+      console.error(`[MCP] Failed to configure ${platform}:`, err);
+      await this.updateConnectionStatus(connection_id, {
+        status: "error",
+        mcp_configured: false,
+        error_message: err.message
+      });
+      this.config.onError?.(err, connection_id);
+    }
+  }
+  /**
+   * Check if a platform supports OAuth (no credentials needed)
+   */
+  static supportsOAuth(platform) {
+    return platform in OAUTH_MCP_SERVERS;
+  }
+  /**
+   * Get list of platforms with OAuth support
+   */
+  static getOAuthPlatforms() {
+    return Object.keys(OAUTH_MCP_SERVERS);
+  }
+  /**
+   * Update connection status in Artyfacts
+   */
+  async updateConnectionStatus(connectionId, update) {
+    try {
+      const response = await fetch(`${this.config.baseUrl}/connections/${connectionId}`, {
+        method: "PATCH",
+        headers: {
+          "Authorization": `Bearer ${this.config.apiKey}`,
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify(update)
+      });
+      if (!response.ok) {
+        console.error(`[MCP] Failed to update connection status: ${response.status}`);
+      }
+    } catch (err) {
+      console.error("[MCP] Failed to update connection status:", err);
+    }
+  }
+  /**
+   * List configured MCP servers using `claude mcp list`
+   */
+  listServers() {
+    const result = (0, import_child_process2.spawnSync)("claude", ["mcp", "list"], {
+      encoding: "utf-8",
+      stdio: ["pipe", "pipe", "pipe"]
+    });
+    if (result.status === 0 && result.stdout) {
+      return result.stdout.trim().split("\n").filter(Boolean);
+    }
+    return [];
+  }
+  /**
+   * Remove an MCP server using `claude mcp remove`
+   */
+  removeServer(serverName) {
+    const result = (0, import_child_process2.spawnSync)("claude", ["mcp", "remove", serverName], {
+      encoding: "utf-8",
+      stdio: ["pipe", "pipe", "pipe"]
+    });
+    if (result.status === 0) {
+      console.log(`[MCP] Removed server: ${serverName}`);
+      return true;
+    } else {
+      console.error(`[MCP] Failed to remove ${serverName}: ${result.stderr || result.stdout}`);
+      return false;
+    }
+  }
+};
+function createMcpHandler(config) {
+  return new McpHandler(config);
+}
+
 // src/cli.ts
 var VERSION = "0.1.0";
-var DEFAULT_BASE_URL3 = "https://artyfacts.dev/api/v1";
+var DEFAULT_BASE_URL4 = "https://artyfacts.dev/api/v1";
 function isMcpConfigured() {
   try {
-    const result = (0, import_child_process2.spawnSync)("claude", ["mcp", "get", "artyfacts"], {
+    const result = (0, import_child_process3.spawnSync)("claude", ["mcp", "get", "artyfacts"], {
       encoding: "utf-8",
       stdio: ["pipe", "pipe", "pipe"]
     });
@@ -837,7 +1027,7 @@ function isMcpConfigured() {
 function configureMcp(apiKey, baseUrl) {
   console.log("\u{1F527} Configuring Artyfacts tools for Claude Code...");
   try {
-    const result = (0, import_child_process2.spawnSync)("claude", [
+    const result = (0, import_child_process3.spawnSync)("claude", [
       "mcp",
       "add",
       "artyfacts",
@@ -878,10 +1068,10 @@ function ensureMcpConfigured(apiKey, baseUrl) {
 }
 var program = new import_commander.Command();
 program.name("artyfacts-claude").description("Claude adapter for Artyfacts - Execute tasks using Claude API").version(VERSION);
-program.command("run", { isDefault: true }).description("Start listening for and executing tasks").option("--base-url <url>", "Artyfacts API base URL", DEFAULT_BASE_URL3).option("--dry-run", "Print tasks but do not execute", false).action(async (options) => {
+program.command("run", { isDefault: true }).description("Start listening for and executing tasks").option("--base-url <url>", "Artyfacts API base URL", DEFAULT_BASE_URL4).option("--dry-run", "Print tasks but do not execute", false).action(async (options) => {
   await runAgent(options);
 });
-program.command("login").description("Authenticate with Artyfacts").option("--manual", "Enter credentials manually instead of device auth").option("--base-url <url>", "Artyfacts API base URL", DEFAULT_BASE_URL3).action(async (options) => {
+program.command("login").description("Authenticate with Artyfacts").option("--manual", "Enter credentials manually instead of device auth").option("--base-url <url>", "Artyfacts API base URL", DEFAULT_BASE_URL4).action(async (options) => {
   try {
     if (options.manual) {
       await promptForApiKey();
@@ -990,14 +1180,21 @@ async function checkAndClaimTasks(baseUrl, apiKey, agentId, activeTasks, executo
           priority: task.priority
         });
         if (result.success) {
-          await completeTask({
-            baseUrl,
-            apiKey,
-            taskId: taskUuid,
-            // Use UUID instead of section_id
-            output: result.output,
-            summary: result.summary
-          });
+          try {
+            await completeTask({
+              baseUrl,
+              apiKey,
+              taskId: taskUuid,
+              // Use UUID instead of section_id
+              output: result.output,
+              summary: result.summary
+            });
+          } catch (err) {
+            const errMsg = err instanceof Error ? err.message : String(err);
+            if (!errMsg.includes("already complete")) {
+              throw err;
+            }
+          }
           console.log(`  \u2192 \u2705 Completed! ${result.summary}`);
         } else {
           console.log(`  \u2192 \u274C Failed: ${result.error}`);
@@ -1083,6 +1280,24 @@ async function runAgent(options) {
     }
   });
   const activeTasks = /* @__PURE__ */ new Set();
+  const mcpHandler = createMcpHandler({
+    apiKey: credentials.apiKey,
+    baseUrl: options.baseUrl,
+    onConfigured: (connectionId, platform) => {
+      console.log(`
+\u{1F527} [MCP] Configured ${platform} connection: ${connectionId}`);
+      console.log("   \u26A0\uFE0F  Restart Claude Desktop to use the new MCP server");
+    },
+    onError: (error, connectionId) => {
+      console.error(`
+\u274C [MCP] Failed to configure connection ${connectionId}:`, error.message);
+    }
+  });
+  listener.on("mcp_connect_request", async (event) => {
+    console.log(`
+\u{1F517} [MCP] Connection request for ${event.data.platform}`);
+    await mcpHandler.handleConnectRequest(event);
+  });
   listener.on("task_assigned", async (event) => {
     const task = event.data;
     if (activeTasks.has(task.taskId)) {
@@ -1110,13 +1325,20 @@ async function runAgent(options) {
       };
       const result = await executor.execute(taskContext);
       if (result.success) {
-        await completeTask({
-          baseUrl: options.baseUrl,
-          apiKey: credentials.apiKey,
-          taskId: task.taskId,
-          output: result.output,
-          summary: result.summary
-        });
+        try {
+          await completeTask({
+            baseUrl: options.baseUrl,
+            apiKey: credentials.apiKey,
+            taskId: task.taskId,
+            output: result.output,
+            summary: result.summary
+          });
+        } catch (err) {
+          const errMsg = err instanceof Error ? err.message : String(err);
+          if (!errMsg.includes("already complete")) {
+            throw err;
+          }
+        }
         console.log(`  \u2192 \u2705 Completed! ${result.summary}`);
       } else {
         console.log(`  \u2192 \u274C Failed: ${result.error}`);
@@ -1134,8 +1356,15 @@ async function runAgent(options) {
     }
   });
   listener.connect();
+  const POLL_INTERVAL_MS = 3e4;
+  const pollInterval = setInterval(() => {
+    if (!options.dryRun) {
+      checkAndClaimTasks(options.baseUrl, credentials.apiKey, credentials.agentId, activeTasks, executor, options.dryRun);
+    }
+  }, POLL_INTERVAL_MS);
   const shutdown = () => {
     console.log("\n\u{1F44B} Disconnecting...");
+    clearInterval(pollInterval);
     listener.disconnect();
     process.exit(0);
   };

package/dist/cli.mjs

@@ -3,10 +3,11 @@ import {
   clearCredentials,
   createExecutor,
   createListener,
+  createMcpHandler,
   getCredentials,
   loadCredentials,
   promptForApiKey
-} from "./chunk-G6HSQFKJ.mjs";
+} from "./chunk-VGAUMCRW.mjs";
 
 // src/cli.ts
 import { Command } from "commander";
@@ -180,14 +181,21 @@ async function checkAndClaimTasks(baseUrl, apiKey, agentId, activeTasks, executo
           priority: task.priority
         });
         if (result.success) {
-          await completeTask({
-            baseUrl,
-            apiKey,
-            taskId: taskUuid,
-            // Use UUID instead of section_id
-            output: result.output,
-            summary: result.summary
-          });
+          try {
+            await completeTask({
+              baseUrl,
+              apiKey,
+              taskId: taskUuid,
+              // Use UUID instead of section_id
+              output: result.output,
+              summary: result.summary
+            });
+          } catch (err) {
+            const errMsg = err instanceof Error ? err.message : String(err);
+            if (!errMsg.includes("already complete")) {
+              throw err;
+            }
+          }
           console.log(`  \u2192 \u2705 Completed! ${result.summary}`);
         } else {
           console.log(`  \u2192 \u274C Failed: ${result.error}`);
@@ -273,6 +281,24 @@ async function runAgent(options) {
     }
   });
   const activeTasks = /* @__PURE__ */ new Set();
+  const mcpHandler = createMcpHandler({
+    apiKey: credentials.apiKey,
+    baseUrl: options.baseUrl,
+    onConfigured: (connectionId, platform) => {
+      console.log(`
+\u{1F527} [MCP] Configured ${platform} connection: ${connectionId}`);
+      console.log("   \u26A0\uFE0F  Restart Claude Desktop to use the new MCP server");
+    },
+    onError: (error, connectionId) => {
+      console.error(`
+\u274C [MCP] Failed to configure connection ${connectionId}:`, error.message);
+    }
+  });
+  listener.on("mcp_connect_request", async (event) => {
+    console.log(`
+\u{1F517} [MCP] Connection request for ${event.data.platform}`);
+    await mcpHandler.handleConnectRequest(event);
+  });
   listener.on("task_assigned", async (event) => {
     const task = event.data;
     if (activeTasks.has(task.taskId)) {
@@ -300,13 +326,20 @@ async function runAgent(options) {
       };
       const result = await executor.execute(taskContext);
       if (result.success) {
-        await completeTask({
-          baseUrl: options.baseUrl,
-          apiKey: credentials.apiKey,
-          taskId: task.taskId,
-          output: result.output,
-          summary: result.summary
-        });
+        try {
+          await completeTask({
+            baseUrl: options.baseUrl,
+            apiKey: credentials.apiKey,
+            taskId: task.taskId,
+            output: result.output,
+            summary: result.summary
+          });
+        } catch (err) {
+          const errMsg = err instanceof Error ? err.message : String(err);
+          if (!errMsg.includes("already complete")) {
+            throw err;
+          }
+        }
         console.log(`  \u2192 \u2705 Completed! ${result.summary}`);
       } else {
         console.log(`  \u2192 \u274C Failed: ${result.error}`);
@@ -324,8 +357,15 @@ async function runAgent(options) {
     }
   });
   listener.connect();
+  const POLL_INTERVAL_MS = 3e4;
+  const pollInterval = setInterval(() => {
+    if (!options.dryRun) {
+      checkAndClaimTasks(options.baseUrl, credentials.apiKey, credentials.agentId, activeTasks, executor, options.dryRun);
+    }
+  }, POLL_INTERVAL_MS);
   const shutdown = () => {
     console.log("\n\u{1F44B} Disconnecting...");
+    clearInterval(pollInterval);
     listener.disconnect();
     process.exit(0);
   };

package/dist/index.d.mts

@@ -163,6 +163,20 @@ interface TaskAssignedEvent {
         assignedAt: string;
     };
 }
+interface McpConnectRequestEvent {
+    type: 'mcp_connect_request';
+    timestamp: string;
+    data: {
+        connection_id: string;
+        platform: string;
+        config: {
+            server_name?: string;
+            connection_string?: string;
+            api_key?: string;
+            [key: string]: unknown;
+        };
+    };
+}
 interface HeartbeatEvent {
     type: 'heartbeat';
     timestamp: string;
@@ -174,7 +188,7 @@ interface ConnectedEvent {
         agentId: string;
     };
 }
-type ArtyfactsEvent = TaskAssignedEvent | HeartbeatEvent | ConnectedEvent | {
+type ArtyfactsEvent = TaskAssignedEvent | HeartbeatEvent | ConnectedEvent | McpConnectRequestEvent | {
     type: string;
     timestamp: string;
     data?: Record<string, unknown>;
@@ -534,4 +548,65 @@ declare class ClaudeExecutorWithTools {
  */
 declare function createExecutorWithTools(config: ExecutorConfig): ClaudeExecutorWithTools;
 
-export { type ApiClient, type ArtifactContext, type ArtyfactsEvent, ArtyfactsListener, ClaudeExecutor, ClaudeExecutorWithTools, type ConnectedEvent, type ConnectionState, ContextFetcher, type ContextFetcherConfig, type Credentials, type DeviceAuthResponse, type EventCallback, type ExecutionResult$1 as ExecutionResult, type ExecutorConfig$1 as ExecutorConfig, type ExecutorConfig as ExecutorWithToolsConfig, type HeartbeatEvent, type ListenerConfig, type OrganizationContext, type ProjectContext, type SectionContext, type TaskAssignedEvent, type TaskContext$1 as TaskContext, type TaskFullContext, type TokenResponse, type ToolCall, type ToolCallResult, type ToolHandler, type ToolResult, type ToolSchema, buildPromptWithContext, clearCredentials, createApiClient, createContextFetcher, createExecutor, createExecutorWithTools, createListener, executeTool, getAllToolSchemas, getCredentials, getRequiredPermission, getToolSchema, getToolsForPermissions, isToolAllowed, loadCredentials, permissionToTools, promptForApiKey, runDeviceAuth, saveCredentials, handlers as toolHandlers };
+/**
+ * MCP Connection Handler
+ *
+ * Handles mcp_connect_request events from Artyfacts and configures
+ * MCP servers for the Claude adapter using `claude mcp add`.
+ *
+ * @module mcp
+ */
+
+interface McpServerConfig {
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+}
+interface ClaudeSettingsJson {
+    mcpServers?: Record<string, McpServerConfig>;
+}
+interface McpHandlerConfig {
+    /** Artyfacts API key for status updates */
+    apiKey: string;
+    /** Base URL for Artyfacts API */
+    baseUrl?: string;
+    /** Callback when MCP server is configured */
+    onConfigured?: (connectionId: string, platform: string) => void;
+    /** Callback on error */
+    onError?: (error: Error, connectionId: string) => void;
+}
+declare class McpHandler {
+    private config;
+    constructor(config: McpHandlerConfig);
+    /**
+     * Handle an MCP connect request event
+     * Uses `claude mcp add` to configure the server dynamically
+     */
+    handleConnectRequest(event: McpConnectRequestEvent): Promise<void>;
+    /**
+     * Check if a platform supports OAuth (no credentials needed)
+     */
+    static supportsOAuth(platform: string): boolean;
+    /**
+     * Get list of platforms with OAuth support
+     */
+    static getOAuthPlatforms(): string[];
+    /**
+     * Update connection status in Artyfacts
+     */
+    private updateConnectionStatus;
+    /**
+     * List configured MCP servers using `claude mcp list`
+     */
+    listServers(): string[];
+    /**
+     * Remove an MCP server using `claude mcp remove`
+     */
+    removeServer(serverName: string): boolean;
+}
+/**
+ * Create an MCP handler instance
+ */
+declare function createMcpHandler(config: McpHandlerConfig): McpHandler;
+
+export { type ApiClient, type ArtifactContext, type ArtyfactsEvent, ArtyfactsListener, ClaudeExecutor, ClaudeExecutorWithTools, type ClaudeSettingsJson, type ConnectedEvent, type ConnectionState, ContextFetcher, type ContextFetcherConfig, type Credentials, type DeviceAuthResponse, type EventCallback, type ExecutionResult$1 as ExecutionResult, type ExecutorConfig$1 as ExecutorConfig, type ExecutorConfig as ExecutorWithToolsConfig, type HeartbeatEvent, type ListenerConfig, type McpConnectRequestEvent, McpHandler, type McpHandlerConfig, type McpServerConfig, type OrganizationContext, type ProjectContext, type SectionContext, type TaskAssignedEvent, type TaskContext$1 as TaskContext, type TaskFullContext, type TokenResponse, type ToolCall, type ToolCallResult, type ToolHandler, type ToolResult, type ToolSchema, buildPromptWithContext, clearCredentials, createApiClient, createContextFetcher, createExecutor, createExecutorWithTools, createListener, createMcpHandler, executeTool, getAllToolSchemas, getCredentials, getRequiredPermission, getToolSchema, getToolsForPermissions, isToolAllowed, loadCredentials, permissionToTools, promptForApiKey, runDeviceAuth, saveCredentials, handlers as toolHandlers };

package/dist/index.d.ts

@@ -163,6 +163,20 @@ interface TaskAssignedEvent {
         assignedAt: string;
     };
 }
+interface McpConnectRequestEvent {
+    type: 'mcp_connect_request';
+    timestamp: string;
+    data: {
+        connection_id: string;
+        platform: string;
+        config: {
+            server_name?: string;
+            connection_string?: string;
+            api_key?: string;
+            [key: string]: unknown;
+        };
+    };
+}
 interface HeartbeatEvent {
     type: 'heartbeat';
     timestamp: string;
@@ -174,7 +188,7 @@ interface ConnectedEvent {
         agentId: string;
     };
 }
-type ArtyfactsEvent = TaskAssignedEvent | HeartbeatEvent | ConnectedEvent | {
+type ArtyfactsEvent = TaskAssignedEvent | HeartbeatEvent | ConnectedEvent | McpConnectRequestEvent | {
     type: string;
     timestamp: string;
     data?: Record<string, unknown>;
@@ -534,4 +548,65 @@ declare class ClaudeExecutorWithTools {
  */
 declare function createExecutorWithTools(config: ExecutorConfig): ClaudeExecutorWithTools;
 
-export { type ApiClient, type ArtifactContext, type ArtyfactsEvent, ArtyfactsListener, ClaudeExecutor, ClaudeExecutorWithTools, type ConnectedEvent, type ConnectionState, ContextFetcher, type ContextFetcherConfig, type Credentials, type DeviceAuthResponse, type EventCallback, type ExecutionResult$1 as ExecutionResult, type ExecutorConfig$1 as ExecutorConfig, type ExecutorConfig as ExecutorWithToolsConfig, type HeartbeatEvent, type ListenerConfig, type OrganizationContext, type ProjectContext, type SectionContext, type TaskAssignedEvent, type TaskContext$1 as TaskContext, type TaskFullContext, type TokenResponse, type ToolCall, type ToolCallResult, type ToolHandler, type ToolResult, type ToolSchema, buildPromptWithContext, clearCredentials, createApiClient, createContextFetcher, createExecutor, createExecutorWithTools, createListener, executeTool, getAllToolSchemas, getCredentials, getRequiredPermission, getToolSchema, getToolsForPermissions, isToolAllowed, loadCredentials, permissionToTools, promptForApiKey, runDeviceAuth, saveCredentials, handlers as toolHandlers };
+/**
+ * MCP Connection Handler
+ *
+ * Handles mcp_connect_request events from Artyfacts and configures
+ * MCP servers for the Claude adapter using `claude mcp add`.
+ *
+ * @module mcp
+ */
+
+interface McpServerConfig {
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+}
+interface ClaudeSettingsJson {
+    mcpServers?: Record<string, McpServerConfig>;
+}
+interface McpHandlerConfig {
+    /** Artyfacts API key for status updates */
+    apiKey: string;
+    /** Base URL for Artyfacts API */
+    baseUrl?: string;
+    /** Callback when MCP server is configured */
+    onConfigured?: (connectionId: string, platform: string) => void;
+    /** Callback on error */
+    onError?: (error: Error, connectionId: string) => void;
+}
+declare class McpHandler {
+    private config;
+    constructor(config: McpHandlerConfig);
+    /**
+     * Handle an MCP connect request event
+     * Uses `claude mcp add` to configure the server dynamically
+     */
+    handleConnectRequest(event: McpConnectRequestEvent): Promise<void>;
+    /**
+     * Check if a platform supports OAuth (no credentials needed)
+     */
+    static supportsOAuth(platform: string): boolean;
+    /**
+     * Get list of platforms with OAuth support
+     */
+    static getOAuthPlatforms(): string[];
+    /**
+     * Update connection status in Artyfacts
+     */
+    private updateConnectionStatus;
+    /**
+     * List configured MCP servers using `claude mcp list`
+     */
+    listServers(): string[];
+    /**
+     * Remove an MCP server using `claude mcp remove`
+     */
+    removeServer(serverName: string): boolean;
+}
+/**
+ * Create an MCP handler instance
+ */
+declare function createMcpHandler(config: McpHandlerConfig): McpHandler;
+
+export { type ApiClient, type ArtifactContext, type ArtyfactsEvent, ArtyfactsListener, ClaudeExecutor, ClaudeExecutorWithTools, type ClaudeSettingsJson, type ConnectedEvent, type ConnectionState, ContextFetcher, type ContextFetcherConfig, type Credentials, type DeviceAuthResponse, type EventCallback, type ExecutionResult$1 as ExecutionResult, type ExecutorConfig$1 as ExecutorConfig, type ExecutorConfig as ExecutorWithToolsConfig, type HeartbeatEvent, type ListenerConfig, type McpConnectRequestEvent, McpHandler, type McpHandlerConfig, type McpServerConfig, type OrganizationContext, type ProjectContext, type SectionContext, type TaskAssignedEvent, type TaskContext$1 as TaskContext, type TaskFullContext, type TokenResponse, type ToolCall, type ToolCallResult, type ToolHandler, type ToolResult, type ToolSchema, buildPromptWithContext, clearCredentials, createApiClient, createContextFetcher, createExecutor, createExecutorWithTools, createListener, createMcpHandler, executeTool, getAllToolSchemas, getCredentials, getRequiredPermission, getToolSchema, getToolsForPermissions, isToolAllowed, loadCredentials, permissionToTools, promptForApiKey, runDeviceAuth, saveCredentials, handlers as toolHandlers };