@goodsamsoftware/freshbooks-mcp 1.0.0

package/dist/tools/service/service-list.js

@@ -0,0 +1,99 @@
+/**
+ * Service List Tool
+ *
+ * List billable services with pagination.
+ */
+import { z } from "zod";
+import { ErrorHandler } from "../../errors/error-handler.js";
+/**
+ * Input schema for service_list
+ */
+const ServiceListInputSchema = z.object({
+    businessId: z.number().int().positive().describe("FreshBooks business ID"),
+    page: z.number().int().positive().optional().describe("Page number (default: 1)"),
+    perPage: z
+        .number()
+        .int()
+        .positive()
+        .max(100)
+        .optional()
+        .describe("Results per page (default: 30, max: 100)"),
+});
+/**
+ * Output schema for service_list
+ */
+const ServiceListOutputSchema = z.object({
+    services: z.array(z.unknown()),
+    pagination: z.object({
+        page: z.number(),
+        pages: z.number(),
+        perPage: z.number(),
+        total: z.number(),
+    }),
+});
+/**
+ * Tool definition for service_list
+ */
+export const serviceListTool = {
+    name: "service_list",
+    description: `List billable services from FreshBooks.
+
+WHEN TO USE:
+- User wants to see available service types
+- Need to find a service ID for time entry
+- Browse billable service options
+
+REQUIRED INFO:
+- Business ID (FreshBooks business/account identifier)
+
+OPTIONAL PARAMETERS:
+- page: Page number for pagination (default: 1)
+- perPage: Results per page (default: 30, max: 100)
+
+RETURNS:
+Array of services with:
+- Service ID, name, billable status
+- Pagination metadata for large result sets
+
+EXAMPLE PROMPTS:
+- "Show me all my services"
+- "List billable service types"
+- "What services can I assign to time entries?"
+
+NOTE: Services are immutable once created. Archived services have visState=1 or 2.`,
+    inputSchema: ServiceListInputSchema,
+    outputSchema: ServiceListOutputSchema,
+    async execute(input, client) {
+        const handler = ErrorHandler.wrapHandler('service_list', async (input, _context) => {
+            const { businessId } = input;
+            const result = await client.executeWithRetry('service_list', async (fbClient) => {
+                // Note: services.list() only accepts businessId, no query builders
+                // Pagination parameters are ignored as the SDK doesn't support them for services
+                const response = await fbClient.services.list(businessId);
+                if (!response.ok) {
+                    throw response.error;
+                }
+                return response.data;
+            });
+            // Extract data
+            const services = result.services || [];
+            const paginationData = result.pages || {
+                page: 1,
+                pages: 1,
+                total: services.length,
+                per_page: 30,
+            };
+            return {
+                services,
+                pagination: {
+                    page: paginationData.page,
+                    pages: paginationData.pages,
+                    perPage: paginationData.per_page || paginationData.perPage || 30,
+                    total: paginationData.total,
+                },
+            };
+        });
+        return handler(input, { businessId: input.businessId });
+    },
+};
+//# sourceMappingURL=service-list.js.map

package/dist/tools/service/service-list.js.map

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

package/dist/tools/service/service-rate-get.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Service Rate Get Tool
+ *
+ * Retrieve the billing rate for a service.
+ */
+import { z } from "zod";
+import { FreshBooksClientWrapper } from "../../client/index.js";
+/**
+ * Input schema for service_rate_get
+ */
+declare const ServiceRateGetInputSchema: z.ZodObject<{
+    businessId: z.ZodNumber;
+    serviceId: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    businessId: number;
+    serviceId: number;
+}, {
+    businessId: number;
+    serviceId: number;
+}>;
+/**
+ * Output schema for service_rate_get
+ */
+declare const ServiceRateGetOutputSchema: z.ZodObject<{
+    rate: z.ZodString;
+    code: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    code: string;
+    rate: string;
+}, {
+    code: string;
+    rate: string;
+}>;
+/**
+ * Tool definition for service_rate_get
+ */
+export declare const serviceRateGetTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        businessId: z.ZodNumber;
+        serviceId: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        businessId: number;
+        serviceId: number;
+    }, {
+        businessId: number;
+        serviceId: number;
+    }>;
+    outputSchema: z.ZodObject<{
+        rate: z.ZodString;
+        code: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        code: string;
+        rate: string;
+    }, {
+        code: string;
+        rate: string;
+    }>;
+    execute(input: z.infer<typeof ServiceRateGetInputSchema>, client: FreshBooksClientWrapper): Promise<z.infer<typeof ServiceRateGetOutputSchema>>;
+};
+export {};
+//# sourceMappingURL=service-rate-get.d.ts.map

