@nimbus-app/mcp 1.0.0

package/README.md

@@ -0,0 +1,212 @@
+# Nimbus MCP Server
+
+Connect Claude to your task memory. This MCP server lets Claude access your captured tasks and platform knowledge from Nimbus, so it can learn how you perform tasks and help you more effectively.
+
+## Quick Start
+
+### 1. Install
+
+```bash
+npm install -g @nimbus-app/mcp
+```
+
+### 2. Get Your API Key
+
+1. Open the Nimbus desktop app
+2. Go to **Settings** → **Account**
+3. Click **Generate MCP API Key**
+4. Copy the key (starts with `nimbus_`)
+
+### 3. Configure Claude Desktop
+
+Add to your Claude Desktop config file:
+
+**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
+**Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "nimbus": {
+      "command": "nimbus-mcp",
+      "env": {
+        "NIMBUS_API_KEY": "nimbus_your_api_key_here"
+      }
+    }
+  }
+}
+```
+
+### 4. Restart Claude Desktop
+
+Quit and reopen Claude Desktop. You should see "nimbus" in the MCP servers list.
+
+## Available Tools
+
+Once connected, Claude has access to these tools:
+
+### `nimbus_search_tasks`
+
+Search for task patterns you've performed. Returns matching tasks with confidence scores and associated platforms.
+
+**Example prompts:**
+- "Search my tasks for submitting homework on Canvas"
+- "Find how I usually file expense reports"
+- "Look for tasks involving VS Code"
+
+### `nimbus_get_task`
+
+Get full details for a specific task, including platform knowledge, subtasks, and recent execution examples with step-by-step screenshots.
+
+**Example prompts:**
+- "Show me the full details for that Canvas task"
+- "Get the execution steps with screenshots"
+
+### `nimbus_search_workflows`
+
+Search for recorded workflows/sessions by natural language query. Returns matching workflows with status, counts, and top related tasks.
+
+**Example prompts:**
+- "Find workflows where I submitted homework"
+- "Show my recent workflows about expense reports"
+- "Search my workflows for VS Code setup"
+
+### `nimbus_get_workflow_steps`
+
+Get detailed task executions and ordered workflow steps for a specific workflow.
+
+**Example prompts:**
+- "Show the step-by-step flow for this workflow"
+- "Get workflow steps including screenshots"
+- "Explain the executions in this workflow"
+
+### `nimbus_search_platforms`
+
+Search for platforms (apps/websites) you work with. Returns platform knowledge and related tasks.
+
+**Example prompts:**
+- "What platforms do I use for development?"
+- "Find information about Canvas"
+
+### `nimbus_get_platform`
+
+Get full details for a specific platform, including accumulated knowledge about how it works and all tasks you perform on it.
+
+**Example prompts:**
+- "Show me everything about how I use VS Code"
+- "Get full details on this platform"
+
+### `nimbus_ask_user`
+
+Ask you a question (you'll be notified in the Nimbus app).
+
+**Example prompts:**
+- "Ask the user which email to use for this form"
+- "Check with the user if they want to proceed"
+
+### `nimbus_get_question_status`
+
+Check if you've answered a question.
+
+## Example Conversation
+
+```
+You: Help me submit my CS101 homework on Canvas
+
+Claude: Let me search your tasks to see how you usually do this.
+[Uses nimbus_search_tasks with "submit homework Canvas"]
+
+I found a task called "Submit Canvas Assignment" that you've done 5 times.
+Let me get the detailed steps.
+[Uses nimbus_get_task with include_executions=1]
+
+Here's how you typically submit homework on Canvas:
+
+1. Navigate to canvas.instructure.com
+2. Click on "CS101" in the course list
+3. Click "Assignments" in the left sidebar
+4. Find your assignment and click on it
+5. Click "Submit Assignment" button
+6. Upload your file using the file picker
+7. Click "Submit" to confirm
+
+Would you like me to walk you through this step by step?
+```
+
+## Configuration Options
+
+### Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `NIMBUS_API_KEY` | Your Nimbus API key (required) | - |
+| `NIMBUS_API_URL` | API endpoint URL | `https://api.nimbusai.cloud/mcp/v1` |
+
+### Staging/Development
+
+To use the staging API:
+
+```json
+{
+  "mcpServers": {
+    "nimbus": {
+      "command": "nimbus-mcp",
+      "env": {
+        "NIMBUS_API_KEY": "nimbus_your_key",
+        "NIMBUS_API_URL": "https://api.staging.nimbusai.cloud/mcp/v1"
+      }
+    }
+  }
+}
+```
+
+## Troubleshooting
+
+### "NIMBUS_API_KEY is required"
+
+Make sure you've added the API key to your Claude Desktop config and restarted Claude.
+
+### "Invalid or missing API key"
+
+Your API key may be incorrect or expired. Generate a new one in Nimbus Settings → Account.
+
+### "Rate limit exceeded"
+
+The API has limits of:
+- 100 requests per minute
+- 1,000 requests per hour
+- 10,000 requests per day
+
+Wait a moment and try again.
+
+### Server not appearing in Claude
+
+1. Check your config file path is correct
+2. Ensure the JSON is valid (no trailing commas)
+3. Completely quit and restart Claude Desktop
+4. Check Claude's logs for errors
+
+### Testing the server manually
+
+```bash
+NIMBUS_API_KEY=your_key nimbus-mcp
+```
+
+The server should start and wait for MCP protocol messages on stdin.
+
+## Privacy & Security
+
+- Your API key authenticates requests to your own workflow data
+- Nimbus only captures what you've allowed in Privacy Settings
+- Screenshots and workflow data are encrypted in transit and at rest
+- You can delete your data anytime from the Nimbus app
+
+## Support
+
+- **Documentation:** https://nimbusai.cloud/docs/mcp
+- **Issues:** https://github.com/nimbus-app/nimbus/issues
+- **Email:** support@nimbusai.cloud
+
+## License
+
+MIT

