@ampeco/public-api-mcp 0.3.0 → 0.4.0

package/dist/generated/schemas.d.ts

@@ -118,20 +118,20 @@ export declare const chargePointSetChargingProfileBody: z.ZodObject<{
             limit: z.ZodNumber;
             numberPhases: z.ZodOptional<z.ZodNumber>;
         }, "strip", z.ZodTypeAny, {
-            startPeriod: number;
             limit: number;
+            startPeriod: number;
             numberPhases?: number | undefined;
         }, {
-            startPeriod: number;
             limit: number;
+            startPeriod: number;
             numberPhases?: number | undefined;
         }>, "many">;
         minChargingRate: z.ZodOptional<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
         chargingRateUnit: "A" | "W";
         chargingSchedulePeriod: {
-            startPeriod: number;
             limit: number;
+            startPeriod: number;
             numberPhases?: number | undefined;
         }[];
         id?: number | undefined;
@@ -141,8 +141,8 @@ export declare const chargePointSetChargingProfileBody: z.ZodObject<{
     }, {
         chargingRateUnit: "A" | "W";
         chargingSchedulePeriod: {
-            startPeriod: number;
             limit: number;
+            startPeriod: number;
             numberPhases?: number | undefined;
         }[];
         id?: number | undefined;
@@ -157,8 +157,8 @@ export declare const chargePointSetChargingProfileBody: z.ZodObject<{
     chargingSchedule: {
         chargingRateUnit: "A" | "W";
         chargingSchedulePeriod: {
-            startPeriod: number;
             limit: number;
+            startPeriod: number;
             numberPhases?: number | undefined;
         }[];
         id?: number | undefined;
@@ -177,8 +177,8 @@ export declare const chargePointSetChargingProfileBody: z.ZodObject<{
     chargingSchedule: {
         chargingRateUnit: "A" | "W";
         chargingSchedulePeriod: {
-            startPeriod: number;
             limit: number;
+            startPeriod: number;
             numberPhases?: number | undefined;
         }[];
         id?: number | undefined;
@@ -234,20 +234,20 @@ export declare const chargePointStartChargingSessionBody: z.ZodObject<{
                 limit: z.ZodNumber;
                 numberPhases: z.ZodOptional<z.ZodNumber>;
             }, "strip", z.ZodTypeAny, {
-                startPeriod: number;
                 limit: number;
+                startPeriod: number;
                 numberPhases?: number | undefined;
             }, {
-                startPeriod: number;
                 limit: number;
+                startPeriod: number;
                 numberPhases?: number | undefined;
             }>, "many">;
             minChargingRate: z.ZodOptional<z.ZodNumber>;
         }, "strip", z.ZodTypeAny, {
             chargingRateUnit: "A" | "W";
             chargingSchedulePeriod: {
-                startPeriod: number;
                 limit: number;
+                startPeriod: number;
                 numberPhases?: number | undefined;
             }[];
             id?: number | undefined;
@@ -257,8 +257,8 @@ export declare const chargePointStartChargingSessionBody: z.ZodObject<{
         }, {
             chargingRateUnit: "A" | "W";
             chargingSchedulePeriod: {
-                startPeriod: number;
                 limit: number;
+                startPeriod: number;
                 numberPhases?: number | undefined;
             }[];
             id?: number | undefined;
@@ -273,8 +273,8 @@ export declare const chargePointStartChargingSessionBody: z.ZodObject<{
         chargingSchedule: {
             chargingRateUnit: "A" | "W";
             chargingSchedulePeriod: {
-                startPeriod: number;
                 limit: number;
+                startPeriod: number;
                 numberPhases?: number | undefined;
             }[];
             id?: number | undefined;
@@ -293,8 +293,8 @@ export declare const chargePointStartChargingSessionBody: z.ZodObject<{
         chargingSchedule: {
             chargingRateUnit: "A" | "W";
             chargingSchedulePeriod: {
-                startPeriod: number;
                 limit: number;
+                startPeriod: number;
                 numberPhases?: number | undefined;
             }[];
             id?: number | undefined;
@@ -320,8 +320,8 @@ export declare const chargePointStartChargingSessionBody: z.ZodObject<{
         chargingSchedule: {
             chargingRateUnit: "A" | "W";
             chargingSchedulePeriod: {
-                startPeriod: number;
                 limit: number;
+                startPeriod: number;
                 numberPhases?: number | undefined;
             }[];
             id?: number | undefined;
@@ -347,8 +347,8 @@ export declare const chargePointStartChargingSessionBody: z.ZodObject<{
         chargingSchedule: {
             chargingRateUnit: "A" | "W";
             chargingSchedulePeriod: {
-                startPeriod: number;
                 limit: number;
+                startPeriod: number;
                 numberPhases?: number | undefined;
             }[];
             id?: number | undefined;
@@ -607,20 +607,20 @@ export declare const evseStartChargingWithEvseIdBody: z.ZodObject<{
                 limit: z.ZodNumber;
                 numberPhases: z.ZodOptional<z.ZodNumber>;
             }, "strip", z.ZodTypeAny, {
-                startPeriod: number;
                 limit: number;
+                startPeriod: number;
                 numberPhases?: number | undefined;
             }, {
-                startPeriod: number;
                 limit: number;
+                startPeriod: number;
                 numberPhases?: number | undefined;
             }>, "many">;
             minChargingRate: z.ZodOptional<z.ZodNumber>;
         }, "strip", z.ZodTypeAny, {
             chargingRateUnit: "A" | "W";
             chargingSchedulePeriod: {
-                startPeriod: number;
                 limit: number;
+                startPeriod: number;
                 numberPhases?: number | undefined;
             }[];
             id?: number | undefined;
@@ -630,8 +630,8 @@ export declare const evseStartChargingWithEvseIdBody: z.ZodObject<{
         }, {
             chargingRateUnit: "A" | "W";
             chargingSchedulePeriod: {
-                startPeriod: number;
                 limit: number;
+                startPeriod: number;
                 numberPhases?: number | undefined;
             }[];
             id?: number | undefined;
@@ -646,8 +646,8 @@ export declare const evseStartChargingWithEvseIdBody: z.ZodObject<{
         chargingSchedule: {
             chargingRateUnit: "A" | "W";
             chargingSchedulePeriod: {
-                startPeriod: number;
                 limit: number;
+                startPeriod: number;
                 numberPhases?: number | undefined;
             }[];
             id?: number | undefined;
@@ -666,8 +666,8 @@ export declare const evseStartChargingWithEvseIdBody: z.ZodObject<{
         chargingSchedule: {
             chargingRateUnit: "A" | "W";
             chargingSchedulePeriod: {
-                startPeriod: number;
                 limit: number;
+                startPeriod: number;
                 numberPhases?: number | undefined;
             }[];
             id?: number | undefined;
@@ -693,8 +693,8 @@ export declare const evseStartChargingWithEvseIdBody: z.ZodObject<{
         chargingSchedule: {
             chargingRateUnit: "A" | "W";
             chargingSchedulePeriod: {
-                startPeriod: number;
                 limit: number;
+                startPeriod: number;
                 numberPhases?: number | undefined;
             }[];
             id?: number | undefined;
@@ -720,8 +720,8 @@ export declare const evseStartChargingWithEvseIdBody: z.ZodObject<{
         chargingSchedule: {
             chargingRateUnit: "A" | "W";
             chargingSchedulePeriod: {
-                startPeriod: number;
                 limit: number;
+                startPeriod: number;
                 numberPhases?: number | undefined;
             }[];
             id?: number | undefined;
@@ -2013,12 +2013,12 @@ export declare const chargePointCreateBody: z.ZodObject<{
             limit: z.ZodOptional<z.ZodNumber>;
             numberPhases: z.ZodOptional<z.ZodNumber>;
         }, "strip", z.ZodTypeAny, {
-            startPeriod?: number | undefined;
             limit?: number | undefined;
+            startPeriod?: number | undefined;
             numberPhases?: number | undefined;
         }, {
-            startPeriod?: number | undefined;
             limit?: number | undefined;
+            startPeriod?: number | undefined;
             numberPhases?: number | undefined;
         }>, "many">>;
         scheduleStart: z.ZodOptional<z.ZodString>;
@@ -2042,8 +2042,8 @@ export declare const chargePointCreateBody: z.ZodObject<{
         chargingRateUnit?: "A" | "W" | undefined;
         minChargingRate?: number | undefined;
         schedulePeriods?: {
-            startPeriod?: number | undefined;
             limit?: number | undefined;
+            startPeriod?: number | undefined;
             numberPhases?: number | undefined;
         }[] | undefined;
         scheduleStart?: string | undefined;
@@ -2060,8 +2060,8 @@ export declare const chargePointCreateBody: z.ZodObject<{
         chargingRateUnit?: "A" | "W" | undefined;
         minChargingRate?: number | undefined;
         schedulePeriods?: {
-            startPeriod?: number | undefined;
             limit?: number | undefined;
+            startPeriod?: number | undefined;
             numberPhases?: number | undefined;
         }[] | undefined;
         scheduleStart?: string | undefined;
@@ -2141,8 +2141,8 @@ export declare const chargePointCreateBody: z.ZodObject<{
         chargingRateUnit?: "A" | "W" | undefined;
         minChargingRate?: number | undefined;
         schedulePeriods?: {
-            startPeriod?: number | undefined;
             limit?: number | undefined;
+            startPeriod?: number | undefined;
             numberPhases?: number | undefined;
         }[] | undefined;
         scheduleStart?: string | undefined;
@@ -2238,8 +2238,8 @@ export declare const chargePointCreateBody: z.ZodObject<{
         chargingRateUnit?: "A" | "W" | undefined;
         minChargingRate?: number | undefined;
         schedulePeriods?: {
-            startPeriod?: number | undefined;
             limit?: number | undefined;
+            startPeriod?: number | undefined;
             numberPhases?: number | undefined;
         }[] | undefined;
         scheduleStart?: string | undefined;
@@ -4446,12 +4446,12 @@ export declare const evseUpdateDeprecatedBody: z.ZodObject<{
             limit: z.ZodOptional<z.ZodNumber>;
             numberPhases: z.ZodOptional<z.ZodNumber>;
         }, "strip", z.ZodTypeAny, {
-            startPeriod?: number | undefined;
             limit?: number | undefined;
+            startPeriod?: number | undefined;
             numberPhases?: number | undefined;
         }, {
-            startPeriod?: number | undefined;
             limit?: number | undefined;
+            startPeriod?: number | undefined;
             numberPhases?: number | undefined;
         }>, "many">>;
         scheduleStart: z.ZodOptional<z.ZodString>;
@@ -4475,8 +4475,8 @@ export declare const evseUpdateDeprecatedBody: z.ZodObject<{
         chargingRateUnit?: "A" | "W" | undefined;
         minChargingRate?: number | undefined;
         schedulePeriods?: {
-            startPeriod?: number | undefined;
             limit?: number | undefined;
+            startPeriod?: number | undefined;
             numberPhases?: number | undefined;
         }[] | undefined;
         scheduleStart?: string | undefined;
@@ -4493,8 +4493,8 @@ export declare const evseUpdateDeprecatedBody: z.ZodObject<{
         chargingRateUnit?: "A" | "W" | undefined;
         minChargingRate?: number | undefined;
         schedulePeriods?: {
-            startPeriod?: number | undefined;
             limit?: number | undefined;
+            startPeriod?: number | undefined;
             numberPhases?: number | undefined;
         }[] | undefined;
         scheduleStart?: string | undefined;
@@ -4565,8 +4565,8 @@ export declare const evseUpdateDeprecatedBody: z.ZodObject<{
         chargingRateUnit?: "A" | "W" | undefined;
         minChargingRate?: number | undefined;
         schedulePeriods?: {
-            startPeriod?: number | undefined;
             limit?: number | undefined;
+            startPeriod?: number | undefined;
             numberPhases?: number | undefined;
         }[] | undefined;
         scheduleStart?: string | undefined;
@@ -4612,8 +4612,8 @@ export declare const evseUpdateDeprecatedBody: z.ZodObject<{
         chargingRateUnit?: "A" | "W" | undefined;
         minChargingRate?: number | undefined;
         schedulePeriods?: {
-            startPeriod?: number | undefined;
             limit?: number | undefined;
+            startPeriod?: number | undefined;
             numberPhases?: number | undefined;
         }[] | undefined;
         scheduleStart?: string | undefined;
@@ -7725,12 +7725,12 @@ export declare const partnerSettlementReportPartnerSettlementRecordCreateBody: z
     note: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     date: string;
-    paidAmount: number;
     note: string;
+    paidAmount: number;
 }, {
     date: string;
-    paidAmount: number;
     note: string;
+    paidAmount: number;
 }>;
 export declare const partnerSettlementReportPartnerSettlementRecordUpdateBody: z.ZodObject<{
     date: z.ZodString;
@@ -7738,12 +7738,12 @@ export declare const partnerSettlementReportPartnerSettlementRecordUpdateBody: z
     note: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     date: string;
-    paidAmount: number;
     note: string;
+    paidAmount: number;
 }, {
     date: string;
-    paidAmount: number;
     note: string;
+    paidAmount: number;
 }>;
 export declare const partnerCreateDeprecatedBody: z.ZodObject<{
     id: z.ZodOptional<z.ZodNumber>;
@@ -10583,7 +10583,7 @@ export declare const tariffCreateBody: z.ZodObject<{
         lockEnergyPriceOnSessionStart?: boolean | undefined;
         lockDurationPriceOnSessionStart?: boolean | undefined;
         lockIdlePriceOnSessionStart?: boolean | undefined;
-        stateOfChargeIdleThreshold?: 100 | 95 | 90 | 75 | 80 | 85 | undefined;
+        stateOfChargeIdleThreshold?: 100 | 75 | 95 | 90 | 80 | 85 | undefined;
         averagePowerIdleThreshold?: number | undefined;
     }, {
         pricePerSession?: number | undefined;
@@ -10702,7 +10702,7 @@ export declare const tariffCreateBody: z.ZodObject<{
         lockEnergyPriceOnSessionStart?: boolean | undefined;
         lockDurationPriceOnSessionStart?: boolean | undefined;
         lockIdlePriceOnSessionStart?: boolean | undefined;
-        stateOfChargeIdleThreshold?: 100 | 95 | 90 | 75 | 80 | 85 | undefined;
+        stateOfChargeIdleThreshold?: 100 | 75 | 95 | 90 | 80 | 85 | undefined;
         averagePowerIdleThreshold?: number | undefined;
     }>>;
     currency: z.ZodOptional<z.ZodString>;
@@ -10927,7 +10927,7 @@ export declare const tariffCreateBody: z.ZodObject<{
         lockEnergyPriceOnSessionStart?: boolean | undefined;
         lockDurationPriceOnSessionStart?: boolean | undefined;
         lockIdlePriceOnSessionStart?: boolean | undefined;
-        stateOfChargeIdleThreshold?: 100 | 95 | 90 | 75 | 80 | 85 | undefined;
+        stateOfChargeIdleThreshold?: 100 | 75 | 95 | 90 | 80 | 85 | undefined;
         averagePowerIdleThreshold?: number | undefined;
     } | undefined;
     stopSession?: {
@@ -11086,7 +11086,7 @@ export declare const tariffCreateBody: z.ZodObject<{
         lockEnergyPriceOnSessionStart?: boolean | undefined;
         lockDurationPriceOnSessionStart?: boolean | undefined;
         lockIdlePriceOnSessionStart?: boolean | undefined;
-        stateOfChargeIdleThreshold?: 100 | 95 | 90 | 75 | 80 | 85 | undefined;
+        stateOfChargeIdleThreshold?: 100 | 75 | 95 | 90 | 80 | 85 | undefined;
         averagePowerIdleThreshold?: number | undefined;
     } | undefined;
     stopSession?: {
@@ -11547,7 +11547,7 @@ export declare const tariffUpdateBody: z.ZodObject<{
         lockEnergyPriceOnSessionStart?: boolean | undefined;
         lockDurationPriceOnSessionStart?: boolean | undefined;
         lockIdlePriceOnSessionStart?: boolean | undefined;
-        stateOfChargeIdleThreshold?: 100 | 95 | 90 | 75 | 80 | 85 | undefined;
+        stateOfChargeIdleThreshold?: 100 | 75 | 95 | 90 | 80 | 85 | undefined;
         averagePowerIdleThreshold?: number | undefined;
     }, {
         pricePerSession?: number | undefined;
@@ -11666,7 +11666,7 @@ export declare const tariffUpdateBody: z.ZodObject<{
         lockEnergyPriceOnSessionStart?: boolean | undefined;
         lockDurationPriceOnSessionStart?: boolean | undefined;
         lockIdlePriceOnSessionStart?: boolean | undefined;
-        stateOfChargeIdleThreshold?: 100 | 95 | 90 | 75 | 80 | 85 | undefined;
+        stateOfChargeIdleThreshold?: 100 | 75 | 95 | 90 | 80 | 85 | undefined;
         averagePowerIdleThreshold?: number | undefined;
     }>>;
     currency: z.ZodOptional<z.ZodString>;
@@ -11891,7 +11891,7 @@ export declare const tariffUpdateBody: z.ZodObject<{
         lockEnergyPriceOnSessionStart?: boolean | undefined;
         lockDurationPriceOnSessionStart?: boolean | undefined;
         lockIdlePriceOnSessionStart?: boolean | undefined;
-        stateOfChargeIdleThreshold?: 100 | 95 | 90 | 75 | 80 | 85 | undefined;
+        stateOfChargeIdleThreshold?: 100 | 75 | 95 | 90 | 80 | 85 | undefined;
         averagePowerIdleThreshold?: number | undefined;
     } | undefined;
     stopSession?: {
@@ -12050,7 +12050,7 @@ export declare const tariffUpdateBody: z.ZodObject<{
         lockEnergyPriceOnSessionStart?: boolean | undefined;
         lockDurationPriceOnSessionStart?: boolean | undefined;
         lockIdlePriceOnSessionStart?: boolean | undefined;
-        stateOfChargeIdleThreshold?: 100 | 95 | 90 | 75 | 80 | 85 | undefined;
+        stateOfChargeIdleThreshold?: 100 | 75 | 95 | 90 | 80 | 85 | undefined;
         averagePowerIdleThreshold?: number | undefined;
     } | undefined;
     stopSession?: {

package/dist/server/factory.d.ts

@@ -3,10 +3,10 @@
  * Creates and configures MCP server instances with shared logic for resources, tools, and prompts
  */
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { BuildOutput } from '../build/types.js';
+import type { BuildOutput, ResponseSchemaMap } from '../build/types.js';
 import type { ServerOptions } from './types.js';
 /**
  * Create and configure the MCP server
  */
-export declare function createServer(endpoints: BuildOutput, options: ServerOptions): McpServer;
+export declare function createServer(endpoints: BuildOutput, responseSchemas: ResponseSchemaMap, options: ServerOptions): McpServer;
 //# sourceMappingURL=factory.d.ts.map

package/dist/server/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/server/factory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAMhD;;GAEG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,aAAa,GAAG,SAAS,CAwTtF"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/server/factory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOpE,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAqBhD;;GAEG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,WAAW,EACtB,eAAe,EAAE,iBAAiB,EAClC,OAAO,EAAE,aAAa,GACrB,SAAS,CA2aX"}

package/dist/server/factory.js

@@ -10,11 +10,32 @@ import { getPromptContent } from './prompts.js';
 import { getNativeResourceInstructions, getToolEmulationInstructions } from './instructions.js';
 import { registerNativeResources } from './resources/native.js';
 import { registerEmulationTools } from './resources/tools.js';
+import { transformResponse } from './utils/response-transformer.js';
+/**
+ * Helper to get response schema for an endpoint
+ */
+function getResponseSchema(responseSchemas, operationId, statusCode) {
+    if (!operationId || !responseSchemas[operationId]) {
+        return null;
+    }
+    return responseSchemas[operationId][statusCode]?.schema || null;
+}
 /**
  * Create and configure the MCP server
  */
-export function createServer(endpoints, options) {
+export function createServer(endpoints, responseSchemas, options) {
     const { hostname, bearerToken, emulateResourcesViaTools = false, } = options;
+    // Validate hostname
+    if (!hostname) {
+        throw new Error('Hostname is required but was not provided');
+    }
+    // Validate hostname is a valid URL
+    try {
+        new URL(hostname);
+    }
+    catch (error) {
+        throw new Error(`Invalid hostname URL: ${hostname}`);
+    }
     const server = new McpServer({
         name: 'public-api-mcp',
         version: '0.1.0',
@@ -39,15 +60,60 @@ export function createServer(endpoints, options) {
     // Register the API request tool
     server.tool('api_request', `Make an authenticated HTTP request to any active API endpoint from the OpenAPI specification. Deprecated endpoints cannot be called and will return an error. Authentication is handled automatically using the Bearer token from the MCP request. The target API hostname is: ${hostname}
 
-IMPORTANT - Pagination: Always prefer cursor-based pagination when available. For list endpoints that support both offset and cursor pagination, you MUST use cursor pagination by including an empty "cursor" query parameter (cursor="") in your initial request to engage cursor-based pagination. Subsequent requests should use the cursor value returned in the response.`, {
+**Smart Response Transformation** (Enabled by Default):
+When responses are large (>20KB), automatic transformation is applied to:
+- Preserve ALL pagination metadata (cursor, total, hasMore, nextPage)
+- Provide statistical summaries (min, max, avg, median, percentiles)
+- Include categorical distributions (status counts, type breakdowns)
+- Sample representative items for context
+
+This ensures you can:
+✓ Navigate paginated results reliably
+✓ Understand data distributions without loading all items
+✓ Make data-driven decisions with statistical insights
+✓ Reduce token consumption by 80-95% for large responses
+
+Field types are automatically detected from OpenAPI schemas (zero configuration required).
+
+To disable transformation: Set transform_response=false
+
+**Pagination Best Practice**:
+Always prefer cursor-based pagination when available. For list endpoints that support both offset and cursor pagination, include an empty "cursor" query parameter (cursor="") in your initial request to engage cursor-based pagination.`, {
         endpoint: z.string().describe('The API endpoint path (e.g., "/users/{id}")'),
         method: z.enum(['GET', 'POST', 'PUT', 'DELETE', 'PATCH', 'HEAD', 'OPTIONS']).describe('HTTP method'),
         path_params: z.preprocess((val) => (val === null || val === undefined || val === '' ? {} : val), z.record(z.any()).default({})).optional().describe('Path parameter values as key-value pairs (optional)'),
         query_params: z.preprocess((val) => (val === null || val === undefined || val === '' ? {} : val), z.record(z.any()).default({})).optional().describe('Query string parameters as key-value pairs (optional)'),
         body: z.preprocess((val) => (val === null || val === undefined || val === '' ? undefined : val), z.any()).optional().describe('Request body for POST/PUT/PATCH requests (optional)'),
         headers: z.preprocess((val) => (val === null || val === undefined || val === '' ? {} : val), z.record(z.string()).default({})).optional().describe('Additional HTTP headers (optional)'),
+        // NEW: Smart transformation parameters
+        transform_response: z.boolean()
+            .default(true)
+            .optional()
+            .describe('Enable smart response transformation for large responses. When enabled, large array-based responses ' +
+            'are automatically transformed to include: (1) pagination metadata, (2) statistical summaries ' +
+            '(min/max/avg/distribution), and (3) sample items. This dramatically reduces token usage while ' +
+            'preserving critical navigation and analytical information. Default: true'),
+        transform_options: z.object({
+            maxResponseSize: z.number()
+                .min(1000)
+                .max(1000000)
+                .optional()
+                .describe('Maximum response size in bytes before transformation is applied (default: 20000, range: 1000-1000000)'),
+            sampleSize: z.number()
+                .int()
+                .min(1)
+                .max(20)
+                .optional()
+                .describe('Number of sample items to include in transformed response (default: 5, range: 1-20)'),
+            computeStats: z.boolean()
+                .optional()
+                .describe('Whether to compute numeric statistics and categorical distributions (default: true)'),
+            includeDistribution: z.boolean()
+                .optional()
+                .describe('Whether to include categorical field distributions (default: true)'),
+        }).optional().describe('Advanced transformation options (optional). Field selection is automatic via OpenAPI schema detection.'),
     }, async (args) => {
-        const { endpoint, method, path_params = {}, query_params = {}, body, headers = {}, } = args;
+        const { endpoint, method, path_params = {}, query_params = {}, body, headers = {}, transform_response = true, transform_options = {}, } = args;
         // Check if endpoint is deprecated
         const endpointDef = endpoints.endpoints.find((e) => e.path === endpoint && e.method.toUpperCase() === method.toUpperCase());
         if (endpointDef?.deprecated) {
@@ -111,38 +177,74 @@ IMPORTANT - Pagination: Always prefer cursor-based pagination when available. Fo
             }
             // Log the response
             console.error(`[API Response] ${response.status} ${response.statusText}`);
-            // Prepare structured response with truncation
-            const responseObject = {
-                status: response.status,
-                body: responseBody,
-            };
-            let responseText = JSON.stringify(responseObject, null, 2);
-            // Truncate if response exceeds 20000 characters (leaving room for metadata)
-            const MAX_RESPONSE_LENGTH = 20000;
-            let wasTruncated = false;
-            if (responseText.length > MAX_RESPONSE_LENGTH) {
-                wasTruncated = true;
-                const originalLength = responseText.length;
-                responseText = responseText.substring(0, MAX_RESPONSE_LENGTH);
-                // Try to truncate at a reasonable boundary (end of a line)
-                const lastNewlineIndex = responseText.lastIndexOf('\n');
-                if (lastNewlineIndex > MAX_RESPONSE_LENGTH * 0.9) {
-                    responseText = responseText.substring(0, lastNewlineIndex);
+            // NEW: Apply smart transformation if enabled
+            let finalResponse;
+            if (transform_response && responseBody && typeof responseBody === "object") {
+                // Smart 2XX response schema selection
+                let responseSchema = null;
+                const statusCode = response.status.toString();
+                // Try exact status code first
+                responseSchema = getResponseSchema(responseSchemas, endpointDef?.operationId, statusCode);
+                // Fallback: try common success codes in priority order
+                if (!responseSchema) {
+                    const successCodes = ["200", "201", "202", "204", "2XX", "default"];
+                    for (const code of successCodes) {
+                        responseSchema = getResponseSchema(responseSchemas, endpointDef?.operationId, code);
+                        if (responseSchema) {
+                            console.error(`[Transformer] Using schema for status ${code} (fallback from ${statusCode})`);
+                            break;
+                        }
+                    }
+                }
+                else {
+                    console.error(`[Transformer] Using schema for status ${statusCode}`);
+                }
+                if (!responseSchema) {
+                    console.error(`[Transformer] No schema found for ${method} ${endpoint} ` +
+                        `(operationId: ${endpointDef?.operationId}, status: ${statusCode})`);
                 }
-                // Add truncation notice
-                responseText += `\n\n... [Response truncated - original size: ${originalLength} characters, showing first ${responseText.length} characters]\n\nNote: The response was too large to display in full. This is typically because the API returned detailed error information or a large dataset. Check the status code and the visible portion of the response for key information.`;
+                // Apply transformation
+                const transformResult = transformResponse(responseBody, {
+                    ...transform_options,
+                    enabled: true,
+                }, responseSchema // Pass the selected schema
+                );
+                finalResponse = {
+                    ...transformResult,
+                };
+                // Log transformation results
+                if (transformResult.data._transformation.applied) {
+                    const reduction = (((transformResult.data._transformation.originalSize -
+                        transformResult.data._transformation.transformedSize) /
+                        transformResult.data._transformation.originalSize) *
+                        100).toFixed(1);
+                    console.error(`[Transformer] Applied transformation: ${transformResult.data._transformation.originalSize} → ` +
+                        `${transformResult.data._transformation.transformedSize} bytes (${reduction}% reduction)`);
+                }
+            }
+            else {
+                finalResponse = {
+                    status: response.status,
+                    body: responseBody,
+                };
             }
-            const toolResponse = {
+            let responseText = JSON.stringify(finalResponse, null, 2);
+            // Fallback truncation (should rarely trigger now)
+            const MAX_RESPONSE_LENGTH = 50000; // Increased since transformation reduces size
+            if (responseText.length > MAX_RESPONSE_LENGTH) {
+                console.error(`[Warning] Response still exceeds limit after transformation ` +
+                    `(${responseText.length} chars, status ${response.status})`);
+                responseText = responseText.substring(0, MAX_RESPONSE_LENGTH) + "\n\n... [Response truncated]";
+            }
+            // Return structured response
+            return {
                 content: [
                     {
-                        type: 'text',
+                        type: "text",
                         text: responseText,
                     },
                 ],
             };
-            console.error(`[Tool Response] Returning response with ${responseText.length} characters${wasTruncated ? ' (truncated)' : ''}`);
-            // Return structured response
-            return toolResponse;
         }
         catch (error) {
             const errorMessage = error instanceof Error ? error.message : String(error);