package/dist/tools/service/service-rate-get.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-rate-get.d.ts","sourceRoot":"","sources":["../../../src/tools/service/service-rate-get.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAEhE;;GAEG;AACH,QAAA,MAAM,yBAAyB;;;;;;;;;EAG7B,CAAC;AAEH;;GAEG;AACH,QAAA,MAAM,0BAA0B;;;;;;;;;EAG9B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;mBA6BpB,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,UACxC,uBAAuB,GAC9B,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;CAsBvD,CAAC"}

package/dist/tools/service/service-rate-get.js

@@ -0,0 +1,66 @@
+/**
+ * Service Rate Get Tool
+ *
+ * Retrieve the billing rate for a service.
+ */
+import { z } from "zod";
+import { ErrorHandler } from "../../errors/error-handler.js";
+/**
+ * Input schema for service_rate_get
+ */
+const ServiceRateGetInputSchema = z.object({
+    businessId: z.number().int().positive().describe("FreshBooks business ID"),
+    serviceId: z.number().int().positive().describe("Service ID"),
+});
+/**
+ * Output schema for service_rate_get
+ */
+const ServiceRateGetOutputSchema = z.object({
+    rate: z.string().describe("Rate amount as decimal string"),
+    code: z.string().describe("Currency code (e.g., USD)"),
+});
+/**
+ * Tool definition for service_rate_get
+ */
+export const serviceRateGetTool = {
+    name: "service_rate_get",
+    description: `Get the billing rate for a service in FreshBooks.
+
+WHEN TO USE:
+- Need to know the rate for a service
+- Verify pricing before time entry
+- Check current billing rates
+
+REQUIRED INFO:
+- Business ID
+- Service ID
+
+RETURNS:
+Service rate details:
+- rate: Amount as decimal string (e.g., "75.00")
+- code: Currency code (e.g., "USD")
+
+EXAMPLE PROMPTS:
+- "What is the rate for service 123?"
+- "Get the billing rate for Development service"
+- "How much do we charge for service ID 456?"
+
+NOTE: Rates can be different per service. Use service_rate_set to configure pricing.`,
+    inputSchema: ServiceRateGetInputSchema,
+    outputSchema: ServiceRateGetOutputSchema,
+    async execute(input, client) {
+        const handler = ErrorHandler.wrapHandler('service_rate_get', async (input, _context) => {
+            const { businessId, serviceId } = input;
+            const result = await client.executeWithRetry('service_rate_get', async (fbClient) => {
+                const response = await fbClient.services.rate.single(businessId, serviceId);
+                if (!response.ok) {
+                    throw response.error;
+                }
+                return response.data;
+            });
+            return result;
+        });
+        return handler(input, { businessId: input.businessId });
+    },
+};
+//# sourceMappingURL=service-rate-get.js.map

package/dist/tools/service/service-rate-get.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-rate-get.js","sourceRoot":"","sources":["../../../src/tools/service/service-rate-get.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAI7D;;GAEG;AACH,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;IAC1E,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;CAC9D,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IAC1D,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;CACvD,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,IAAI,EAAE,kBAAkB;IACxB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;qFAqBsE;IAEnF,WAAW,EAAE,yBAAyB;IACtC,YAAY,EAAE,0BAA0B;IAExC,KAAK,CAAC,OAAO,CACX,KAAgD,EAChD,MAA+B;QAE/B,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,CACtC,kBAAkB,EAClB,KAAK,EAAE,KAAgD,EAAE,QAAqB,EAAE,EAAE;YAChF,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC;YAExC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;gBAClF,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;gBAE5E,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;oBACjB,MAAM,QAAQ,CAAC,KAAK,CAAC;gBACvB,CAAC;gBAED,OAAO,QAAQ,CAAC,IAAI,CAAC;YACvB,CAAC,CAAC,CAAC;YAEH,OAAO,MAAoD,CAAC;QAC9D,CAAC,CACF,CAAC;QAEF,OAAO,OAAO,CAAC,KAAK,EAAE,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;IAC1D,CAAC;CACF,CAAC"}

