@crscreditapi/finstack-mcp-server 0.1.0-1b9ede0 → 0.1.0-a04547f

package/dist/api/customer.api.d.ts

@@ -55,3 +55,22 @@ export interface CustomerSearchResult {
     message?: string;
 }
 export declare function searchCustomers(client: ApiClient, query: string, threshold?: number): Promise<CustomerSearchResult>;
+export type RevenuePeriodType = 'day' | 'week' | 'month' | 'quarter' | 'year';
+export interface RevenuePeriod {
+    period: string;
+    revenue: number;
+}
+export interface CustomerRevenue {
+    customer_code: string;
+    type: RevenuePeriodType;
+    start_date: string;
+    end_date: string;
+    periods: RevenuePeriod[];
+    total: number;
+}
+export declare function getCustomerRevenue(client: ApiClient, args: {
+    customerCode: string;
+    type: RevenuePeriodType;
+    startDate: string;
+    endDate: string;
+}): Promise<CustomerRevenue>;

package/dist/api/customer.api.js

@@ -29,3 +29,20 @@ export async function searchCustomers(client, query, threshold) {
         message: response.message,
     };
 }
+export async function getCustomerRevenue(client, args) {
+    const secret = process.env.FINSTACK_CHATBASE_SECRET;
+    if (!secret) {
+        throw new Error('FINSTACK_CHATBASE_SECRET must be set');
+    }
+    const params = new URLSearchParams({
+        customer_code: args.customerCode,
+        type: args.type,
+        start_date: args.startDate,
+        end_date: args.endDate,
+    });
+    const response = await client.get(`/api/v1/chatbase/customer_revenue?${params}`, { 'X-Chatbase-Secret': secret });
+    if (response.status !== 'success' || !response.data) {
+        throw new Error(response.message || 'Failed to fetch customer revenue');
+    }
+    return response.data;
+}

package/dist/handlers/customer.handler.d.ts

@@ -1,3 +1,4 @@
+import { type RevenuePeriodType } from '../api/customer.api.js';
 interface GetCustomerSummaryArgs {
     customer_code: string;
     environment?: string;
@@ -9,4 +10,12 @@ interface SearchCustomerArgs {
     environment?: string;
 }
 export declare function handleSearchCustomer(args: SearchCustomerArgs): Promise<unknown>;
+interface GetCustomerRevenueArgs {
+    customer_code: string;
+    type: RevenuePeriodType;
+    start_date: string;
+    end_date: string;
+    environment?: string;
+}
+export declare function handleGetCustomerRevenue(args: GetCustomerRevenueArgs): Promise<unknown>;
 export {};

package/dist/handlers/customer.handler.js

@@ -2,7 +2,7 @@
  * Customer tool handlers
  */
 import { getClient } from '../api/client.js';
-import { getCustomerSummary, searchCustomers } from '../api/customer.api.js';
+import { getCustomerRevenue, getCustomerSummary, searchCustomers, } from '../api/customer.api.js';
 export async function handleGetCustomerSummary(args) {
     const client = getClient(args.environment ?? 'prod');
     return getCustomerSummary(client, args.customer_code);
@@ -11,3 +11,12 @@ export async function handleSearchCustomer(args) {
     const client = getClient(args.environment ?? 'prod');
     return searchCustomers(client, args.q, args.threshold);
 }
+export async function handleGetCustomerRevenue(args) {
+    const client = getClient(args.environment ?? 'prod');
+    return getCustomerRevenue(client, {
+        customerCode: args.customer_code,
+        type: args.type,
+        startDate: args.start_date,
+        endDate: args.end_date,
+    });
+}

package/dist/handlers/index.js

@@ -1,8 +1,9 @@
-import { handleGetCustomerSummary, handleSearchCustomer, } from './customer.handler.js';
+import { handleGetCustomerRevenue, handleGetCustomerSummary, handleSearchCustomer, } from './customer.handler.js';
 const wrap = (fn) => {
     return async (args) => fn(args);
 };
 export const handlers = {
     finstack_get_customer_summary: wrap(handleGetCustomerSummary),
     finstack_search_customer: wrap(handleSearchCustomer),
+    finstack_get_customer_revenue: wrap(handleGetCustomerRevenue),
 };

package/dist/tools/customer.tools.js

@@ -44,4 +44,36 @@ export const customerTools = [
             required: ['q'],
         },
     },
+    {
+        name: 'finstack_get_customer_revenue',
+        description: 'Fetch revenue for a B2B customer over a date range, bucketed by period (day/week/month/quarter/year). Use when the user asks how much a customer paid, revenue trends, MRR/ARR-style figures, or billing over time. Returns periods[{period,revenue}] plus a total. Max range: day=92d, week=2y, month/quarter=10y, year=50y; pick the coarsest type that covers the range.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                customer_code: {
+                    type: 'string',
+                    description: 'Customer code (CID) — e.g. "CID18068"',
+                },
+                type: {
+                    type: 'string',
+                    enum: ['day', 'week', 'month', 'quarter', 'year'],
+                    description: 'Bucketing granularity for the returned periods',
+                },
+                start_date: {
+                    type: 'string',
+                    description: 'Start date (inclusive), format YYYY-MM-DD',
+                },
+                end_date: {
+                    type: 'string',
+                    description: 'End date (inclusive), format YYYY-MM-DD. Must be >= start_date.',
+                },
+                environment: {
+                    type: 'string',
+                    description: 'Target environment: "prod" (default) or "dev"',
+                    enum: ['dev', 'prod'],
+                },
+            },
+            required: ['customer_code', 'type', 'start_date', 'end_date'],
+        },
+    },
 ];

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@crscreditapi/finstack-mcp-server",
-	"version": "0.1.0-1b9ede0",
+	"version": "0.1.0-a04547f",
 	"description": "MCP server for Finstack",
 	"type": "module",
 	"main": "dist/index.js",