package/dist/api-client.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Nimbus API Client
+ *
+ * HTTP client for the Nimbus MCP REST API.
+ */
+import type { SearchTasksInput, SearchTasksOutput, SearchWorkflowsInput, SearchWorkflowsOutput, GetTaskInput, GetTaskOutput, SearchPlatformsInput, SearchPlatformsOutput, GetWorkflowInput, GetWorkflowOutput, AskUserInput, AskUserOutput, QuestionStatus } from './types.js';
+export declare class NimbusAPIError extends Error {
+    code: string;
+    details?: Record<string, unknown> | undefined;
+    constructor(code: string, message: string, details?: Record<string, unknown> | undefined);
+}
+export declare class NimbusClient {
+    private apiUrl;
+    private apiKey;
+    constructor(apiKey: string, apiUrl?: string);
+    private request;
+    searchTasks(input: SearchTasksInput): Promise<SearchTasksOutput>;
+    searchWorkflows(input: SearchWorkflowsInput): Promise<SearchWorkflowsOutput>;
+    getTask(input: GetTaskInput): Promise<GetTaskOutput>;
+    searchPlatforms(input: SearchPlatformsInput): Promise<SearchPlatformsOutput>;
+    getWorkflow(input: GetWorkflowInput): Promise<GetWorkflowOutput>;
+    askUser(input: AskUserInput): Promise<AskUserOutput>;
+    getQuestionStatus(questionId: string): Promise<QuestionStatus>;
+}
+//# sourceMappingURL=api-client.d.ts.map

package/dist/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAGV,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,EACrB,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,cAAc,EACf,MAAM,YAAY,CAAA;AAKnB,qBAAa,cAAe,SAAQ,KAAK;IAE9B,IAAI,EAAE,MAAM;IAEZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAFjC,IAAI,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACR,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;CAK3C;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,MAAM,CAAQ;gBAEV,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;YAQ7B,OAAO;IA+Bf,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAIhE,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAI5E,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IAIpD,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAI5E,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAIhE,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IAIpD,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;CAGrE"}

package/dist/api-client.js