package/dist/tools/service/service-rate-set.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Service Rate Set Tool
+ *
+ * Set or update the billing rate for a service.
+ * This is the ONLY mutable aspect of services.
+ */
+import { z } from "zod";
+import { FreshBooksClientWrapper } from "../../client/index.js";
+/**
+ * Input schema for service_rate_set
+ */
+declare const ServiceRateSetInputSchema: z.ZodObject<{
+    businessId: z.ZodNumber;
+    serviceId: z.ZodNumber;
+    rate: z.ZodString;
+    code: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    code: string;
+    businessId: number;
+    serviceId: number;
+    rate: string;
+}, {
+    businessId: number;
+    serviceId: number;
+    rate: string;
+    code?: string | undefined;
+}>;
+/**
+ * Output schema for service_rate_set
+ */
+declare const ServiceRateSetOutputSchema: z.ZodObject<{
+    rate: z.ZodString;
+    code: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    code: string;
+    rate: string;
+}, {
+    code: string;
+    rate: string;
+}>;
+/**
+ * Tool definition for service_rate_set
+ */
+export declare const serviceRateSetTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        businessId: z.ZodNumber;
+        serviceId: z.ZodNumber;
+        rate: z.ZodString;
+        code: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        code: string;
+        businessId: number;
+        serviceId: number;
+        rate: string;
+    }, {
+        businessId: number;
+        serviceId: number;
+        rate: string;
+        code?: string | undefined;
+    }>;
+    outputSchema: z.ZodObject<{
+        rate: z.ZodString;
+        code: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        code: string;
+        rate: string;
+    }, {
+        code: string;
+        rate: string;
+    }>;
+    execute(input: z.infer<typeof ServiceRateSetInputSchema>, client: FreshBooksClientWrapper): Promise<z.infer<typeof ServiceRateSetOutputSchema>>;
+};
+export {};
+//# sourceMappingURL=service-rate-set.d.ts.map

package/dist/tools/service/service-rate-set.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-rate-set.d.ts","sourceRoot":"","sources":["../../../src/tools/service/service-rate-set.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAEhE;;GAEG;AACH,QAAA,MAAM,yBAAyB;;;;;;;;;;;;;;;EAK7B,CAAC;AAEH;;GAEG;AACH,QAAA,MAAM,0BAA0B;;;;;;;;;EAG9B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAyCpB,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,UACxC,uBAAuB,GAC9B,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;CAkCvD,CAAC"}

package/dist/tools/service/service-rate-set.js

@@ -0,0 +1,91 @@
+/**
+ * Service Rate Set Tool
+ *
+ * Set or update the billing rate for a service.
+ * This is the ONLY mutable aspect of services.
+ */
+import { z } from "zod";
+import { ErrorHandler } from "../../errors/error-handler.js";
+/**
+ * Input schema for service_rate_set
+ */
+const ServiceRateSetInputSchema = z.object({
+    businessId: z.number().int().positive().describe("FreshBooks business ID"),
+    serviceId: z.number().int().positive().describe("Service ID"),
+    rate: z.string().describe('Rate amount as decimal string (e.g., "75.00")'),
+    code: z.string().default("USD").describe("Currency code (e.g., USD)"),
+});
+/**
+ * Output schema for service_rate_set
+ */
+const ServiceRateSetOutputSchema = z.object({
+    rate: z.string().describe("Rate amount as decimal string"),
+    code: z.string().describe("Currency code (e.g., USD)"),
+});
+/**
+ * Tool definition for service_rate_set
+ */
+export const serviceRateSetTool = {
+    name: "service_rate_set",
+    description: `Set or update the billing rate for a service in FreshBooks.
+
+WHEN TO USE:
+- Setting initial pricing for a new service
+- Updating rates for existing services
+- Changing billing amounts
+
+REQUIRED INFO:
+- Business ID
+- Service ID
+- Rate amount (as decimal string, e.g., "75.00")
+
+OPTIONAL PARAMETERS:
+- code: Currency code (default: USD)
+
+IMPORTANT:
+- This is the ONLY way to modify service information
+- Services themselves are immutable (name, billable status cannot change)
+- Rates can be updated as needed
+
+RETURNS:
+Updated rate configuration:
+- rate: New amount as decimal string
+- code: Currency code
+
+EXAMPLE PROMPTS:
+- "Set the rate for service 123 to $75 per hour"
+- "Update Development service rate to $100"
+- "Change the billing rate for service 456 to 85.50"
+
+BEST PRACTICES:
+- Use decimal format for rates (e.g., "75.00", not "75")
+- Specify currency if not USD
+- Keep rates current to ensure accurate billing`,
+    inputSchema: ServiceRateSetInputSchema,
+    outputSchema: ServiceRateSetOutputSchema,
+    async execute(input, client) {
+        const handler = ErrorHandler.wrapHandler('service_rate_set', async (input, _context) => {
+            const { businessId, serviceId, rate, code } = input;
+            const result = await client.executeWithRetry('service_rate_set', async (fbClient) => {
+                const rateData = {
+                    rate,
+                    code,
+                };
+                // First try to create (if rate doesn't exist)
+                // If it exists, this will fail and we'll update instead
+                let response = await fbClient.services.rate.create(rateData, businessId, serviceId);
+                // If create failed with "already exists" type error, try update
+                if (!response.ok && response.error?.message?.includes('exists')) {
+                    response = await fbClient.services.rate.update(rateData, businessId, serviceId);
+                }
+                if (!response.ok) {
+                    throw response.error;
+                }
+                return response.data;
+            });
+            return result;
+        });
+        return handler(input, { businessId: input.businessId });
+    },
+};
+//# sourceMappingURL=service-rate-set.js.map

