@flowsight/mcp-server 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 FlowSight
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,155 @@
+# @flowsight/mcp-server
+
+MCP (Model Context Protocol) server for [FlowSight](https://flowsight.pro) — expose payment observability tools to AI assistants like Claude, GPT, and any MCP-compatible client.
+
+## Quick Start
+
+```bash
+FLOWSIGHT_API_KEY=fs_live_... npx @flowsight/mcp-server
+```
+
+## Tools
+
+The server exposes 4 tools:
+
+| Tool | Description |
+|------|-------------|
+| `flowsight_send_event` | Send a payment event for tracking |
+| `flowsight_query_events` | Query events with filters (processor, status, time range) |
+| `flowsight_get_flow` | Get a complete payment flow by ID |
+| `flowsight_list_processors` | List supported payment processors |
+
+## Setup
+
+### Claude Desktop
+
+Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS, `%APPDATA%\Claude\claude_desktop_config.json` on Windows):
+
+```json
+{
+  "mcpServers": {
+    "flowsight": {
+      "command": "npx",
+      "args": ["@flowsight/mcp-server"],
+      "env": {
+        "FLOWSIGHT_API_KEY": "fs_live_your_api_key_here"
+      }
+    }
+  }
+}
+```
+
+Restart Claude Desktop. You'll see FlowSight tools available in the tools menu.
+
+### OpenClaw / Other MCP Clients
+
+Any MCP client that supports stdio transport can use this server:
+
+```json
+{
+  "command": "npx",
+  "args": ["@flowsight/mcp-server"],
+  "env": {
+    "FLOWSIGHT_API_KEY": "fs_live_..."
+  }
+}
+```
+
+### Custom Base URL
+
+For self-hosted FlowSight or development:
+
+```json
+{
+  "env": {
+    "FLOWSIGHT_API_KEY": "fs_test_...",
+    "FLOWSIGHT_BASE_URL": "http://localhost:8080"
+  }
+}
+```
+
+## Configuration
+
+| Environment Variable | Required | Default | Description |
+|---------------------|----------|---------|-------------|
+| `FLOWSIGHT_API_KEY` | ✅ | — | Your FlowSight API key |
+| `FLOWSIGHT_BASE_URL` | — | `https://ingest.flowsight.pro` | API base URL |
+| `FLOWSIGHT_TIMEOUT_MS` | — | `30000` | Request timeout in ms |
+
+## Tool Details
+
+### flowsight_send_event
+
+Send a payment lifecycle event.
+
+**Parameters:**
+- `event_type` (required) — `payment.started`, `payment.completed`, `payment.failed`, `payment.retried`, `refund.started`, `refund.completed`, `refund.failed`
+- `flow_id` (required) — UUID grouping related events
+- `transaction_id` (required) — Processor transaction ID
+- `processor` (required) — `stripe`, `paypal`, `adyen`, `redsys`
+- `amount` (required) — Amount in smallest currency unit (cents)
+- `currency` (required) — ISO 4217 code (USD, EUR, GBP)
+- `status` — `succeeded`, `failed`, `pending`, `cancelled`
+- `latency_ms` — Processor response time
+- `error_code` — Error code for failed payments
+- `error_message` — Error message for failed payments
+- `context` — Key-value metadata
+
+### flowsight_query_events
+
+Query events with optional filters.
+
+**Parameters:**
+- `processor` — Filter by processor
+- `status` — Filter by status
+- `event_type` — Filter by event type
+- `from` / `to` — ISO 8601 time range
+- `page` / `limit` — Pagination (default: page 1, 20 per page)
+
+### flowsight_get_flow
+
+Get all events in a payment flow.
+
+**Parameters:**
+- `flow_id` (required) — The flow UUID to look up
+
+### flowsight_list_processors
+
+List supported payment processors and their webhook configurations. No parameters.
+
+## Example Conversations
+
+> "Show me all failed payments in the last hour"
+
+The AI will call `flowsight_query_events` with `status: "failed"` and appropriate time range.
+
+> "What happened with flow abc-123?"
+
+The AI will call `flowsight_get_flow` with `flow_id: "abc-123"` and display the payment timeline.
+
+> "Track a $49.99 Stripe payment"
+
+The AI will call `flowsight_send_event` with the payment details.
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Run in development mode
+FLOWSIGHT_API_KEY=fs_test_... npm run dev
+
+# Build
+npm run build
+
+# Run tests
+npm test
+
+# Type check
+npm run typecheck
+```
+
+## License
+
+MIT — [FlowSight](https://flowsight.pro)

package/dist/api-client.d.ts

@@ -0,0 +1,100 @@
+/**
+ * @module api-client
+ * Lightweight HTTP client for the FlowSight API.
+ * Used by MCP tools to call FlowSight endpoints.
+ */
+import type { Config } from './config.js';
+export interface ApiResponse<T = unknown> {
+    ok: boolean;
+    status: number;
+    data: T;
+}
+export interface PaymentEvent {
+    event_id?: string;
+    event_type: string;
+    timestamp?: string;
+    flow_id: string;
+    transaction_id: string;
+    processor: string;
+    amount: number;
+    currency: string;
+    status?: string;
+    latency_ms?: number;
+    payment_method?: Record<string, unknown>;
+    error?: {
+        code: string;
+        category: string;
+        message: string;
+        processor_code?: string;
+        retriable: boolean;
+    };
+    processor_response?: Record<string, unknown>;
+    context?: Record<string, string>;
+}
+export interface EventsQueryParams {
+    page?: number;
+    limit?: number;
+    processor?: string;
+    status?: string;
+    event_type?: string;
+    from?: string;
+    to?: string;
+}
+export interface EventsResponse {
+    events: PaymentEvent[];
+    total: number;
+    page: number;
+    limit: number;
+}
+export interface FlowResponse {
+    flow_id: string;
+    events: PaymentEvent[];
+    summary?: {
+        status: string;
+        total_events: number;
+        first_event: string;
+        last_event: string;
+        amount: number;
+        currency: string;
+        processor: string;
+    };
+}
+export interface IngestResponse {
+    accepted: number;
+    rejected: number;
+    errors: Array<{
+        index: number;
+        event_id: string;
+        code: string;
+        message: string;
+    }>;
+}
+/**
+ * FlowSight API client for the MCP server.
+ */
+export declare class FlowSightApiClient {
+    private readonly baseUrl;
+    private readonly apiKey;
+    private readonly timeoutMs;
+    constructor(config: Config);
+    /**
+     * Send payment events to FlowSight.
+     */
+    sendEvents(events: PaymentEvent[]): Promise<ApiResponse<IngestResponse>>;
+    /**
+     * Query events with filters.
+     */
+    queryEvents(params: EventsQueryParams): Promise<ApiResponse<EventsResponse>>;
+    /**
+     * Get a payment flow by ID.
+     */
+    getFlow(flowId: string): Promise<ApiResponse<FlowResponse>>;
+    /**
+     * List configured processors.
+     */
+    listProcessors(): Promise<ApiResponse<{
+        processors: string[];
+    }>>;
+    private request;
+}
+//# 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":"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"}

package/dist/api-client.js

@@ -0,0 +1,98 @@
+/**
+ * @module api-client
+ * Lightweight HTTP client for the FlowSight API.
+ * Used by MCP tools to call FlowSight endpoints.
+ */
+/**
+ * FlowSight API client for the MCP server.
+ */
+export class FlowSightApiClient {
+    baseUrl;
+    apiKey;
+    timeoutMs;
+    constructor(config) {
+        this.baseUrl = config.baseUrl.replace(/\/$/, '');
+        this.apiKey = config.apiKey;
+        this.timeoutMs = config.timeoutMs;
+    }
+    /**
+     * Send payment events to FlowSight.
+     */
+    async sendEvents(events) {
+        return this.request('POST', '/v1/events', { events });
+    }
+    /**
+     * Query events with filters.
+     */
+    async queryEvents(params) {
+        const qs = new URLSearchParams();
+        if (params.page)
+            qs.set('page', String(params.page));
+        if (params.limit)
+            qs.set('limit', String(params.limit));
+        if (params.processor)
+            qs.set('processor', params.processor);
+        if (params.status)
+            qs.set('status', params.status);
+        if (params.event_type)
+            qs.set('event_type', params.event_type);
+        if (params.from)
+            qs.set('from', params.from);
+        if (params.to)
+            qs.set('to', params.to);
+        const query = qs.toString();
+        return this.request('GET', `/v1/events${query ? '?' + query : ''}`);
+    }
+    /**
+     * Get a payment flow by ID.
+     */
+    async getFlow(flowId) {
+        return this.request('GET', `/v1/flows/${encodeURIComponent(flowId)}`);
+    }
+    /**
+     * List configured processors.
+     */
+    async listProcessors() {
+        // The processors list comes from the API's supported processors.
+        // If no dedicated endpoint exists, return the known set.
+        return {
+            ok: true,
+            status: 200,
+            data: {
+                processors: ['stripe', 'paypal', 'adyen', 'redsys'],
+            },
+        };
+    }
+    async request(method, path, body) {
+        const url = `${this.baseUrl}${path}`;
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), this.timeoutMs);
+        try {
+            const headers = {
+                'Authorization': `Bearer ${this.apiKey}`,
+                'X-FlowSight-SDK': 'flowsight-mcp/1.0.0',
+                'Accept': 'application/json',
+            };
+            const init = {
+                method,
+                headers,
+                signal: controller.signal,
+            };
+            if (body) {
+                headers['Content-Type'] = 'application/json';
+                init.body = JSON.stringify(body);
+            }
+            const res = await fetch(url, init);
+            const data = await res.json();
+            return { ok: res.ok, status: res.status, data };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : 'Unknown error';
+            throw new Error(`FlowSight API request failed: ${method} ${path} — ${message}`);
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+}
+//# 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/config.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @module config
+ * Configuration for the FlowSight MCP server.
+ * All config comes from environment variables.
+ */
+export interface Config {
+    /** FlowSight API key (fs_live_... or fs_test_...) */
+    apiKey: string;
+    /** FlowSight API base URL */
+    baseUrl: string;
+    /** Request timeout in milliseconds */
+    timeoutMs: number;
+}
+/**
+ * Load configuration from environment variables.
+ * @throws If FLOWSIGHT_API_KEY is not set.
+ */
+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;;;;GAIG;AAEH,MAAM,WAAW,MAAM;IACrB,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;CACnB;AAKD;;;GAGG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAcnC"}

package/dist/config.js

@@ -0,0 +1,24 @@
+/**
+ * @module config
+ * Configuration for the FlowSight MCP server.
+ * All config comes from environment variables.
+ */
+const DEFAULT_BASE_URL = 'https://ingest.flowsight.pro';
+const DEFAULT_TIMEOUT_MS = 30_000;
+/**
+ * Load configuration from environment variables.
+ * @throws If FLOWSIGHT_API_KEY is not set.
+ */
+export function loadConfig() {
+    const apiKey = process.env.FLOWSIGHT_API_KEY;
+    if (!apiKey) {
+        throw new Error('FLOWSIGHT_API_KEY environment variable is required.\n' +
+            'Get your API key at https://app.flowsight.pro/settings');
+    }
+    return {
+        apiKey,
+        baseUrl: process.env.FLOWSIGHT_BASE_URL ?? DEFAULT_BASE_URL,
+        timeoutMs: parseInt(process.env.FLOWSIGHT_TIMEOUT_MS ?? '', 10) || DEFAULT_TIMEOUT_MS,
+    };
+}
+//# 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;;;;GAIG;AAWH,MAAM,gBAAgB,GAAG,8BAA8B,CAAC;AACxD,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAElC;;;GAGG;AACH,MAAM,UAAU,UAAU;IACxB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IAC7C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,uDAAuD;YACvD,wDAAwD,CACzD,CAAC;IACJ,CAAC;IAED,OAAO;QACL,MAAM;QACN,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,gBAAgB;QAC3D,SAAS,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,kBAAkB;KACtF,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+/**
+ * @module index
+ * FlowSight MCP Server entry point.
+ *
+ * Usage:
+ *   FLOWSIGHT_API_KEY=fs_live_... npx @flowsight/mcp-server
+ *
+ * Or in Claude Desktop config:
+ *   {
+ *     "mcpServers": {
+ *       "flowsight": {
+ *         "command": "npx",
+ *         "args": ["@flowsight/mcp-server"],
+ *         "env": { "FLOWSIGHT_API_KEY": "fs_live_..." }
+ *       }
+ *     }
+ *   }
+ */
+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;;;;;;;;;;;;;;;;;GAiBG"}

package/dist/index.js

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+/**
+ * @module index
+ * FlowSight MCP Server entry point.
+ *
+ * Usage:
+ *   FLOWSIGHT_API_KEY=fs_live_... npx @flowsight/mcp-server
+ *
+ * Or in Claude Desktop config:
+ *   {
+ *     "mcpServers": {
+ *       "flowsight": {
+ *         "command": "npx",
+ *         "args": ["@flowsight/mcp-server"],
+ *         "env": { "FLOWSIGHT_API_KEY": "fs_live_..." }
+ *       }
+ *     }
+ *   }
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { loadConfig } from './config.js';
+import { FlowSightApiClient } from './api-client.js';
+import { registerTools } from './tools.js';
+async function main() {
+    // Load configuration from environment
+    const config = loadConfig();
+    // Create API client
+    const apiClient = new FlowSightApiClient(config);
+    // Create MCP server
+    const server = new McpServer({
+        name: 'flowsight',
+        version: '1.0.0',
+    });
+    // Register all tools
+    registerTools(server, apiClient);
+    // Connect via stdio transport (for Claude Desktop / MCP clients)
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Log to stderr (stdout is reserved for MCP protocol)
+    console.error('FlowSight MCP server started');
+    console.error(`  API: ${config.baseUrl}`);
+    console.error(`  Key: ${config.apiKey.slice(0, 12)}...`);
+}
+main().catch((err) => {
+    console.error('Fatal:', err instanceof Error ? err.message : err);
+    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;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,KAAK,UAAU,IAAI;IACjB,sCAAsC;IACtC,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAE5B,oBAAoB;IACpB,MAAM,SAAS,GAAG,IAAI,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAEjD,oBAAoB;IACpB,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,qBAAqB;IACrB,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAEjC,iEAAiE;IACjE,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,sDAAsD;IACtD,OAAO,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAC9C,OAAO,CAAC,KAAK,CAAC,UAAU,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IAC1C,OAAO,CAAC,KAAK,CAAC,UAAU,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC;AAC3D,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAClE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/tools.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @module tools
+ * MCP tool definitions for FlowSight.
+ * Each tool wraps a FlowSight API operation.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { FlowSightApiClient } from './api-client.js';
+/**
+ * Register all FlowSight tools on the MCP server.
+ */
+export declare function registerTools(server: McpServer, client: FlowSightApiClient): void;
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,kBAAkB,GAAG,IAAI,CAKjF"}

package/dist/tools.js

@@ -0,0 +1,231 @@
+/**
+ * @module tools
+ * MCP tool definitions for FlowSight.
+ * Each tool wraps a FlowSight API operation.
+ */
+import { z } from 'zod';
+/**
+ * Register all FlowSight tools on the MCP server.
+ */
+export function registerTools(server, client) {
+    registerSendEvent(server, client);
+    registerQueryEvents(server, client);
+    registerGetFlow(server, client);
+    registerListProcessors(server, client);
+}
+// ---------------------------------------------------------------------------
+// flowsight_send_event
+// ---------------------------------------------------------------------------
+function registerSendEvent(server, client) {
+    server.registerTool('flowsight_send_event', {
+        title: 'Send Payment Event',
+        description: 'Send a payment event to FlowSight for tracking and analysis. ' +
+            'Use this to report payment lifecycle events (started, completed, failed, retried, refunds).',
+        inputSchema: z.object({
+            event_type: z.enum([
+                'payment.started',
+                'payment.completed',
+                'payment.failed',
+                'payment.retried',
+                'refund.started',
+                'refund.completed',
+                'refund.failed',
+            ]).describe('Payment lifecycle event type'),
+            flow_id: z.string().describe('UUID grouping related events into a payment flow'),
+            transaction_id: z.string().describe('Processor transaction/payment-intent ID'),
+            processor: z.enum(['stripe', 'paypal', 'adyen', 'redsys']).describe('Payment processor'),
+            amount: z.number().int().min(0).describe('Amount in smallest currency unit (e.g. cents)'),
+            currency: z.string().length(3).describe('ISO 4217 currency code (e.g. USD, EUR)'),
+            status: z.enum(['succeeded', 'failed', 'pending', 'cancelled']).optional().describe('Payment status'),
+            latency_ms: z.number().int().min(0).optional().describe('Processor response time in ms'),
+            error_code: z.string().optional().describe('Error code for failed payments'),
+            error_message: z.string().optional().describe('Error message for failed payments'),
+            context: z.record(z.string()).optional().describe('Arbitrary key-value metadata'),
+        }),
+    }, async (params) => {
+        const event = {
+            event_type: params.event_type,
+            flow_id: params.flow_id,
+            transaction_id: params.transaction_id,
+            processor: params.processor,
+            amount: params.amount,
+            currency: params.currency.toUpperCase(),
+            status: params.status,
+            latency_ms: params.latency_ms,
+            context: params.context,
+        };
+        if (params.error_code || params.error_message) {
+            event.error = {
+                code: params.error_code ?? 'unknown',
+                category: 'unknown',
+                message: params.error_message ?? 'Unknown error',
+                retriable: false,
+            };
+        }
+        try {
+            const res = await client.sendEvents([event]);
+            if (!res.ok) {
+                return {
+                    content: [{ type: 'text', text: `Error sending event: HTTP ${res.status} — ${JSON.stringify(res.data)}` }],
+                    isError: true,
+                };
+            }
+            return {
+                content: [{
+                        type: 'text',
+                        text: `✓ Event sent successfully.\nAccepted: ${res.data.accepted}, Rejected: ${res.data.rejected}` +
+                            (res.data.errors?.length ? `\nErrors: ${JSON.stringify(res.data.errors)}` : ''),
+                    }],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: 'text', text: `Failed to send event: ${err instanceof Error ? err.message : 'Unknown error'}` }],
+                isError: true,
+            };
+        }
+    });
+}
+// ---------------------------------------------------------------------------
+// flowsight_query_events
+// ---------------------------------------------------------------------------
+function registerQueryEvents(server, client) {
+    server.registerTool('flowsight_query_events', {
+        title: 'Query Payment Events',
+        description: 'Query payment events from FlowSight with optional filters. ' +
+            'Returns paginated results with event details.',
+        inputSchema: z.object({
+            processor: z.enum(['stripe', 'paypal', 'adyen', 'redsys']).optional().describe('Filter by processor'),
+            status: z.enum(['succeeded', 'failed', 'pending', 'cancelled']).optional().describe('Filter by status'),
+            event_type: z.enum([
+                'payment.started', 'payment.completed', 'payment.failed', 'payment.retried',
+                'refund.started', 'refund.completed', 'refund.failed',
+            ]).optional().describe('Filter by event type'),
+            from: z.string().optional().describe('Start time (ISO 8601)'),
+            to: z.string().optional().describe('End time (ISO 8601)'),
+            page: z.number().int().min(1).optional().describe('Page number (default 1)'),
+            limit: z.number().int().min(1).max(100).optional().describe('Results per page (default 20, max 100)'),
+        }),
+    }, async (params) => {
+        try {
+            const res = await client.queryEvents({
+                processor: params.processor,
+                status: params.status,
+                event_type: params.event_type,
+                from: params.from,
+                to: params.to,
+                page: params.page,
+                limit: params.limit,
+            });
+            if (!res.ok) {
+                return {
+                    content: [{ type: 'text', text: `Error querying events: HTTP ${res.status} — ${JSON.stringify(res.data)}` }],
+                    isError: true,
+                };
+            }
+            const { events, total, page, limit } = res.data;
+            const lines = [
+                `Found ${total} events (page ${page}, ${limit} per page)`,
+                '',
+            ];
+            for (const ev of events) {
+                lines.push(`• ${ev.event_type} | ${ev.processor} | ${ev.status ?? 'unknown'} | ` +
+                    `${ev.amount} ${ev.currency} | ${ev.transaction_id} | ${ev.timestamp ?? ''}`);
+                if (ev.error) {
+                    lines.push(`  ⚠ Error: ${ev.error.code} — ${ev.error.message}`);
+                }
+            }
+            return { content: [{ type: 'text', text: lines.join('\n') }] };
+        }
+        catch (err) {
+            return {
+                content: [{ type: 'text', text: `Failed to query events: ${err instanceof Error ? err.message : 'Unknown error'}` }],
+                isError: true,
+            };
+        }
+    });
+}
+// ---------------------------------------------------------------------------
+// flowsight_get_flow
+// ---------------------------------------------------------------------------
+function registerGetFlow(server, client) {
+    server.registerTool('flowsight_get_flow', {
+        title: 'Get Payment Flow',
+        description: 'Retrieve a complete payment flow by its flow ID. ' +
+            'Shows all events in the payment lifecycle (started → completed/failed → refunded).',
+        inputSchema: z.object({
+            flow_id: z.string().describe('The flow ID (UUID) to look up'),
+        }),
+    }, async (params) => {
+        try {
+            const res = await client.getFlow(params.flow_id);
+            if (!res.ok) {
+                return {
+                    content: [{ type: 'text', text: `Error fetching flow: HTTP ${res.status} — ${JSON.stringify(res.data)}` }],
+                    isError: true,
+                };
+            }
+            const { flow_id, events, summary } = res.data;
+            const lines = [`Payment Flow: ${flow_id}`, ''];
+            if (summary) {
+                lines.push(`Status: ${summary.status}`, `Processor: ${summary.processor}`, `Amount: ${summary.amount} ${summary.currency}`, `Events: ${summary.total_events}`, `First: ${summary.first_event}`, `Last: ${summary.last_event}`, '');
+            }
+            lines.push('Timeline:');
+            for (const ev of events) {
+                lines.push(`  ${ev.timestamp ?? '?'} | ${ev.event_type} | ${ev.status ?? ''}` +
+                    (ev.latency_ms ? ` | ${ev.latency_ms}ms` : ''));
+                if (ev.error) {
+                    lines.push(`    ⚠ ${ev.error.code}: ${ev.error.message}`);
+                }
+            }
+            return { content: [{ type: 'text', text: lines.join('\n') }] };
+        }
+        catch (err) {
+            return {
+                content: [{ type: 'text', text: `Failed to get flow: ${err instanceof Error ? err.message : 'Unknown error'}` }],
+                isError: true,
+            };
+        }
+    });
+}
+// ---------------------------------------------------------------------------
+// flowsight_list_processors
+// ---------------------------------------------------------------------------
+function registerListProcessors(server, client) {
+    server.registerTool('flowsight_list_processors', {
+        title: 'List Payment Processors',
+        description: 'List all payment processors supported by FlowSight. ' +
+            'Shows which processors can be used with webhook adapters and SDK events.',
+        inputSchema: z.object({}),
+    }, async () => {
+        try {
+            const res = await client.listProcessors();
+            const processors = res.data.processors;
+            const lines = [
+                `FlowSight supports ${processors.length} payment processors:`,
+                '',
+                ...processors.map((p) => {
+                    const info = processorInfo[p] ?? { name: p, webhook: 'Unknown' };
+                    return `• ${info.name} (${p}) — Webhook: ${info.webhook}`;
+                }),
+                '',
+                'To set up webhooks, configure each processor to POST to:',
+                '  POST /v1/webhooks/{processor}/{tenant-slug}',
+            ];
+            return { content: [{ type: 'text', text: lines.join('\n') }] };
+        }
+        catch (err) {
+            return {
+                content: [{ type: 'text', text: `Failed to list processors: ${err instanceof Error ? err.message : 'Unknown error'}` }],
+                isError: true,
+            };
+        }
+    });
+}
+const processorInfo = {
+    stripe: { name: 'Stripe', webhook: 'Stripe-Signature header (HMAC-SHA256)' },
+    paypal: { name: 'PayPal', webhook: 'PAYPAL-TRANSMISSION-SIG header (HMAC-SHA256)' },
+    adyen: { name: 'Adyen', webhook: 'HMAC in additionalData.hmacSignature (HMAC-SHA256)' },
+    redsys: { name: 'Redsys', webhook: '3DES-CBC + HMAC-SHA256 on Ds_MerchantParameters' },
+};
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@flowsight/mcp-server",
+  "version": "1.0.0",
+  "description": "FlowSight MCP server — expose payment observability tools to AI assistants",
+  "license": "MIT",
+  "author": "FlowSight <sdk@flowsight.pro>",
+  "homepage": "https://flowsight.pro",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/flowsight/mcp-server.git"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "payments",
+    "observability",
+    "flowsight",
+    "ai",
+    "claude"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "flowsight-mcp": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0",
+    "vitest": "^1.6.0"
+  }
+}