flashq-mcp 0.1.0

package/README.md

@@ -0,0 +1,159 @@
+# flashQ MCP Server
+
+[![npm version](https://badge.fury.io/js/flashq-mcp.svg)](https://www.npmjs.com/package/flashq-mcp)
+
+MCP (Model Context Protocol) server that enables AI assistants like Claude to manage flashQ job queues.
+
+## Installation
+
+```bash
+npm install -g flashq-mcp
+```
+
+Or use directly with npx:
+
+```bash
+npx flashq-mcp
+```
+
+## Quick Start
+
+1. **Start flashQ server** with HTTP API enabled:
+
+```bash
+cd engine
+HTTP=1 cargo run --release
+```
+
+2. **Configure Claude Desktop** (`~/.config/claude/claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "flashq": {
+      "command": "npx",
+      "args": ["flashq-mcp"],
+      "env": {
+        "FLASHQ_HOST": "localhost",
+        "FLASHQ_HTTP_PORT": "6790"
+      }
+    }
+  }
+}
+```
+
+3. **Restart Claude Desktop** and start managing queues!
+
+## Configuration
+
+Environment variables:
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `FLASHQ_HOST` | localhost | flashQ server host |
+| `FLASHQ_HTTP_PORT` | 6790 | HTTP API port |
+| `FLASHQ_TOKEN` | - | Auth token (optional) |
+| `FLASHQ_TIMEOUT` | 30000 | Request timeout (ms) |
+
+## Available Tools (25)
+
+### Job Operations (10 tools)
+
+| Tool | Description |
+|------|-------------|
+| `push_job` | Create a new job with priority, delay, retry options |
+| `push_batch_jobs` | Create multiple jobs at once (max 1000) |
+| `get_job` | Get job details with current state |
+| `get_job_state` | Get only the job state |
+| `get_job_result` | Get completed job result |
+| `get_job_by_custom_id` | Find job by custom ID |
+| `list_jobs` | List jobs with filtering and pagination |
+| `get_job_counts` | Get job counts by state for a queue |
+| `cancel_job` | Cancel a pending job |
+| `get_job_progress` | Get progress for active job |
+
+### Queue Management (8 tools)
+
+| Tool | Description |
+|------|-------------|
+| `list_queues` | List all queues with status |
+| `pause_queue` | Pause queue processing |
+| `resume_queue` | Resume paused queue |
+| `is_queue_paused` | Check if queue is paused |
+| `drain_queue` | Remove all waiting jobs |
+| `count_jobs` | Count waiting + delayed jobs |
+| `set_rate_limit` | Set jobs/sec limit |
+| `clear_rate_limit` | Remove rate limit |
+
+### Dead Letter Queue (3 tools)
+
+| Tool | Description |
+|------|-------------|
+| `get_dlq` | Get failed jobs from DLQ |
+| `retry_dlq` | Retry DLQ jobs |
+| `purge_dlq` | Remove all DLQ jobs |
+
+### Monitoring (2 tools)
+
+| Tool | Description |
+|------|-------------|
+| `get_stats` | Get overall queue statistics |
+| `get_metrics` | Get detailed performance metrics |
+
+### Admin (2 tools)
+
+| Tool | Description |
+|------|-------------|
+| `list_crons` | List scheduled cron jobs |
+| `clean_jobs` | Clean old jobs by age/state |
+
+## Example Conversations
+
+Once configured, you can ask Claude:
+
+- "Push a job to the orders queue with priority 10"
+- "How many jobs are waiting in the emails queue?"
+- "Show me the failed jobs in the payments queue"
+- "Retry all DLQ jobs for the notifications queue"
+- "Pause the sync queue"
+- "What's the current throughput?"
+
+## Architecture
+
+```
+┌─────────────┐     MCP (stdio)     ┌─────────────────┐     HTTP     ┌─────────────┐
+│   Claude    │ ◄─────────────────► │  flashQ MCP     │ ◄──────────► │  flashQ     │
+│             │                     │  Server (TS)    │   :6790      │  Engine     │
+└─────────────┘                     └─────────────────┘              └─────────────┘
+```
+
+## Development
+
+```bash
+# Clone and install
+git clone https://github.com/flashq/flashq.git
+cd flashq/mcp
+bun install
+
+# Development
+bun run dev
+
+# Type check
+bun run typecheck
+
+# Lint
+bun run lint
+
+# Format
+bun run format
+
+# Build
+bun run build
+
+# Test
+bun run test
+```
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,13 @@
+/**
+ * HTTP client for flashQ API
+ * Reuses patterns from sdk/typescript/src/client/http/request.ts
+ */
+import type { FlashQConfig } from './config.js';
+export declare class FlashQClient {
+    private baseUrl;
+    private headers;
+    private timeout;
+    constructor(config: FlashQConfig);
+    send<T>(cmd: string, params?: Record<string, unknown>): Promise<T>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAoIhD,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,YAAY;IAM1B,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,CAAC,CAAC;CAsB7E"}

package/dist/client.js

@@ -0,0 +1,153 @@
+/**
+ * HTTP client for flashQ API
+ * Reuses patterns from sdk/typescript/src/client/http/request.ts
+ */
+import { FlashQError } from './errors.js';
+function buildHeaders(token) {
+    const headers = { 'Content-Type': 'application/json' };
+    if (token)
+        headers['Authorization'] = `Bearer ${token}`;
+    return headers;
+}
+const encodeQueue = (queue) => encodeURIComponent(String(queue));
+function buildRequest(baseUrl, cmd, params) {
+    switch (cmd) {
+        // Core operations
+        case 'PUSH':
+            return {
+                url: `${baseUrl}/queues/${encodeQueue(params.queue)}/jobs`,
+                method: 'POST',
+                body: JSON.stringify({
+                    data: params.data,
+                    priority: params.priority,
+                    delay: params.delay,
+                    ttl: params.ttl,
+                    timeout: params.timeout,
+                    max_attempts: params.max_attempts,
+                    backoff: params.backoff,
+                    unique_key: params.unique_key,
+                    depends_on: params.depends_on,
+                    tags: params.tags,
+                    job_id: params.job_id,
+                }),
+            };
+        case 'PUSHB':
+            return {
+                url: `${baseUrl}/queues/${encodeQueue(params.queue)}/jobs/batch`,
+                method: 'POST',
+                body: JSON.stringify({ jobs: params.jobs }),
+            };
+        // Job queries
+        case 'GETJOB':
+            return { url: `${baseUrl}/jobs/${params.id}`, method: 'GET' };
+        case 'GETSTATE':
+            return { url: `${baseUrl}/jobs/${params.id}/state`, method: 'GET' };
+        case 'GETRESULT':
+            return { url: `${baseUrl}/jobs/${params.id}/result`, method: 'GET' };
+        case 'GETJOBBYCUSTOMID':
+            return {
+                url: `${baseUrl}/jobs/custom/${encodeURIComponent(String(params.custom_id))}`,
+                method: 'GET',
+            };
+        case 'GETJOBS': {
+            const q = [];
+            if (params.queue)
+                q.push(`queue=${encodeQueue(params.queue)}`);
+            if (params.state)
+                q.push(`state=${params.state}`);
+            if (params.limit)
+                q.push(`limit=${params.limit}`);
+            if (params.offset)
+                q.push(`offset=${params.offset}`);
+            return { url: `${baseUrl}/jobs${q.length ? '?' + q.join('&') : ''}`, method: 'GET' };
+        }
+        case 'GETJOBCOUNTS':
+            return { url: `${baseUrl}/queues/${encodeQueue(params.queue)}/counts`, method: 'GET' };
+        case 'COUNT':
+            return { url: `${baseUrl}/queues/${encodeQueue(params.queue)}/count`, method: 'GET' };
+        case 'GETPROGRESS':
+            return { url: `${baseUrl}/jobs/${params.id}/progress`, method: 'GET' };
+        // Job management
+        case 'CANCEL':
+            return { url: `${baseUrl}/jobs/${params.id}/cancel`, method: 'POST' };
+        // Queue management
+        case 'LISTQUEUES':
+            return { url: `${baseUrl}/queues`, method: 'GET' };
+        case 'PAUSE':
+            return { url: `${baseUrl}/queues/${encodeQueue(params.queue)}/pause`, method: 'POST' };
+        case 'RESUME':
+            return { url: `${baseUrl}/queues/${encodeQueue(params.queue)}/resume`, method: 'POST' };
+        case 'ISPAUSED':
+            return { url: `${baseUrl}/queues/${encodeQueue(params.queue)}/paused`, method: 'GET' };
+        case 'DRAIN':
+            return { url: `${baseUrl}/queues/${encodeQueue(params.queue)}/drain`, method: 'POST' };
+        case 'RATELIMIT':
+            return {
+                url: `${baseUrl}/queues/${encodeQueue(params.queue)}/ratelimit`,
+                method: 'POST',
+                body: JSON.stringify({ limit: params.limit }),
+            };
+        case 'RATELIMITCLEAR':
+            return { url: `${baseUrl}/queues/${encodeQueue(params.queue)}/ratelimit`, method: 'DELETE' };
+        // DLQ
+        case 'DLQ':
+            return {
+                url: `${baseUrl}/queues/${encodeQueue(params.queue)}/dlq?count=${params.count ?? 100}`,
+                method: 'GET',
+            };
+        case 'RETRYDLQ':
+            return params.id
+                ? {
+                    url: `${baseUrl}/queues/${encodeQueue(params.queue)}/dlq/${params.id}/retry`,
+                    method: 'POST',
+                }
+                : { url: `${baseUrl}/queues/${encodeQueue(params.queue)}/dlq/retry`, method: 'POST' };
+        case 'PURGEDLQ':
+            return { url: `${baseUrl}/queues/${encodeQueue(params.queue)}/dlq`, method: 'DELETE' };
+        // Monitoring
+        case 'STATS':
+            return { url: `${baseUrl}/stats`, method: 'GET' };
+        case 'METRICS':
+            return { url: `${baseUrl}/metrics`, method: 'GET' };
+        // Admin
+        case 'CRONLIST':
+            return { url: `${baseUrl}/crons`, method: 'GET' };
+        case 'CLEAN':
+            return {
+                url: `${baseUrl}/queues/${encodeQueue(params.queue)}/clean`,
+                method: 'POST',
+                body: JSON.stringify({ grace: params.grace, state: params.state, limit: params.limit }),
+            };
+        default:
+            throw new FlashQError(`Unknown command: ${cmd}`, 400, 'UNKNOWN_COMMAND');
+    }
+}
+export class FlashQClient {
+    baseUrl;
+    headers;
+    timeout;
+    constructor(config) {
+        this.baseUrl = `http://${config.host}:${config.httpPort}`;
+        this.headers = buildHeaders(config.token);
+        this.timeout = config.timeout;
+    }
+    async send(cmd, params = {}) {
+        const request = buildRequest(this.baseUrl, cmd, params);
+        const response = await fetch(request.url, {
+            method: request.method,
+            headers: this.headers,
+            body: request.body,
+            signal: AbortSignal.timeout(this.timeout),
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new FlashQError(errorText || response.statusText, response.status);
+        }
+        const data = (await response.json());
+        if (!data.ok) {
+            throw new FlashQError(data.error || 'Unknown error', 500);
+        }
+        return data;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Configuration loading from environment variables
+ */
+export interface FlashQConfig {
+    host: string;
+    httpPort: number;
+    token?: string;
+    timeout: number;
+}
+export interface Config {
+    flashq: FlashQConfig;
+}
+export declare function loadConfig(): Config;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,MAAM;IACrB,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,wBAAgB,UAAU,IAAI,MAAM,CASnC"}

package/dist/config.js

@@ -0,0 +1,14 @@
+/**
+ * Configuration loading from environment variables
+ */
+export function loadConfig() {
+    return {
+        flashq: {
+            host: process.env.FLASHQ_HOST || 'localhost',
+            httpPort: parseInt(process.env.FLASHQ_HTTP_PORT || '6790', 10),
+            token: process.env.FLASHQ_TOKEN,
+            timeout: parseInt(process.env.FLASHQ_TIMEOUT || '30000', 10),
+        },
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAaH,MAAM,UAAU,UAAU;IACxB,OAAO;QACL,MAAM,EAAE;YACN,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,WAAW;YAC5C,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,MAAM,EAAE,EAAE,CAAC;YAC9D,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,YAAY;YAC/B,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,OAAO,EAAE,EAAE,CAAC;SAC7D;KACF,CAAC;AACJ,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Error handling utilities for MCP responses
+ */
+export declare class FlashQError extends Error {
+    readonly statusCode: number;
+    readonly code?: string | undefined;
+    constructor(message: string, statusCode: number, code?: string | undefined);
+}
+export interface McpTextContent {
+    type: 'text';
+    text: string;
+    [key: string]: unknown;
+}
+export interface McpResponse {
+    content: McpTextContent[];
+    isError?: boolean;
+    [key: string]: unknown;
+}
+export declare function formatError(error: unknown): McpResponse;
+export declare function formatSuccess<T>(data: T): McpResponse;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,qBAAa,WAAY,SAAQ,KAAK;aAGlB,UAAU,EAAE,MAAM;aAClB,IAAI,CAAC,EAAE,MAAM;gBAF7B,OAAO,EAAE,MAAM,EACC,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE,MAAM,YAAA;CAKhC;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAqCvD;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,WAAW,CASrD"}

package/dist/errors.js

@@ -0,0 +1,53 @@
+/**
+ * Error handling utilities for MCP responses
+ */
+export class FlashQError extends Error {
+    statusCode;
+    code;
+    constructor(message, statusCode, code) {
+        super(message);
+        this.statusCode = statusCode;
+        this.code = code;
+        this.name = 'FlashQError';
+    }
+}
+export function formatError(error) {
+    if (error instanceof FlashQError) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        error: error.message,
+                        code: error.code || 'FLASHQ_ERROR',
+                        statusCode: error.statusCode,
+                    }, null, 2),
+                },
+            ],
+            isError: true,
+        };
+    }
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify({
+                    error: error instanceof Error ? error.message : 'Unknown error',
+                    code: 'INTERNAL_ERROR',
+                }, null, 2),
+            },
+        ],
+        isError: true,
+    };
+}
+export function formatSuccess(data) {
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify(data, null, 2),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,OAAO,WAAY,SAAQ,KAAK;IAGlB;IACA;IAHlB,YACE,OAAe,EACC,UAAkB,EAClB,IAAa;QAE7B,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,eAAU,GAAV,UAAU,CAAQ;QAClB,SAAI,GAAJ,IAAI,CAAS;QAG7B,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAcD,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,KAAK,YAAY,WAAW,EAAE,CAAC;QACjC,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;wBACE,KAAK,EAAE,KAAK,CAAC,OAAO;wBACpB,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,cAAc;wBAClC,UAAU,EAAE,KAAK,CAAC,UAAU;qBAC7B,EACD,IAAI,EACJ,CAAC,CACF;iBACF;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;oBACE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;oBAC/D,IAAI,EAAE,gBAAgB;iBACvB,EACD,IAAI,EACJ,CAAC,CACF;aACF;SACF;QACD,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAI,IAAO;IACtC,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;aACpC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+/**
+ * flashQ MCP Server - Entry Point
+ *
+ * Enables AI assistants to manage flashQ job queues through the
+ * Model Context Protocol (MCP).
+ *
+ * Environment variables:
+ *   FLASHQ_HOST       - Server host (default: localhost)
+ *   FLASHQ_HTTP_PORT  - HTTP API port (default: 6790)
+ *   FLASHQ_TOKEN      - Auth token (optional)
+ *   FLASHQ_TIMEOUT    - Request timeout in ms (default: 30000)
+ */
+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;;;;;;;;;;;GAWG"}

package/dist/index.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+/**
+ * flashQ MCP Server - Entry Point
+ *
+ * Enables AI assistants to manage flashQ job queues through the
+ * Model Context Protocol (MCP).
+ *
+ * Environment variables:
+ *   FLASHQ_HOST       - Server host (default: localhost)
+ *   FLASHQ_HTTP_PORT  - HTTP API port (default: 6790)
+ *   FLASHQ_TOKEN      - Auth token (optional)
+ *   FLASHQ_TIMEOUT    - Request timeout in ms (default: 30000)
+ */
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createServer } from './server.js';
+async function main() {
+    const server = createServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Log to stderr (stdout is reserved for MCP protocol)
+    console.error('flashQ MCP server started');
+}
+main().catch((error) => {
+    console.error('Failed to start flashQ MCP server:', 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":";AACA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAE7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,sDAAsD;IACtD,OAAO,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;AAC7C,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,oCAAoC,EAAE,KAAK,CAAC,CAAC;IAC3D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,6 @@
+/**
+ * MCP server setup and configuration
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function createServer(): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE,wBAAgB,YAAY,IAAI,SAAS,CAaxC"}

package/dist/server.js

@@ -0,0 +1,18 @@
+/**
+ * MCP server setup and configuration
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { FlashQClient } from './client.js';
+import { loadConfig } from './config.js';
+import { registerAllTools } from './tools/index.js';
+export function createServer() {
+    const config = loadConfig();
+    const client = new FlashQClient(config.flashq);
+    const server = new McpServer({
+        name: 'flashq',
+        version: '0.1.0',
+    });
+    registerAllTools(server, client);
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAE5B,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAE/C,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/tools/admin.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Admin tools for MCP server
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { FlashQClient } from '../client.js';
+export declare function registerAdminTools(server: McpServer, client: FlashQClient): void;
+//# sourceMappingURL=admin.d.ts.map

package/dist/tools/admin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin.d.ts","sourceRoot":"","sources":["../../src/tools/admin.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAGjD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CA0ChF"}

package/dist/tools/admin.js

@@ -0,0 +1,40 @@
+/**
+ * Admin tools for MCP server
+ */
+import { z } from 'zod';
+import { formatSuccess, formatError } from '../errors.js';
+export function registerAdminTools(server, client) {
+    // list_crons
+    server.tool('list_crons', 'List all scheduled cron jobs with their schedules, next run times, target queues, and execution counts.', {}, async () => {
+        try {
+            const result = await client.send('CRONLIST');
+            return formatSuccess(result);
+        }
+        catch (error) {
+            return formatError(error);
+        }
+    });
+    // clean_jobs
+    server.tool('clean_jobs', 'Remove old jobs from a queue based on age and state. Useful for maintenance and cleaning up completed or failed jobs.', {
+        queue: z.string().describe('Queue name'),
+        grace_ms: z.number().describe('Remove jobs older than this many milliseconds'),
+        state: z
+            .enum(['waiting', 'delayed', 'completed', 'failed'])
+            .describe('State of jobs to clean'),
+        limit: z.number().optional().describe('Maximum number of jobs to remove'),
+    }, async (args) => {
+        try {
+            const result = await client.send('CLEAN', {
+                queue: args.queue,
+                grace: args.grace_ms,
+                state: args.state,
+                limit: args.limit,
+            });
+            return formatSuccess(result);
+        }
+        catch (error) {
+            return formatError(error);
+        }
+    });
+}
+//# sourceMappingURL=admin.js.map

package/dist/tools/admin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin.js","sourceRoot":"","sources":["../../src/tools/admin.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE1D,MAAM,UAAU,kBAAkB,CAAC,MAAiB,EAAE,MAAoB;IACxE,aAAa;IACb,MAAM,CAAC,IAAI,CACT,YAAY,EACZ,yGAAyG,EACzG,EAAE,EACF,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC7C,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC;QAC/B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CACF,CAAC;IAEF,aAAa;IACb,MAAM,CAAC,IAAI,CACT,YAAY,EACZ,uHAAuH,EACvH;QACE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;QACxC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;QAC9E,KAAK,EAAE,CAAC;aACL,IAAI,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;aACnD,QAAQ,CAAC,wBAAwB,CAAC;QACrC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;KAC1E,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE;gBACxC,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,KAAK,EAAE,IAAI,CAAC,QAAQ;gBACpB,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,KAAK,EAAE,IAAI,CAAC,KAAK;aAClB,CAAC,CAAC;YACH,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC;QAC/B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/dlq.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Dead Letter Queue (DLQ) tools for MCP server
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { FlashQClient } from '../client.js';
+export declare function registerDlqTools(server: McpServer, client: FlashQClient): void;
+//# sourceMappingURL=dlq.d.ts.map

package/dist/tools/dlq.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dlq.d.ts","sourceRoot":"","sources":["../../src/tools/dlq.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAGjD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAwD9E"}

package/dist/tools/dlq.js

@@ -0,0 +1,49 @@
+/**
+ * Dead Letter Queue (DLQ) tools for MCP server
+ */
+import { z } from 'zod';
+import { formatSuccess, formatError } from '../errors.js';
+export function registerDlqTools(server, client) {
+    // get_dlq
+    server.tool('get_dlq', 'Get jobs from the Dead Letter Queue (DLQ) for a specific queue. These are jobs that failed after exhausting all retry attempts.', {
+        queue: z.string().describe('Queue name'),
+        count: z.number().max(100).default(20).describe('Maximum jobs to return (max 100)'),
+    }, async (args) => {
+        try {
+            const result = await client.send('DLQ', { queue: args.queue, count: args.count });
+            return formatSuccess(result);
+        }
+        catch (error) {
+            return formatError(error);
+        }
+    });
+    // retry_dlq
+    server.tool('retry_dlq', 'Retry jobs from the Dead Letter Queue. Can retry all jobs in the queue or a specific job by ID. Jobs are moved back to waiting state.', {
+        queue: z.string().describe('Queue name'),
+        job_id: z
+            .number()
+            .optional()
+            .describe('Specific job ID to retry, or omit to retry all DLQ jobs'),
+    }, async (args) => {
+        try {
+            const result = await client.send('RETRYDLQ', { queue: args.queue, id: args.job_id });
+            return formatSuccess(result);
+        }
+        catch (error) {
+            return formatError(error);
+        }
+    });
+    // purge_dlq
+    server.tool('purge_dlq', 'Permanently remove all jobs from the Dead Letter Queue for a specific queue. This action cannot be undone.', {
+        queue: z.string().describe('Queue name'),
+    }, async (args) => {
+        try {
+            const result = await client.send('PURGEDLQ', { queue: args.queue });
+            return formatSuccess(result);
+        }
+        catch (error) {
+            return formatError(error);
+        }
+    });
+}
+//# sourceMappingURL=dlq.js.map

package/dist/tools/dlq.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dlq.js","sourceRoot":"","sources":["../../src/tools/dlq.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE1D,MAAM,UAAU,gBAAgB,CAAC,MAAiB,EAAE,MAAoB;IACtE,UAAU;IACV,MAAM,CAAC,IAAI,CACT,SAAS,EACT,iIAAiI,EACjI;QACE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;QACxC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,kCAAkC,CAAC;KACpF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YAClF,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC;QAC/B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CACF,CAAC;IAEF,YAAY;IACZ,MAAM,CAAC,IAAI,CACT,WAAW,EACX,uIAAuI,EACvI;QACE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;QACxC,MAAM,EAAE,CAAC;aACN,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,yDAAyD,CAAC;KACvE,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,EAAE,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;YACrF,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC;QAC/B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CACF,CAAC;IAEF,YAAY;IACZ,MAAM,CAAC,IAAI,CACT,WAAW,EACX,4GAA4G,EAC5G;QACE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;KACzC,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YACpE,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC;QAC/B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Tool registration aggregator
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { FlashQClient } from '../client.js';
+export declare function registerAllTools(server: McpServer, client: FlashQClient): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAOjD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAM9E"}

package/dist/tools/index.js

@@ -0,0 +1,16 @@
+/**
+ * Tool registration aggregator
+ */
+import { registerJobTools } from './jobs.js';
+import { registerQueueTools } from './queues.js';
+import { registerDlqTools } from './dlq.js';
+import { registerMonitoringTools } from './monitoring.js';
+import { registerAdminTools } from './admin.js';
+export function registerAllTools(server, client) {
+    registerJobTools(server, client);
+    registerQueueTools(server, client);
+    registerDlqTools(server, client);
+    registerMonitoringTools(server, client);
+    registerAdminTools(server, client);
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,UAAU,gBAAgB,CAAC,MAAiB,EAAE,MAAoB;IACtE,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,uBAAuB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACrC,CAAC"}

package/dist/tools/jobs.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Job operation tools for MCP server
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { FlashQClient } from '../client.js';
+export declare function registerJobTools(server: McpServer, client: FlashQClient): void;
+//# sourceMappingURL=jobs.d.ts.map

package/dist/tools/jobs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobs.d.ts","sourceRoot":"","sources":["../../src/tools/jobs.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAGjD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CA4N9E"}

package/dist/tools/jobs.js

@@ -0,0 +1,176 @@
+/**
+ * Job operation tools for MCP server
+ */
+import { z } from 'zod';
+import { formatSuccess, formatError } from '../errors.js';
+export function registerJobTools(server, client) {
+    // push_job
+    server.tool('push_job', 'Create a new job in a flashQ queue. Use this to add work items that workers will process. Returns the created job ID.', {
+        queue: z.string().describe('Queue name (alphanumeric, underscore, hyphen, dot)'),
+        data: z.any().describe('Job payload data (JSON object)'),
+        priority: z
+            .number()
+            .optional()
+            .describe('Job priority (higher = processed first, default: 0)'),
+        delay: z.number().optional().describe('Delay in milliseconds before job is available'),
+        max_attempts: z
+            .number()
+            .optional()
+            .describe('Maximum retry attempts (default: 0 = no retry)'),
+        timeout: z.number().optional().describe('Job processing timeout in milliseconds'),
+        ttl: z.number().optional().describe('Time-to-live in milliseconds (job expires after)'),
+        unique_key: z.string().optional().describe('Unique key for deduplication'),
+        jobId: z.string().optional().describe('Custom job ID for idempotent operations'),
+        tags: z.array(z.string()).optional().describe('Tags for filtering'),
+    }, async (args) => {
+        try {
+            const result = await client.send('PUSH', {
+                queue: args.queue,
+                data: args.data,
+                priority: args.priority,
+                delay: args.delay,
+                max_attempts: args.max_attempts,
+                timeout: args.timeout,
+                ttl: args.ttl,
+                unique_key: args.unique_key,
+                job_id: args.jobId,
+                tags: args.tags,
+            });
+            return formatSuccess(result);
+        }
+        catch (error) {
+            return formatError(error);
+        }
+    });
+    // push_batch_jobs
+    server.tool('push_batch_jobs', 'Create multiple jobs at once for efficient bulk operations. Maximum 1000 jobs per batch.', {
+        queue: z.string().describe('Queue name'),
+        jobs: z
+            .array(z.object({
+            data: z.any().describe('Job payload'),
+            priority: z.number().optional().describe('Job priority'),
+            delay: z.number().optional().describe('Delay in milliseconds'),
+        }))
+            .max(1000)
+            .describe('Array of jobs to create (max 1000)'),
+    }, async (args) => {
+        try {
+            const result = await client.send('PUSHB', {
+                queue: args.queue,
+                jobs: args.jobs,
+            });
+            return formatSuccess(result);
+        }
+        catch (error) {
+            return formatError(error);
+        }
+    });
+    // get_job
+    server.tool('get_job', 'Get detailed information about a specific job including its current state, data, and metadata.', {
+        job_id: z.number().describe('Numeric job ID'),
+    }, async (args) => {
+        try {
+            const result = await client.send('GETJOB', { id: args.job_id });
+            return formatSuccess(result);
+        }
+        catch (error) {
+            return formatError(error);
+        }
+    });
+    // get_job_state
+    server.tool('get_job_state', 'Get only the current state of a job. Returns: waiting, delayed, active, completed, or failed.', {
+        job_id: z.number().describe('Numeric job ID'),
+    }, async (args) => {
+        try {
+            const result = await client.send('GETSTATE', { id: args.job_id });
+            return formatSuccess(result);
+        }
+        catch (error) {
+            return formatError(error);
+        }
+    });
+    // get_job_result
+    server.tool('get_job_result', 'Get the result data from a completed job. Returns null if job is not completed or result was not stored.', {
+        job_id: z.number().describe('Numeric job ID'),
+    }, async (args) => {
+        try {
+            const result = await client.send('GETRESULT', { id: args.job_id });
+            return formatSuccess(result);
+        }
+        catch (error) {
+            return formatError(error);
+        }
+    });
+    // get_job_by_custom_id
+    server.tool('get_job_by_custom_id', 'Find a job using its custom ID (set via jobId option during push). Useful for idempotent operations and tracking.', {
+        custom_id: z.string().describe('Custom job ID'),
+    }, async (args) => {
+        try {
+            const result = await client.send('GETJOBBYCUSTOMID', { custom_id: args.custom_id });
+            return formatSuccess(result);
+        }
+        catch (error) {
+            return formatError(error);
+        }
+    });
+    // list_jobs
+    server.tool('list_jobs', 'List jobs with optional filtering by queue and state. Supports pagination for large result sets.', {
+        queue: z.string().optional().describe('Filter by queue name'),
+        state: z
+            .enum(['waiting', 'delayed', 'active', 'completed', 'failed'])
+            .optional()
+            .describe('Filter by job state'),
+        limit: z.number().max(100).default(20).describe('Maximum jobs to return (max 100)'),
+        offset: z.number().default(0).describe('Offset for pagination'),
+    }, async (args) => {
+        try {
+            const result = await client.send('GETJOBS', {
+                queue: args.queue,
+                state: args.state,
+                limit: args.limit,
+                offset: args.offset,
+            });
+            return formatSuccess(result);
+        }
+        catch (error) {
+            return formatError(error);
+        }
+    });
+    // get_job_counts
+    server.tool('get_job_counts', 'Get the count of jobs in each state (waiting, active, delayed, completed, failed) for a specific queue.', {
+        queue: z.string().describe('Queue name'),
+    }, async (args) => {
+        try {
+            const result = await client.send('GETJOBCOUNTS', { queue: args.queue });
+            return formatSuccess(result);
+        }
+        catch (error) {
+            return formatError(error);
+        }
+    });
+    // cancel_job
+    server.tool('cancel_job', 'Cancel a job that is waiting or delayed. Cannot cancel jobs that are already being processed (active).', {
+        job_id: z.number().describe('Numeric job ID to cancel'),
+    }, async (args) => {
+        try {
+            const result = await client.send('CANCEL', { id: args.job_id });
+            return formatSuccess(result);
+        }
+        catch (error) {
+            return formatError(error);
+        }
+    });
+    // get_job_progress
+    server.tool('get_job_progress', 'Get the progress percentage and message for an active job. Used for long-running tasks that report progress.', {
+        job_id: z.number().describe('Numeric job ID'),
+    }, async (args) => {
+        try {
+            const result = await client.send('GETPROGRESS', { id: args.job_id });
+            return formatSuccess(result);
+        }
+        catch (error) {
+            return formatError(error);
+        }
+    });
+}
+//# sourceMappingURL=jobs.js.map

package/dist/tools/jobs.js.map

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

package/dist/tools/monitoring.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Monitoring and metrics tools for MCP server
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { FlashQClient } from '../client.js';
+export declare function registerMonitoringTools(server: McpServer, client: FlashQClient): void;
+//# sourceMappingURL=monitoring.d.ts.map

package/dist/tools/monitoring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitoring.d.ts","sourceRoot":"","sources":["../../src/tools/monitoring.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAGjD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CA8BrF"}

package/dist/tools/monitoring.js

@@ -0,0 +1,27 @@
+/**
+ * Monitoring and metrics tools for MCP server
+ */
+import { formatSuccess, formatError } from '../errors.js';
+export function registerMonitoringTools(server, client) {
+    // get_stats
+    server.tool('get_stats', 'Get overall statistics for the flashQ server including total queued jobs, processing count, delayed count, and DLQ count across all queues.', {}, async () => {
+        try {
+            const result = await client.send('STATS');
+            return formatSuccess(result);
+        }
+        catch (error) {
+            return formatError(error);
+        }
+    });
+    // get_metrics
+    server.tool('get_metrics', 'Get detailed performance metrics including throughput (jobs/sec), average latency, total pushed/completed/failed counts, and per-queue breakdown.', {}, async () => {
+        try {
+            const result = await client.send('METRICS');
+            return formatSuccess(result);
+        }
+        catch (error) {
+            return formatError(error);
+        }
+    });
+}
+//# sourceMappingURL=monitoring.js.map

package/dist/tools/monitoring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitoring.js","sourceRoot":"","sources":["../../src/tools/monitoring.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE1D,MAAM,UAAU,uBAAuB,CAAC,MAAiB,EAAE,MAAoB;IAC7E,YAAY;IACZ,MAAM,CAAC,IAAI,CACT,WAAW,EACX,6IAA6I,EAC7I,EAAE,EACF,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC1C,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC;QAC/B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CACF,CAAC;IAEF,cAAc;IACd,MAAM,CAAC,IAAI,CACT,aAAa,EACb,mJAAmJ,EACnJ,EAAE,EACF,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC5C,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC;QAC/B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/queues.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Queue management tools for MCP server
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { FlashQClient } from '../client.js';
+export declare function registerQueueTools(server: McpServer, client: FlashQClient): void;
+//# sourceMappingURL=queues.d.ts.map

package/dist/tools/queues.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queues.d.ts","sourceRoot":"","sources":["../../src/tools/queues.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAGjD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAuIhF"}

package/dist/tools/queues.js

@@ -0,0 +1,103 @@
+/**
+ * Queue management tools for MCP server
+ */
+import { z } from 'zod';
+import { formatSuccess, formatError } from '../errors.js';
+export function registerQueueTools(server, client) {
+    // list_queues
+    server.tool('list_queues', 'List all queues in the flashQ server with their current status including pending count, processing count, DLQ count, and paused state.', {}, async () => {
+        try {
+            const result = await client.send('LISTQUEUES');
+            return formatSuccess(result);
+        }
+        catch (error) {
+            return formatError(error);
+        }
+    });
+    // pause_queue
+    server.tool('pause_queue', 'Pause a queue to temporarily stop workers from pulling new jobs. Existing active jobs will continue processing until completion.', {
+        queue: z.string().describe('Queue name to pause'),
+    }, async (args) => {
+        try {
+            const result = await client.send('PAUSE', { queue: args.queue });
+            return formatSuccess(result);
+        }
+        catch (error) {
+            return formatError(error);
+        }
+    });
+    // resume_queue
+    server.tool('resume_queue', 'Resume a paused queue to allow workers to pull jobs again.', {
+        queue: z.string().describe('Queue name to resume'),
+    }, async (args) => {
+        try {
+            const result = await client.send('RESUME', { queue: args.queue });
+            return formatSuccess(result);
+        }
+        catch (error) {
+            return formatError(error);
+        }
+    });
+    // is_queue_paused
+    server.tool('is_queue_paused', 'Check whether a specific queue is currently paused.', {
+        queue: z.string().describe('Queue name to check'),
+    }, async (args) => {
+        try {
+            const result = await client.send('ISPAUSED', { queue: args.queue });
+            return formatSuccess(result);
+        }
+        catch (error) {
+            return formatError(error);
+        }
+    });
+    // drain_queue
+    server.tool('drain_queue', 'Remove all waiting jobs from a queue. Active (processing) jobs are not affected. Returns the number of jobs removed.', {
+        queue: z.string().describe('Queue name to drain'),
+    }, async (args) => {
+        try {
+            const result = await client.send('DRAIN', { queue: args.queue });
+            return formatSuccess(result);
+        }
+        catch (error) {
+            return formatError(error);
+        }
+    });
+    // count_jobs
+    server.tool('count_jobs', 'Get the total count of jobs (waiting + delayed) in a queue. Does not include active, completed, or failed jobs.', {
+        queue: z.string().describe('Queue name'),
+    }, async (args) => {
+        try {
+            const result = await client.send('COUNT', { queue: args.queue });
+            return formatSuccess(result);
+        }
+        catch (error) {
+            return formatError(error);
+        }
+    });
+    // set_rate_limit
+    server.tool('set_rate_limit', 'Set a rate limit (jobs per second) for a queue to control processing speed. Useful for external API rate limiting.', {
+        queue: z.string().describe('Queue name'),
+        limit: z.number().positive().describe('Maximum jobs per second'),
+    }, async (args) => {
+        try {
+            const result = await client.send('RATELIMIT', { queue: args.queue, limit: args.limit });
+            return formatSuccess(result);
+        }
+        catch (error) {
+            return formatError(error);
+        }
+    });
+    // clear_rate_limit
+    server.tool('clear_rate_limit', 'Remove the rate limit from a queue, allowing unlimited processing speed.', {
+        queue: z.string().describe('Queue name'),
+    }, async (args) => {
+        try {
+            const result = await client.send('RATELIMITCLEAR', { queue: args.queue });
+            return formatSuccess(result);
+        }
+        catch (error) {
+            return formatError(error);
+        }
+    });
+}
+//# sourceMappingURL=queues.js.map

package/dist/tools/queues.js.map

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

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "flashq-mcp",
+  "version": "0.1.0",
+  "description": "MCP (Model Context Protocol) server for flashQ job queue - enables AI assistants like Claude to manage job queues",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "flashq-mcp": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts",
+    "test": "vitest",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src/",
+    "lint:fix": "eslint src/ --fix",
+    "format": "prettier --write src/",
+    "format:check": "prettier --check src/",
+    "prepublishOnly": "npm run lint && npm run typecheck && npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.0.0",
+    "@types/node": "^22.0.0",
+    "eslint": "^9.0.0",
+    "prettier": "^3.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.0.0",
+    "typescript-eslint": "^8.0.0",
+    "vitest": "^2.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "flashq",
+    "mcp",
+    "model-context-protocol",
+    "job-queue",
+    "claude",
+    "ai",
+    "anthropic",
+    "queue",
+    "worker"
+  ],
+  "author": "flashQ Team",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/flashq/flashq.git",
+    "directory": "mcp"
+  },
+  "homepage": "https://github.com/flashq/flashq/tree/main/mcp#readme",
+  "bugs": {
+    "url": "https://github.com/flashq/flashq/issues"
+  }
+}