package/dist/tools/service/service-rate-set.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-rate-set.js","sourceRoot":"","sources":["../../../src/tools/service/service-rate-set.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAI7D;;GAEG;AACH,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;IAC1E,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;IAC7D,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;IAC1E,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,2BAA2B,CAAC;CACtE,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IAC1D,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;CACvD,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,IAAI,EAAE,kBAAkB;IACxB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gDAiCiC;IAE9C,WAAW,EAAE,yBAAyB;IACtC,YAAY,EAAE,0BAA0B;IAExC,KAAK,CAAC,OAAO,CACX,KAAgD,EAChD,MAA+B;QAE/B,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,CACtC,kBAAkB,EAClB,KAAK,EAAE,KAAgD,EAAE,QAAqB,EAAE,EAAE;YAChF,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC;YAEpD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;gBAClF,MAAM,QAAQ,GAAG;oBACf,IAAI;oBACJ,IAAI;iBACL,CAAC;gBAEF,8CAA8C;gBAC9C,wDAAwD;gBACxD,IAAI,QAAQ,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,QAAe,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;gBAE3F,gEAAgE;gBAChE,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAChE,QAAQ,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,QAAe,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;gBACzF,CAAC;gBAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;oBACjB,MAAM,QAAQ,CAAC,KAAK,CAAC;gBACvB,CAAC;gBAED,OAAO,QAAQ,CAAC,IAAI,CAAC;YACvB,CAAC,CAAC,CAAC;YAEH,OAAO,MAAoD,CAAC;QAC9D,CAAC,CACF,CAAC;QAEF,OAAO,OAAO,CAAC,KAAK,EAAE,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;IAC1D,CAAC;CACF,CAAC"}

package/dist/tools/service/service-single.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Service Single Tool
+ *
+ * Retrieve a single service by ID.
+ */
+import { z } from "zod";
+import { FreshBooksClientWrapper } from "../../client/index.js";
+/**
+ * Input schema for service_single
+ */
+declare const ServiceSingleInputSchema: z.ZodObject<{
+    businessId: z.ZodNumber;
+    serviceId: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    businessId: number;
+    serviceId: number;
+}, {
+    businessId: number;
+    serviceId: number;
+}>;
+/**
+ * Output schema for service_single
+ */
+declare const ServiceSingleOutputSchema: z.ZodUnknown;
+/**
+ * Tool definition for service_single
+ */
+export declare const serviceSingleTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        businessId: z.ZodNumber;
+        serviceId: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        businessId: number;
+        serviceId: number;
+    }, {
+        businessId: number;
+        serviceId: number;
+    }>;
+    outputSchema: z.ZodUnknown;
+    execute(input: z.infer<typeof ServiceSingleInputSchema>, client: FreshBooksClientWrapper): Promise<z.infer<typeof ServiceSingleOutputSchema>>;
+};
+export {};
+//# sourceMappingURL=service-single.d.ts.map

package/dist/tools/service/service-single.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-single.d.ts","sourceRoot":"","sources":["../../../src/tools/service/service-single.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAEhE;;GAEG;AACH,QAAA,MAAM,wBAAwB;;;;;;;;;EAG5B,CAAC;AAEH;;GAEG;AACH,QAAA,MAAM,yBAAyB,cAAc,CAAC;AAE9C;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;mBA6BnB,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,UACvC,uBAAuB,GAC9B,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;CAsBtD,CAAC"}