@@ -0,0 +1,69 @@
+/**
+ * Nimbus API Client
+ *
+ * HTTP client for the Nimbus MCP REST API.
+ */
+import fetch from 'node-fetch';
+// Default MCP API URL — requires NIMBUS_API_URL env var or explicit URL in constructor
+const DEFAULT_API_URL = 'https://api.nimbusai.cloud/mcp/v1';
+export class NimbusAPIError extends Error {
+    code;
+    details;
+    constructor(code, message, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = 'NimbusAPIError';
+    }
+}
+export class NimbusClient {
+    apiUrl;
+    apiKey;
+    constructor(apiKey, apiUrl) {
+        if (!apiKey) {
+            throw new Error('NIMBUS_API_KEY is required');
+        }
+        this.apiKey = apiKey;
+        this.apiUrl = apiUrl || process.env.NIMBUS_API_URL || DEFAULT_API_URL;
+    }
+    async request(endpoint, method = 'POST', body) {
+        const url = `${this.apiUrl}${endpoint}`;
+        const response = await fetch(url, {
+            method,
+            headers: {
+                'Content-Type': 'application/json',
+                'X-Api-Key': this.apiKey,
+                'User-Agent': 'nimbus-mcp/1.0.0',
+            },
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        const json = await response.json();
+        if (!response.ok) {
+            const error = json;
+            throw new NimbusAPIError(error.error?.code || 'UNKNOWN_ERROR', error.error?.message || 'An unknown error occurred', error.error?.details);
+        }
+        return json.data;
+    }
+    async searchTasks(input) {
+        return this.request('/tools/nimbus_search_tasks', 'POST', input);
+    }
+    async searchWorkflows(input) {
+        return this.request('/tools/nimbus_search_workflows', 'POST', input);
+    }
+    async getTask(input) {
+        return this.request('/tools/nimbus_get_task', 'POST', input);
+    }
+    async searchPlatforms(input) {
+        return this.request('/tools/nimbus_search_platforms', 'POST', input);
+    }
+    async getWorkflow(input) {
+        return this.request('/tools/nimbus_get_workflow', 'POST', input);
+    }
+    async askUser(input) {
+        return this.request('/tools/nimbus_ask_user', 'POST', input);
+    }
+    async getQuestionStatus(questionId) {
+        return this.request(`/questions/${questionId}`, 'GET');
+    }
+}
+//# sourceMappingURL=api-client.js.map

package/dist/api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.js","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+/**
+ * Nimbus MCP Server
+ *
+ * A Model Context Protocol server that provides access to your Nimbus task memory.
+ * This allows AI assistants like Claude to query your captured tasks, platforms,
+ * and learn how you perform tasks.
+ *
+ * Usage:
+ *   NIMBUS_API_KEY=your_key nimbus-mcp
+ *
+ * Or configure in Claude Desktop:
+ *   {
+ *     "mcpServers": {
+ *       "nimbus": {
+ *         "command": "nimbus-mcp",
+ *         "env": { "NIMBUS_API_KEY": "your_key" }
+ *       }
+ *     }
+ *   }
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;GAmBG"}

package/dist/index.js

@@ -0,0 +1,493 @@
+#!/usr/bin/env node
+/**
+ * Nimbus MCP Server
+ *
+ * A Model Context Protocol server that provides access to your Nimbus task memory.
+ * This allows AI assistants like Claude to query your captured tasks, platforms,
+ * and learn how you perform tasks.
+ *
+ * Usage:
+ *   NIMBUS_API_KEY=your_key nimbus-mcp
+ *
+ * Or configure in Claude Desktop:
+ *   {
+ *     "mcpServers": {
+ *       "nimbus": {
+ *         "command": "nimbus-mcp",
+ *         "env": { "NIMBUS_API_KEY": "your_key" }
+ *       }
+ *     }
+ *   }
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+import { NimbusClient, NimbusAPIError } from './api-client.js';
+// ============================================================================
+// CONFIGURATION
+// ============================================================================
+const SERVER_NAME = 'nimbus';
+const SERVER_VERSION = '1.0.0';
+const SERVER_INSTRUCTIONS = `Nimbus is the user's task memory. It watches their screen as they complete their computer work and learns HOW they perform tasks across apps and websites. Use Nimbus tools whenever you need to do something the way the user does it, understand how they use a specific app, or find out how they've done something before.
+
+Data hierarchy: Workflow → Tasks → Steps. A workflow contains tasks, and each task contains steps with screenshots.
+
+**Task** — A recurring action the user performs, like "submit an expense report" or "onboard a new vendor". Built from repeated observations across multiple recordings. Has steps, associated platforms, and a confidence score that reflects how reliably Nimbus has identified this as a distinct, repeatable task (higher = seen it more times with consistent patterns).
+
+**Workflow** — One recording session. The user pressed Record, did work on their computer, and pressed Stop. Everything they did in that window of time — the screenshots, the apps they touched, the AI analysis of what was happening — lives under that workflow.
+
+**Platform** — An app or website (e.g., Salesforce, Google Sheets, SAP). Nimbus accumulates knowledge about how the user navigates each one over time.`;
+// ============================================================================
+// INPUT SCHEMAS (Zod for validation)
+// ============================================================================
+const searchTasksSchema = z.object({
+    query: z.string().min(1).max(1000),
+    platform_filter: z.string().max(200).optional(),
+    limit: z.number().int().min(1).max(20).optional().default(5),
+});
+const searchWorkflowsSchema = z.object({
+    query: z.string().min(1).max(1000),
+    limit: z.number().int().min(1).max(20).optional().default(5),
+});
+const getTaskSchema = z.object({
+    task_id: z.string().uuid(),
+    include_executions: z.number().int().min(1).max(5).optional().default(2),
+});
+const searchPlatformsSchema = z.object({
+    query: z.string().min(1).max(1000),
+    limit: z.number().int().min(1).max(20).optional().default(5),
+});
+const getWorkflowSchema = z.object({
+    workflow_id: z.string().uuid(),
+});
+const askUserSchema = z.object({
+    question: z.string().min(1).max(1000),
+    context: z.string().max(5000).optional(),
+    suggested_answers: z.array(z.string().max(500)).max(5).optional(),
+});
+const getQuestionStatusSchema = z.object({
+    question_id: z.string().uuid(),
+});
+// ============================================================================
+// TOOL DEFINITIONS (JSON Schema format for MCP protocol)
+// ============================================================================
+const TOOLS = [
+    {
+        name: 'nimbus_search_tasks',
+        description: 'Search how the user does something. Searches their recorded task library — recurring actions like "submit an expense report", "onboard a new vendor", or "update the weekly forecast". Returns task names, descriptions, and platform names to help you identify the right task. Pass a task_id to nimbus_get_task for the full playbook with steps, screenshots, and platform knowledge.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: 'Natural language search query',
+                },
+                platform_filter: {
+                    type: 'string',
+                    description: 'Filter results by platform name (e.g., "SAP Concur", "Salesforce")',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of results to return (default 5, max 20)',
+                },
+            },
+            required: ['query'],
+        },
+    },
+    {
+        name: 'nimbus_get_task',
+        description: 'Get the full playbook for a task. Returns everything needed to replicate or understand it: description, subtasks, platform-specific knowledge (how to navigate each app), and recent executions with step-by-step screenshots showing exactly how the user performed it. Includes 2 recent executions by default — set include_executions (1-5) to control how many.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                task_id: {
+                    type: 'string',
+                    description: 'UUID of the task to retrieve',
+                },
+                include_executions: {
+                    type: 'number',
+                    description: 'Number of recent executions to include (1-5, default 2). Each execution includes steps with screenshot URLs.',
+                },
+            },
+            required: ['task_id'],
+        },
+    },
+    {
+        name: 'nimbus_search_workflows',
+        description: 'Search the user\'s recording sessions. Each workflow is one recorded block of work — everything the user did between pressing Record and Stop. Use this to find a specific session (e.g., "setting up the new hire\'s accounts" or "yesterday\'s budget review"). Returns session summary, capture/analysis counts, and the top tasks identified. Pass a workflow_id to nimbus_get_workflow for the full task breakdown.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: 'Natural language query for matching workflows',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of results to return (default 5, max 20)',
+                },
+            },
+            required: ['query'],
+        },
+    },
+    {
+        name: 'nimbus_get_workflow',
+        description: 'Get a high-level overview of a recording session — which tasks the user performed, in what order, with brief descriptions and the platforms involved. Use this to understand what happened in a session without the fine details. To drill into a specific task\'s steps and screenshots, pass its task_id to nimbus_get_task. Requires a workflow_id from nimbus_search_workflows.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                workflow_id: {
+                    type: 'string',
+                    description: 'UUID of the workflow to retrieve',
+                },
+            },
+            required: ['workflow_id'],
+        },
+    },
+    {
+        name: 'nimbus_search_platforms',
+        description: 'Look up an app or website the user works with. Returns the full accumulated knowledge Nimbus has about the platform — how to navigate it, where things are, UI quirks — along with identifiers, every task the user performs on it, and usage history. Use this when you need to understand how a specific tool works from the user\'s perspective.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: 'Platform name or natural language query',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of results to return (default 5, max 20)',
+                },
+            },
+            required: ['query'],
+        },
+    },
+    {
+        name: 'nimbus_ask_user',
+        description: 'Ask the user a question when Nimbus data alone isn\'t enough. Delivered as a notification in the Nimbus desktop app. This is async — poll nimbus_get_question_status for their answer. Only use this after checking tasks, workflows, and platforms first.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                question: {
+                    type: 'string',
+                    description: 'Question to ask the user',
+                },
+                context: {
+                    type: 'string',
+                    description: "Why you're asking this question",
+                },
+                suggested_answers: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Suggested quick responses (max 5)',
+                },
+            },
+            required: ['question'],
+        },
+    },
+    {
+        name: 'nimbus_get_question_status',
+        description: 'Poll for the user\'s answer to a question sent via nimbus_ask_user. Returns status (pending/answered/expired/dismissed) and the answer text if they responded. Pass the question_id from the nimbus_ask_user response.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                question_id: {
+                    type: 'string',
+                    description: 'Question ID from nimbus_ask_user response (UUID format)',
+                },
+            },
+            required: ['question_id'],
+        },
+    },
+];
+// ============================================================================
+// HELPER FUNCTIONS
+// ============================================================================
+function formatError(error) {
+    if (error instanceof NimbusAPIError) {
+        return `Nimbus API Error [${error.code}]: ${error.message}`;
+    }
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return String(error);
+}
+function textContent(text) {
+    return { type: 'text', text };
+}
+// ============================================================================
+// TOOL HANDLERS
+// ============================================================================
+async function handleSearchTasks(client, args) {
+    try {
+        const input = searchTasksSchema.parse(args);
+        const result = await client.searchTasks(input);
+        if (result.tasks.length === 0) {
+            return {
+                content: [
+                    textContent(`No tasks found matching "${input.query}". The user may not have performed this task yet, or it may be described differently.`),
+                ],
+            };
+        }
+        const taskList = result.tasks
+            .map((t, i) => {
+            const platforms = t.platforms.length > 0 ? ` (${t.platforms.join(', ')})` : '';
+            return `${i + 1}. **${t.name}**${platforms}
+   ID: ${t.id}
+   ${t.description}`;
+        })
+            .join('\n\n');
+        return {
+            content: [
+                textContent(`Found ${result.total_matches} task(s) matching "${input.query}":\n\n${taskList}\n\nUse nimbus_get_task with a task_id for the full step-by-step playbook.`),
+            ],
+        };
+    }
+    catch (error) {
+        return { content: [textContent(formatError(error))], isError: true };
+    }
+}
+async function handleGetTask(client, args) {
+    try {
+        const input = getTaskSchema.parse(args);
+        const result = await client.getTask(input);
+        const { task } = result;
+        const platformsInfo = task.platforms.length > 0
+            ? `\n\n**Platforms:**\n${task.platforms.map((p) => `- **${p.name}**: ${p.knowledge}`).join('\n')}`
+            : '';
+        const subtasksInfo = task.subtasks.length > 0
+            ? `\n\n**Subtasks:**\n${task.subtasks.map((s) => `- **${s.name}**: ${s.description}`).join('\n')}`
+            : '';
+        const executionsInfo = result.recent_executions.length > 0
+            ? `\n\n**Recent Executions (${result.recent_executions.length}):**\n${result.recent_executions
+                .map((exec) => {
+                const steps = exec.steps
+                    .map((step) => {
+                    const screenshot = step.screenshot_url ? ` [Screenshot](${step.screenshot_url})` : '';
+                    return `   ${step.position}. ${step.description}${screenshot}`;
+                })
+                    .join('\n');
+                return `\n- **${new Date(exec.performed_at).toLocaleDateString()}** - ${exec.context}\n${steps}`;
+            })
+                .join('\n')}`
+            : '';
+        return {
+            content: [
+                textContent(`# ${task.name}\n\n${task.description}\n\nConfidence: ${(task.confidence * 100).toFixed(0)}% | Performed: ${task.occurrence_count} time(s)${platformsInfo}${subtasksInfo}${executionsInfo}`),
+            ],
+        };
+    }
+    catch (error) {
+        return { content: [textContent(formatError(error))], isError: true };
+    }
+}
+async function handleSearchWorkflows(client, args) {
+    try {
+        const input = searchWorkflowsSchema.parse(args);
+        const result = await client.searchWorkflows(input);
+        if (result.workflows.length === 0) {
+            return {
+                content: [
+                    textContent(`No workflows found matching "${input.query}". The user may need to record additional sessions.`),
+                ],
+            };
+        }
+        const workflowList = result.workflows
+            .map((workflow, index) => {
+            const topTasks = workflow.top_tasks.length > 0
+                ? `\n   Top tasks: ${workflow.top_tasks.map((task) => task.name).join(', ')}`
+                : '';
+            const endedAt = workflow.ended_at
+                ? ` | Ended: ${new Date(workflow.ended_at).toLocaleDateString()}`
+                : ' | In progress';
+            return `${index + 1}. **${workflow.name}**
+   ID: ${workflow.id}
+   Status: ${workflow.status} | Captures: ${workflow.capture_count} | Analyses: ${workflow.analysis_count}${endedAt}
+   Started: ${new Date(workflow.started_at).toLocaleDateString()}${topTasks}`;
+        })
+            .join('\n\n');
+        return {
+            content: [
+                textContent(`Found ${result.total_matches} workflow(s) matching "${input.query}":\n\n${workflowList}\n\nUse nimbus_get_workflow with a workflow_id for the full task breakdown.`),
+            ],
+        };
+    }
+    catch (error) {
+        return { content: [textContent(formatError(error))], isError: true };
+    }
+}
+async function handleSearchPlatforms(client, args) {
+    try {
+        const input = searchPlatformsSchema.parse(args);
+        const result = await client.searchPlatforms(input);
+        if (result.platforms.length === 0) {
+            return {
+                content: [
+                    textContent(`No platforms found matching "${input.query}". The user may not have used this platform yet.`),
+                ],
+            };
+        }
+        const platformList = result.platforms
+            .map((p, i) => {
+            const identifiers = [];
+            if (p.identifiers?.bundleIds?.length) {
+                identifiers.push(`Bundle IDs: ${p.identifiers.bundleIds.join(', ')}`);
+            }
+            if (p.identifiers?.domains?.length) {
+                identifiers.push(`Domains: ${p.identifiers.domains.join(', ')}`);
+            }
+            const identifiersInfo = identifiers.length > 0 ? `\n   ${identifiers.join('\n   ')}` : '';
+            const tasks = p.related_tasks.length > 0
+                ? `\n\n   **Tasks (${p.related_tasks.length}):**\n${p.related_tasks.map((t) => `   - **${t.name}** (${t.occurrence_count} time(s)) — ID: ${t.id}`).join('\n')}`
+                : '';
+            return `${i + 1}. **${p.name}** (${p.type})${identifiersInfo}
+   First seen: ${new Date(p.first_seen).toLocaleDateString()} | Last seen: ${new Date(p.last_seen).toLocaleDateString()} | Workflows: ${p.workflow_count}
+
+   **Knowledge:**
+   ${p.knowledge}${tasks}`;
+        })
+            .join('\n\n');
+        return {
+            content: [
+                textContent(`Found ${result.total_matches} platform(s) matching "${input.query}":\n\n${platformList}`),
+            ],
+        };
+    }
+    catch (error) {
+        return { content: [textContent(formatError(error))], isError: true };
+    }
+}
+async function handleGetWorkflow(client, args) {
+    try {
+        const input = getWorkflowSchema.parse(args);
+        const result = await client.getWorkflow(input);
+        const taskList = result.tasks.length > 0
+            ? result.tasks
+                .map((task, index) => {
+                return `${index + 1}. **${task.name}**
+   ID: ${task.id}
+   ${task.description}`;
+            })
+                .join('\n\n')
+            : 'No tasks identified in this workflow.';
+        return {
+            content: [
+                textContent(`# ${result.workflow.name}\n\nStatus: ${result.workflow.status} | Captures: ${result.workflow.capture_count} | Analyses: ${result.workflow.analysis_count}\nStarted: ${new Date(result.workflow.started_at).toLocaleDateString()}${result.workflow.ended_at ? ` | Ended: ${new Date(result.workflow.ended_at).toLocaleDateString()}` : ''}\n\nTasks performed (${result.tasks.length}):\n\n${taskList}\n\nUse nimbus_get_task with a task ID to get the full step-by-step playbook with screenshots.`),
+            ],
+        };
+    }
+    catch (error) {
+        return { content: [textContent(formatError(error))], isError: true };
+    }
+}
+async function handleAskUser(client, args) {
+    try {
+        const input = askUserSchema.parse(args);
+        const result = await client.askUser(input);
+        return {
+            content: [
+                textContent(`Question queued successfully!\n\nQuestion ID: ${result.question_id}\nStatus: ${result.status}\n\nThe user will be notified via the Nimbus app. Use nimbus_get_question_status to check for their response.`),
+            ],
+        };
+    }
+    catch (error) {
+        return { content: [textContent(formatError(error))], isError: true };
+    }
+}
+async function handleGetQuestionStatus(client, args) {
+    try {
+        const input = getQuestionStatusSchema.parse(args);
+        const result = await client.getQuestionStatus(input.question_id);
+        if (result.status === 'answered') {
+            return {
+                content: [
+                    textContent(`**Question:** ${result.question}\n**Status:** Answered\n**Answer:** ${result.answer}\n**Answered at:** ${result.answered_at}`),
+                ],
+            };
+        }
+        const statusMessages = {
+            pending: 'Waiting for user response...',
+            expired: 'Question expired before user responded.',
+            dismissed: 'User dismissed the question without answering.',
+        };
+        return {
+            content: [
+                textContent(`**Question:** ${result.question}\n**Status:** ${result.status}\n${statusMessages[result.status] || ''}`),
+            ],
+        };
+    }
+    catch (error) {
+        return { content: [textContent(formatError(error))], isError: true };
+    }
+}
+// ============================================================================
+// MAIN
+// ============================================================================
+async function main() {
+    // Validate API key
+    const apiKey = process.env.NIMBUS_API_KEY;
+    if (!apiKey) {
+        console.error('Error: NIMBUS_API_KEY environment variable is required');
+        console.error('');
+        console.error('Get your API key from the Nimbus app:');
+        console.error('  Settings -> Account -> MCP API Key');
+        console.error('');
+        console.error('Then run:');
+        console.error('  NIMBUS_API_KEY=your_key nimbus-mcp');
+        process.exit(1);
+    }
+    // Initialize API client
+    const client = new NimbusClient(apiKey);
+    // Create MCP server
+    const server = new Server({
+        name: SERVER_NAME,
+        version: SERVER_VERSION,
+    }, {
+        capabilities: {
+            tools: {},
+        },
+        instructions: SERVER_INSTRUCTIONS,
+    });
+    // Handle tools/list request
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+        return { tools: TOOLS };
+    });
+    // Handle tools/call request
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        switch (name) {
+            case 'nimbus_search_tasks':
+                return handleSearchTasks(client, args);
+            case 'nimbus_get_task':
+                return handleGetTask(client, args);
+            case 'nimbus_search_workflows':
+                return handleSearchWorkflows(client, args);
+            case 'nimbus_get_workflow':
+                return handleGetWorkflow(client, args);
+            case 'nimbus_search_platforms':
+                return handleSearchPlatforms(client, args);
+            case 'nimbus_ask_user':
+                return handleAskUser(client, args);
+            case 'nimbus_get_question_status':
+                return handleGetQuestionStatus(client, args);
+            default:
+                // Return structured error for unknown tools
+                return {
+                    content: [textContent(`Error: Unknown tool "${name}". Available tools: ${TOOLS.map(t => t.name).join(', ')}`)],
+                    isError: true,
+                };
+        }
+    });
+    // Start server with stdio transport
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Log to stderr (stdout is for MCP protocol)
+    console.error(`Nimbus MCP server v${SERVER_VERSION} started`);
+}
+// Run
+main().catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,162 @@
+/**
+ * Nimbus MCP Server Types
+ *
+ * These types match the Nimbus REST API responses.
+ */
+export interface NimbusResponse<T> {
+    data: T;
+    meta?: {
+        requestId: string;
+        took?: number;
+        pagination?: {
+            offset: number;
+            limit: number;
+            total: number;
+        };
+    };
+}
+export interface NimbusError {
+    error: {
+        code: string;
+        message: string;
+        details?: Record<string, unknown>;
+    };
+}
+export interface SearchTasksInput {
+    query: string;
+    platform_filter?: string;
+    limit?: number;
+}
+export interface TaskResult {
+    id: string;
+    name: string;
+    description: string;
+    confidence: number;
+    occurrence_count: number;
+    last_performed: string | null;
+    platforms: string[];
+}
+export interface SearchTasksOutput {
+    tasks: TaskResult[];
+    total_matches: number;
+}
+export interface SearchWorkflowsInput {
+    query: string;
+    limit?: number;
+}
+export interface WorkflowResult {
+    id: string;
+    name: string;
+    status: string;
+    started_at: string;
+    ended_at: string | null;
+    summary: string | null;
+    capture_count: number;
+    analysis_count: number;
+    top_tasks: Array<{
+        id: string;
+        name: string;
+    }>;
+}
+export interface SearchWorkflowsOutput {
+    workflows: WorkflowResult[];
+    total_matches: number;
+}
+export interface GetTaskInput {
+    task_id: string;
+    include_executions?: number;
+}
+export interface GetTaskOutput {
+    task: {
+        id: string;
+        name: string;
+        description: string;
+        confidence: number;
+        occurrence_count: number;
+        platforms: Array<{
+            id: string;
+            name: string;
+            knowledge: string;
+        }>;
+        subtasks: Array<{
+            id: string;
+            name: string;
+            description: string;
+        }>;
+    };
+    recent_executions: Array<{
+        id: string;
+        performed_at: string;
+        context: string;
+        steps: Array<{
+            position: number;
+            description: string;
+            screenshot_url: string | null;
+        }>;
+    }>;
+}
+export interface SearchPlatformsInput {
+    query: string;
+    limit?: number;
+}
+export interface PlatformResult {
+    id: string;
+    name: string;
+    type: string;
+    identifiers: {
+        bundleIds?: string[];
+        domains?: string[];
+    };
+    knowledge: string;
+    workflow_count: number;
+    first_seen: string;
+    last_seen: string;
+    related_tasks: Array<{
+        id: string;
+        name: string;
+        occurrence_count: number;
+    }>;
+}
+export interface SearchPlatformsOutput {
+    platforms: PlatformResult[];
+    total_matches: number;
+}
+export interface GetWorkflowInput {
+    workflow_id: string;
+}
+export interface GetWorkflowOutput {
+    workflow: {
+        id: string;
+        name: string;
+        status: string;
+        started_at: string;
+        ended_at: string | null;
+        summary: string | null;
+        capture_count: number;
+        analysis_count: number;
+    };
+    tasks: Array<{
+        id: string;
+        name: string;
+        description: string;
+    }>;
+}
+export interface AskUserInput {
+    question: string;
+    context?: string;
+    suggested_answers?: string[];
+}
+export interface AskUserOutput {
+    question_id: string;
+    status: 'queued';
+}
+export interface QuestionStatus {
+    question_id: string;
+    question: string;
+    status: 'pending' | 'answered' | 'expired' | 'dismissed';
+    answer: string | null;
+    answered_at: string | null;
+    created_at: string;
+    expires_at: string | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,7 @@
+/**
+ * Nimbus MCP Server Types
+ *
+ * These types match the Nimbus REST API responses.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@nimbus-app/mcp",
+  "version": "1.0.0",
+  "description": "MCP server for Nimbus - Access your workflow memory from Claude",
+  "author": "Nimbus <support@nimbusai.cloud>",
+  "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nimbus-app/nimbus.git",
+    "directory": "packages/mcp-server"
+  },
+  "homepage": "https://nimbusai.cloud/docs/mcp",
+  "bugs": {
+    "url": "https://github.com/nimbus-app/nimbus/issues"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "claude",
+    "ai",
+    "workflow",
+    "automation",
+    "nimbus"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "nimbus-mcp": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "node-fetch": "^3.3.2",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "typescript": "^5.3.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}