storno-cli 1.0.5

package/dist/tools/webhooks.js

@@ -0,0 +1,305 @@
+import { z } from 'zod';
+import { apiRequest } from '../client.js';
+import { formatResponse, notAuthenticated, noCompanySelected } from '../utils/errors.js';
+import { getConfig } from '../config.js';
+export const tools = [
+    {
+        name: 'webhooks_list',
+        description: 'List all webhook endpoints configured for the current company. Secrets are masked in the listing. Requires X-Company header (companyId param or STORNO_COMPANY_ID env var).',
+        inputSchema: z.object({
+            companyId: z
+                .string()
+                .optional()
+                .describe('Company UUID (overrides STORNO_COMPANY_ID env var)'),
+        }),
+        handler: async (params) => {
+            if (!getConfig().token)
+                return notAuthenticated();
+            const { companyId } = params;
+            const effectiveCompanyId = companyId || getConfig().companyId;
+            if (!effectiveCompanyId)
+                return noCompanySelected();
+            const res = await apiRequest('/api/v1/webhooks', {
+                companyId: effectiveCompanyId,
+            });
+            return formatResponse(res);
+        },
+    },
+    {
+        name: 'webhooks_get',
+        description: 'Retrieve the full configuration of a single webhook endpoint. The secret is always masked in this response — use webhooks_regenerate_secret to obtain a new full secret.',
+        inputSchema: z.object({
+            uuid: z.string().describe('Webhook endpoint UUID'),
+            companyId: z
+                .string()
+                .optional()
+                .describe('Company UUID (overrides STORNO_COMPANY_ID env var)'),
+        }),
+        handler: async (params) => {
+            if (!getConfig().token)
+                return notAuthenticated();
+            const { uuid, companyId } = params;
+            const effectiveCompanyId = companyId || getConfig().companyId;
+            if (!effectiveCompanyId)
+                return noCompanySelected();
+            const res = await apiRequest(`/api/v1/webhooks/${uuid}`, {
+                companyId: effectiveCompanyId,
+            });
+            return formatResponse(res);
+        },
+    },
+    {
+        name: 'webhooks_create',
+        description: 'Register a new webhook endpoint for the current company. The response includes the full signing secret — store it securely immediately as it will be masked in all subsequent responses. URL must use HTTPS. Use ["*"] for events to subscribe to all event types.',
+        inputSchema: z.object({
+            url: z
+                .string()
+                .url()
+                .describe('HTTPS destination URL that will receive POST requests from Storno'),
+            events: z
+                .array(z.string())
+                .describe('Array of event type names to subscribe to (e.g. ["invoice.created", "invoice.validated"]). Use ["*"] to subscribe to all events.'),
+            description: z
+                .string()
+                .optional()
+                .describe('Human-readable label for this webhook endpoint'),
+            isActive: z
+                .boolean()
+                .optional()
+                .describe('Whether the webhook is active on creation (default: true)'),
+            companyId: z
+                .string()
+                .optional()
+                .describe('Company UUID (overrides STORNO_COMPANY_ID env var)'),
+        }),
+        handler: async (params) => {
+            if (!getConfig().token)
+                return notAuthenticated();
+            const { companyId, url, events, description, isActive } = params;
+            const effectiveCompanyId = companyId || getConfig().companyId;
+            if (!effectiveCompanyId)
+                return noCompanySelected();
+            const body = { url, events };
+            if (description !== undefined)
+                body.description = description;
+            if (isActive !== undefined)
+                body.isActive = isActive;
+            const res = await apiRequest('/api/v1/webhooks', {
+                method: 'POST',
+                body,
+                companyId: effectiveCompanyId,
+            });
+            return formatResponse(res);
+        },
+    },
+    {
+        name: 'webhooks_update',
+        description: 'Partially update an existing webhook endpoint. Only provided fields are changed. Providing events replaces the entire subscription list — send the complete desired set each time. URL must use HTTPS.',
+        inputSchema: z.object({
+            uuid: z.string().describe('Webhook endpoint UUID to update'),
+            url: z.string().url().optional().describe('New HTTPS destination URL'),
+            events: z
+                .array(z.string())
+                .optional()
+                .describe('Replacement list of event type names (replaces entire list, not additive). Use ["*"] for all events.'),
+            description: z
+                .string()
+                .optional()
+                .describe('Updated human-readable label for this webhook endpoint'),
+            isActive: z
+                .boolean()
+                .optional()
+                .describe('Enable (true) or pause (false) deliveries for this webhook'),
+            companyId: z
+                .string()
+                .optional()
+                .describe('Company UUID (overrides STORNO_COMPANY_ID env var)'),
+        }),
+        handler: async (params) => {
+            if (!getConfig().token)
+                return notAuthenticated();
+            const { uuid, companyId, url, events, description, isActive } = params;
+            const effectiveCompanyId = companyId || getConfig().companyId;
+            if (!effectiveCompanyId)
+                return noCompanySelected();
+            const body = {};
+            if (url !== undefined)
+                body.url = url;
+            if (events !== undefined)
+                body.events = events;
+            if (description !== undefined)
+                body.description = description;
+            if (isActive !== undefined)
+                body.isActive = isActive;
+            const res = await apiRequest(`/api/v1/webhooks/${uuid}`, {
+                method: 'PATCH',
+                body,
+                companyId: effectiveCompanyId,
+            });
+            return formatResponse(res);
+        },
+    },
+    {
+        name: 'webhooks_delete',
+        description: 'Permanently delete a webhook endpoint and all its delivery history. This is a hard delete with no recovery. To pause deliveries temporarily, use webhooks_update with isActive: false instead.',
+        inputSchema: z.object({
+            uuid: z.string().describe('Webhook endpoint UUID to permanently delete'),
+            companyId: z
+                .string()
+                .optional()
+                .describe('Company UUID (overrides STORNO_COMPANY_ID env var)'),
+        }),
+        handler: async (params) => {
+            if (!getConfig().token)
+                return notAuthenticated();
+            const { uuid, companyId } = params;
+            const effectiveCompanyId = companyId || getConfig().companyId;
+            if (!effectiveCompanyId)
+                return noCompanySelected();
+            const res = await apiRequest(`/api/v1/webhooks/${uuid}`, {
+                method: 'DELETE',
+                companyId: effectiveCompanyId,
+            });
+            return formatResponse(res);
+        },
+    },
+    {
+        name: 'webhooks_events',
+        description: 'List all available webhook event types that can be subscribed to, including their descriptions and categories (invoices, payments, clients, sync, proforma). Use this to discover valid event names for webhook configuration.',
+        inputSchema: z.object({}),
+        handler: async (_params) => {
+            if (!getConfig().token)
+                return notAuthenticated();
+            const res = await apiRequest('/api/v1/webhooks/events');
+            return formatResponse(res);
+        },
+    },
+    {
+        name: 'webhooks_deliveries',
+        description: 'Retrieve a paginated list of delivery attempts for a webhook endpoint. Can filter by status (success/failed), event type, and date range. Use webhooks_delivery_detail to inspect full request/response payloads.',
+        inputSchema: z.object({
+            uuid: z.string().describe('Webhook endpoint UUID'),
+            page: z
+                .number()
+                .int()
+                .positive()
+                .optional()
+                .describe('Page number for pagination (default: 1)'),
+            limit: z
+                .number()
+                .int()
+                .positive()
+                .max(100)
+                .optional()
+                .describe('Number of items per page (default: 20, max: 100)'),
+            status: z
+                .enum(['success', 'failed'])
+                .optional()
+                .describe('Filter by delivery status: success or failed'),
+            eventType: z
+                .string()
+                .optional()
+                .describe('Filter by event type name (e.g. invoice.validated)'),
+            from: z.string().optional().describe('Start date filter in ISO 8601 format (YYYY-MM-DD)'),
+            to: z.string().optional().describe('End date filter in ISO 8601 format (YYYY-MM-DD)'),
+            companyId: z
+                .string()
+                .optional()
+                .describe('Company UUID (overrides STORNO_COMPANY_ID env var)'),
+        }),
+        handler: async (params) => {
+            if (!getConfig().token)
+                return notAuthenticated();
+            const { uuid, companyId, page, limit, status, eventType, from, to } = params;
+            const effectiveCompanyId = companyId || getConfig().companyId;
+            if (!effectiveCompanyId)
+                return noCompanySelected();
+            const res = await apiRequest(`/api/v1/webhooks/${uuid}/deliveries`, {
+                companyId: effectiveCompanyId,
+                query: { page, limit, status, eventType, from, to },
+            });
+            return formatResponse(res);
+        },
+    },
+    {
+        name: 'webhooks_delivery_detail',
+        description: 'Retrieve the complete details of a single webhook delivery attempt, including the full request payload, request headers (with signature), and the full response received. Use this to debug failed deliveries.',
+        inputSchema: z.object({
+            uuid: z.string().describe('Webhook endpoint UUID'),
+            deliveryUuid: z.string().describe('Delivery attempt UUID'),
+            companyId: z
+                .string()
+                .optional()
+                .describe('Company UUID (overrides STORNO_COMPANY_ID env var)'),
+        }),
+        handler: async (params) => {
+            if (!getConfig().token)
+                return notAuthenticated();
+            const { uuid, deliveryUuid, companyId } = params;
+            const effectiveCompanyId = companyId || getConfig().companyId;
+            if (!effectiveCompanyId)
+                return noCompanySelected();
+            const res = await apiRequest(`/api/v1/webhooks/${uuid}/deliveries/${deliveryUuid}`, {
+                companyId: effectiveCompanyId,
+            });
+            return formatResponse(res);
+        },
+    },
+    {
+        name: 'webhooks_regenerate_secret',
+        description: 'Issue a new HMAC-SHA256 signing secret for a webhook endpoint, immediately invalidating the previous one. The new secret is returned in full only in this response — store it securely. Update your endpoint verification logic before calling this in production.',
+        inputSchema: z.object({
+            uuid: z.string().describe('Webhook endpoint UUID to regenerate the secret for'),
+            companyId: z
+                .string()
+                .optional()
+                .describe('Company UUID (overrides STORNO_COMPANY_ID env var)'),
+        }),
+        handler: async (params) => {
+            if (!getConfig().token)
+                return notAuthenticated();
+            const { uuid, companyId } = params;
+            const effectiveCompanyId = companyId || getConfig().companyId;
+            if (!effectiveCompanyId)
+                return noCompanySelected();
+            const res = await apiRequest(`/api/v1/webhooks/${uuid}/regenerate-secret`, {
+                method: 'POST',
+                companyId: effectiveCompanyId,
+            });
+            return formatResponse(res);
+        },
+    },
+    {
+        name: 'webhooks_test',
+        description: 'Send a synchronous test delivery to a webhook endpoint and return the outcome immediately. Uses a synthetic webhook.test event payload. The webhook must be active. The delivery is recorded in delivery history.',
+        inputSchema: z.object({
+            uuid: z.string().describe('Webhook endpoint UUID to send the test delivery to'),
+            eventType: z
+                .string()
+                .optional()
+                .describe('Override the test event type name (default: webhook.test)'),
+            companyId: z
+                .string()
+                .optional()
+                .describe('Company UUID (overrides STORNO_COMPANY_ID env var)'),
+        }),
+        handler: async (params) => {
+            if (!getConfig().token)
+                return notAuthenticated();
+            const { uuid, companyId, eventType } = params;
+            const effectiveCompanyId = companyId || getConfig().companyId;
+            if (!effectiveCompanyId)
+                return noCompanySelected();
+            const body = {};
+            if (eventType !== undefined)
+                body.eventType = eventType;
+            const res = await apiRequest(`/api/v1/webhooks/${uuid}/test`, {
+                method: 'POST',
+                body: Object.keys(body).length > 0 ? body : undefined,
+                companyId: effectiveCompanyId,
+            });
+            return formatResponse(res);
+        },
+    },
+];
+//# sourceMappingURL=webhooks.js.map