package/dist/tools/service/service-single.js

@@ -0,0 +1,63 @@
+/**
+ * Service Single Tool
+ *
+ * Retrieve a single service by ID.
+ */
+import { z } from "zod";
+import { ErrorHandler } from "../../errors/error-handler.js";
+/**
+ * Input schema for service_single
+ */
+const ServiceSingleInputSchema = z.object({
+    businessId: z.number().int().positive().describe("FreshBooks business ID"),
+    serviceId: z.number().int().positive().describe("Service ID to retrieve"),
+});
+/**
+ * Output schema for service_single
+ */
+const ServiceSingleOutputSchema = z.unknown();
+/**
+ * Tool definition for service_single
+ */
+export const serviceSingleTool = {
+    name: "service_single",
+    description: `Get a single service by ID from FreshBooks.
+
+WHEN TO USE:
+- Need detailed information about a specific service
+- Verify service settings before using
+- Check if a service exists
+
+REQUIRED INFO:
+- Business ID
+- Service ID (numeric identifier)
+
+RETURNS:
+Complete service details including:
+- Service ID, name, billable status
+- Visibility state (active/archived)
+
+EXAMPLE PROMPTS:
+- "Get details for service 12345"
+- "Show me service information for ID 789"
+- "What is service 456 used for?"
+
+NOTE: This does not return the service rate. Use service_rate_get for pricing.`,
+    inputSchema: ServiceSingleInputSchema,
+    outputSchema: ServiceSingleOutputSchema,
+    async execute(input, client) {
+        const handler = ErrorHandler.wrapHandler('service_single', async (input, _context) => {
+            const { businessId, serviceId } = input;
+            const result = await client.executeWithRetry('service_single', async (fbClient) => {
+                const response = await fbClient.services.single(businessId, serviceId);
+                if (!response.ok) {
+                    throw response.error;
+                }
+                return response.data;
+            });
+            return result;
+        });
+        return handler(input, { businessId: input.businessId });
+    },
+};
+//# sourceMappingURL=service-single.js.map

package/dist/tools/service/service-single.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-single.js","sourceRoot":"","sources":["../../../src/tools/service/service-single.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAI7D;;GAEG;AACH,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;IAC1E,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;CAC1E,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,yBAAyB,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC;AAE9C;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;+EAqBgE;IAE7E,WAAW,EAAE,wBAAwB;IACrC,YAAY,EAAE,yBAAyB;IAEvC,KAAK,CAAC,OAAO,CACX,KAA+C,EAC/C,MAA+B;QAE/B,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,CACtC,gBAAgB,EAChB,KAAK,EAAE,KAA+C,EAAE,QAAqB,EAAE,EAAE;YAC/E,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC;YAExC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,gBAAgB,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;gBAChF,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;gBAEvE,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;oBACjB,MAAM,QAAQ,CAAC,KAAK,CAAC;gBACvB,CAAC;gBAED,OAAO,QAAQ,CAAC,IAAI,CAAC;YACvB,CAAC,CAAC,CAAC;YAEH,OAAO,MAAM,CAAC;QAChB,CAAC,CACF,CAAC;QAEF,OAAO,OAAO,CAAC,KAAK,EAAE,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;IAC1D,CAAC;CACF,CAAC"}

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

@@ -0,0 +1,12 @@
+/**
+ * Task Tools - FreshBooks task management
+ *
+ * Tasks are project subtasks for detailed time tracking.
+ * Full CRUD support: list, single, create, update, delete.
+ */
+export { taskListTool } from './task-list.js';
+export { taskSingleTool } from './task-single.js';
+export { taskCreateTool } from './task-create.js';
+export { taskUpdateTool } from './task-update.js';
+export { taskDeleteTool } from './task-delete.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/task/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/tools/task/index.js

@@ -0,0 +1,14 @@
+/**
+ * Task Tools - FreshBooks task management
+ *
+ * Tasks are project subtasks for detailed time tracking.
+ * Full CRUD support: list, single, create, update, delete.
+ */
+// Export schemas
+// Export tool definitions
+export { taskListTool } from './task-list.js';
+export { taskSingleTool } from './task-single.js';
+export { taskCreateTool } from './task-create.js';
+export { taskUpdateTool } from './task-update.js';
+export { taskDeleteTool } from './task-delete.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/task/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/task/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,iBAAiB;AAEjB,0BAA0B;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC"}