@daxaur/ctrl-mcp 0.1.0

package/dist/tools/get-execution-logs.js

@@ -0,0 +1,80 @@
+/**
+ * ctrl_get_execution_logs — read recent workflow executions.
+ *
+ * Returns each fire with its trigger, status, tx hash (if onchain), gas, and
+ * timing. Use to confirm a workflow is firing as expected or to debug failures.
+ */
+import { z } from 'zod';
+import { ctrlFetch } from '../client.js';
+const GetLogsInputSchema = z.object({
+    workflowId: z.string().min(1).optional(),
+    limit: z.number().int().min(1).max(100).default(10),
+});
+export const GET_EXECUTION_LOGS_TOOL = {
+    name: 'ctrl_get_execution_logs',
+    description: 'Fetch recent executions of a CTRL workflow. Each log shows the trigger that fired, the status (success/failed/pending), the BaseScan tx hash if onchain, gas used, and timing. Use to confirm the keeper is executing the workflow, debug failures, or surface results back to the user. Without workflowId, returns the user\'s most recent executions across all workflows.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            workflowId: {
+                type: 'string',
+                description: 'Filter to one workflow. Omit to see recent executions across all the user\'s workflows.',
+            },
+            limit: {
+                type: 'number',
+                description: 'Max logs to return. Default 10, max 100.',
+                default: 10,
+            },
+        },
+    },
+};
+export async function handleGetExecutionLogs(rawInput) {
+    const input = GetLogsInputSchema.parse(rawInput);
+    const res = await ctrlFetch('/api/mcp/execution-logs', {
+        query: {
+            workflow_id: input.workflowId,
+            limit: input.limit,
+            offset: 0,
+        },
+    });
+    if (res.logs.length === 0) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: input.workflowId
+                        ? `No executions yet for workflow ${input.workflowId}. Either the trigger hasn\'t fired or the workflow isn\'t active yet.`
+                        : 'No executions found.',
+                },
+            ],
+            structuredContent: { logs: [], count: 0 },
+        };
+    }
+    const summary = res.logs
+        .map((log) => {
+        const statusIcon = log.status === 'success' ? '✓' : log.status === 'failed' ? '✗' : '…';
+        const txInfo = log.transaction_hash
+            ? ` — https://basescan.org/tx/${log.transaction_hash}`
+            : '';
+        const error = log.error_message ? ` (${log.error_message})` : '';
+        return `${statusIcon} ${log.started_at} — ${log.trigger_type} — ${log.status}${txInfo}${error}`;
+    })
+        .join('\n');
+    return {
+        content: [
+            {
+                type: 'text',
+                text: [
+                    `${res.logs.length} execution${res.logs.length === 1 ? '' : 's'}:`,
+                    '',
+                    summary,
+                ].join('\n'),
+            },
+        ],
+        structuredContent: {
+            logs: res.logs,
+            count: res.logs.length,
+        },
+    };
+}
+//# sourceMappingURL=get-execution-logs.js.map

package/dist/tools/get-execution-logs.js.map

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

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@daxaur/ctrl-mcp",
+  "version": "0.1.0",
+  "description": "Base MCP plugin for CTRL — turn natural language into onchain workflow automations on Base. Sign once, trade forever.",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "ctrl-mcp": "dist/index.js",
+    "daxaur-ctrl-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx watch src/index.ts",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "base",
+    "base-mcp",
+    "ctrl",
+    "automation",
+    "defi",
+    "agent",
+    "claude",
+    "cursor"
+  ],
+  "author": "CTRL Labs",
+  "license": "MIT",
+  "homepage": "https://ctrl.build/mcp",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ctrl-build/ctrl"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "viem": "^2.21.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}