package/dist/tools/webhooks.js.map

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

package/dist/utils/errors.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Error formatting utilities for AI-readable output.
+ */
+import type { ApiError, ApiResponse } from '../client.js';
+/**
+ * Format an API response for the MCP tool result.
+ * Returns a JSON string suitable for AI consumption.
+ */
+export declare function formatResponse(response: ApiResponse | ApiError): string;
+/**
+ * Format a "not configured" error for tools that need auth.
+ */
+export declare function notAuthenticated(): string;
+/**
+ * Format a "no company selected" error.
+ */
+export declare function noCompanySelected(): string;
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE1D;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,WAAW,GAAG,QAAQ,GAAG,MAAM,CAWvE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CASzC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAS1C"}

package/dist/utils/errors.js

@@ -0,0 +1,45 @@
+/**
+ * Error formatting utilities for AI-readable output.
+ */
+/**
+ * Format an API response for the MCP tool result.
+ * Returns a JSON string suitable for AI consumption.
+ */
+export function formatResponse(response) {
+    if (!response.ok) {
+        const err = response;
+        const parts = [`Error ${err.status}: ${err.error}`];
+        if (err.details) {
+            parts.push(JSON.stringify(err.details, null, 2));
+        }
+        return parts.join('\n\n');
+    }
+    return JSON.stringify(response.data, null, 2);
+}
+/**
+ * Format a "not configured" error for tools that need auth.
+ */
+export function notAuthenticated() {
+    return [
+        'Error: Not authenticated.',
+        '',
+        'To authenticate, either:',
+        '1. Set STORNO_TOKEN environment variable in MCP server config',
+        '2. Call the auth_login tool with email and password',
+        '3. Set STORNO_EMAIL and STORNO_PASSWORD env vars for auto-login',
+    ].join('\n');
+}
+/**
+ * Format a "no company selected" error.
+ */
+export function noCompanySelected() {
+    return [
+        'Error: No company selected.',
+        '',
+        'To select a company, either:',
+        '1. Set STORNO_COMPANY_ID environment variable in MCP server config',
+        '2. Call the companies_list tool, then use the company UUID in subsequent calls',
+        '3. Most tools accept an optional companyId parameter to override',
+    ].join('\n');
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgC;IAC7D,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,GAAG,GAAG,QAAoB,CAAC;QACjC,MAAM,KAAK,GAAa,CAAC,SAAS,GAAG,CAAC,MAAM,KAAK,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;QAC9D,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;YAChB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACnD,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;IAED,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO;QACL,2BAA2B;QAC3B,EAAE;QACF,0BAA0B;QAC1B,+DAA+D;QAC/D,qDAAqD;QACrD,iEAAiE;KAClE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO;QACL,6BAA6B;QAC7B,EAAE;QACF,8BAA8B;QAC9B,oEAAoE;QACpE,gFAAgF;QAChF,kEAAkE;KACnE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/utils/pagination.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Pagination helper for list endpoints.
+ */
+export interface PaginationParams {
+    page?: number;
+    limit?: number;
+}
+export declare function paginationQuery(params: PaginationParams): Record<string, string | number | undefined>;
+//# sourceMappingURL=pagination.d.ts.map

package/dist/utils/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../src/utils/pagination.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,CAKrG"}

package/dist/utils/pagination.js

@@ -0,0 +1,10 @@
+/**
+ * Pagination helper for list endpoints.
+ */
+export function paginationQuery(params) {
+    return {
+        page: params.page,
+        limit: params.limit,
+    };
+}
+//# sourceMappingURL=pagination.js.map

package/dist/utils/pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../../src/utils/pagination.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,MAAM,UAAU,eAAe,CAAC,MAAwB;IACtD,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,KAAK,EAAE,MAAM,CAAC,KAAK;KACpB,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "storno-cli",
+  "version": "1.0.5",
+  "description": "MCP server for the Storno.ro e-invoicing API — enables AI tools (Claude, Cursor, Windsurf) to manage invoices, clients, companies, and the full e-Factura workflow",
+  "type": "module",
+  "bin": {
+    "storno-cli": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist",
+    "README.md",
+    "TOOLS.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "storno",
+    "e-invoicing",
+    "e-factura",
+    "anaf",
+    "invoicing",
+    "romania",
+    "ai-tools",
+    "claude",
+    "cursor"
+  ],
+  "author": "Storno.ro",
+  "license": "Elastic-2.0",
+  "homepage": "https://storno.ro",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/stornoro/storno-cli"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "zod": "^3.24.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.4",
+    "typescript": "^5.7.3"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}