truss-api-mcp 1.0.0

package/dist/tools/compare-specs.js

@@ -0,0 +1,59 @@
+import { z } from 'zod';
+import { requirePro } from '../lib/license.js';
+import { parseOpenApiSpec } from '../lib/openapi-parser.js';
+import { compareSpecs } from '../lib/code-generator.js';
+export function registerCompareSpecs(server) {
+    server.tool('compare_specs', '[Pro] Diff two OpenAPI specs and find breaking changes, non-breaking changes, new endpoints, and removed endpoints. Essential for API versioning.', {
+        old_spec: z.string().describe('The old/previous OpenAPI spec as JSON or YAML'),
+        new_spec: z.string().describe('The new/updated OpenAPI spec as JSON or YAML'),
+    }, async ({ old_spec, new_spec }) => {
+        try {
+            await requirePro();
+            const oldParsed = parseOpenApiSpec(old_spec);
+            const newParsed = parseOpenApiSpec(new_spec);
+            const comparison = compareSpecs(oldParsed, newParsed);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            summary: {
+                                breaking_changes: comparison.breaking_changes.length,
+                                non_breaking_changes: comparison.non_breaking.length,
+                                new_endpoints: comparison.new_endpoints.length,
+                                removed_endpoints: comparison.removed_endpoints.length,
+                                is_backwards_compatible: comparison.breaking_changes.length === 0,
+                            },
+                            breaking_changes: comparison.breaking_changes,
+                            non_breaking_changes: comparison.non_breaking,
+                            new_endpoints: comparison.new_endpoints,
+                            removed_endpoints: comparison.removed_endpoints,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            const isLicense = message.includes('TRUSS Pro license');
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: message,
+                            ...(isLicense
+                                ? {
+                                    upgrade_url: 'https://truss.dev/pricing',
+                                    price: '$25/mo',
+                                }
+                                : {}),
+                        }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=compare-specs.js.map

package/dist/tools/compare-specs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare-specs.js","sourceRoot":"","sources":["../../src/tools/compare-specs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,MAAM,UAAU,oBAAoB,CAAC,MAAiB;IACpD,MAAM,CAAC,IAAI,CACT,eAAe,EACf,mJAAmJ,EACnJ;QACE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;QAC9E,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;KAC9E,EACD,KAAK,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,EAAE;QAC/B,IAAI,CAAC;YACH,MAAM,UAAU,EAAE,CAAC;YAEnB,MAAM,SAAS,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;YAC7C,MAAM,SAAS,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;YAC7C,MAAM,UAAU,GAAG,YAAY,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YAEtD,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,OAAO,EAAE;gCACP,gBAAgB,EAAE,UAAU,CAAC,gBAAgB,CAAC,MAAM;gCACpD,oBAAoB,EAAE,UAAU,CAAC,YAAY,CAAC,MAAM;gCACpD,aAAa,EAAE,UAAU,CAAC,aAAa,CAAC,MAAM;gCAC9C,iBAAiB,EAAE,UAAU,CAAC,iBAAiB,CAAC,MAAM;gCACtD,uBAAuB,EAAE,UAAU,CAAC,gBAAgB,CAAC,MAAM,KAAK,CAAC;6BAClE;4BACD,gBAAgB,EAAE,UAAU,CAAC,gBAAgB;4BAC7C,oBAAoB,EAAE,UAAU,CAAC,YAAY;4BAC7C,aAAa,EAAE,UAAU,CAAC,aAAa;4BACvC,iBAAiB,EAAE,UAAU,CAAC,iBAAiB;yBAChD,EAAE,IAAI,EAAE,CAAC,CAAC;qBACZ;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC;YAExD,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,KAAK,EAAE,OAAO;4BACd,GAAG,CAAC,SAAS;gCACX,CAAC,CAAC;oCACE,WAAW,EAAE,2BAA2B;oCACxC,KAAK,EAAE,QAAQ;iCAChB;gCACH,CAAC,CAAC,EAAE,CAAC;yBACR,EAAE,IAAI,EAAE,CAAC,CAAC;qBACZ;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/generate-client.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerGenerateClient(server: McpServer): void;
+//# sourceMappingURL=generate-client.d.ts.map

package/dist/tools/generate-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-client.d.ts","sourceRoot":"","sources":["../../src/tools/generate-client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAoE9D"}

package/dist/tools/generate-client.js

@@ -0,0 +1,65 @@
+import { z } from 'zod';
+import { requirePro } from '../lib/license.js';
+import { parseOpenApiSpec } from '../lib/openapi-parser.js';
+import { generateClient } from '../lib/code-generator.js';
+export function registerGenerateClient(server) {
+    server.tool('generate_client', '[Pro] Generate a typed API client from an OpenAPI spec. Supports TypeScript (fetch/axios), Python (requests), and Go (net/http). Produces ready-to-use code with type definitions.', {
+        spec: z.string().describe('OpenAPI/Swagger spec as JSON or YAML string'),
+        language: z
+            .enum(['typescript', 'python', 'go'])
+            .describe('Target language for the client'),
+        style: z
+            .enum(['fetch', 'axios'])
+            .optional()
+            .default('fetch')
+            .describe('HTTP library style (TypeScript only, default: fetch)'),
+    }, async ({ spec, language, style }) => {
+        try {
+            await requirePro();
+            const parsed = parseOpenApiSpec(spec);
+            const code = generateClient(parsed, language, style);
+            const extensions = {
+                typescript: '.ts',
+                python: '.py',
+                go: '.go',
+            };
+            const filename = `api_client${extensions[language]}`;
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            filename,
+                            language,
+                            style: language === 'typescript' ? style : undefined,
+                            endpoint_count: parsed.endpoints.length,
+                            code,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            const isLicense = message.includes('TRUSS Pro license');
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: message,
+                            ...(isLicense
+                                ? {
+                                    upgrade_url: 'https://truss.dev/pricing',
+                                    price: '$25/mo',
+                                }
+                                : {}),
+                        }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=generate-client.js.map

package/dist/tools/generate-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-client.js","sourceRoot":"","sources":["../../src/tools/generate-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,MAAM,UAAU,sBAAsB,CAAC,MAAiB;IACtD,MAAM,CAAC,IAAI,CACT,iBAAiB,EACjB,oLAAoL,EACpL;QACE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;QACxE,QAAQ,EAAE,CAAC;aACR,IAAI,CAAC,CAAC,YAAY,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;aACpC,QAAQ,CAAC,gCAAgC,CAAC;QAC7C,KAAK,EAAE,CAAC;aACL,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;aACxB,QAAQ,EAAE;aACV,OAAO,CAAC,OAAO,CAAC;aAChB,QAAQ,CAAC,sDAAsD,CAAC;KACpE,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE;QAClC,IAAI,CAAC;YACH,MAAM,UAAU,EAAE,CAAC;YAEnB,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;YACtC,MAAM,IAAI,GAAG,cAAc,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;YAErD,MAAM,UAAU,GAA2B;gBACzC,UAAU,EAAE,KAAK;gBACjB,MAAM,EAAE,KAAK;gBACb,EAAE,EAAE,KAAK;aACV,CAAC;YAEF,MAAM,QAAQ,GAAG,aAAa,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAErD,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,QAAQ;4BACR,QAAQ;4BACR,KAAK,EAAE,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;4BACpD,cAAc,EAAE,MAAM,CAAC,SAAS,CAAC,MAAM;4BACvC,IAAI;yBACL,EAAE,IAAI,EAAE,CAAC,CAAC;qBACZ;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC;YAExD,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,KAAK,EAAE,OAAO;4BACd,GAAG,CAAC,SAAS;gCACX,CAAC,CAAC;oCACE,WAAW,EAAE,2BAA2B;oCACxC,KAAK,EAAE,QAAQ;iCAChB;gCACH,CAAC,CAAC,EAAE,CAAC;yBACR,EAAE,IAAI,EAAE,CAAC,CAAC;qBACZ;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/generate-openapi.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerGenerateOpenApi(server: McpServer): void;
+//# sourceMappingURL=generate-openapi.d.ts.map

package/dist/tools/generate-openapi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-openapi.d.ts","sourceRoot":"","sources":["../../src/tools/generate-openapi.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA6D/D"}

package/dist/tools/generate-openapi.js

@@ -0,0 +1,57 @@
+import { z } from 'zod';
+import { requirePro } from '../lib/license.js';
+import { generateOpenApiFromExamples } from '../lib/openapi-parser.js';
+export function registerGenerateOpenApi(server) {
+    server.tool('generate_openapi', '[Pro] Auto-generate an OpenAPI 3.0 spec from example requests and responses. Infers schemas, path parameters, query parameters, and response types.', {
+        examples: z.array(z.object({
+            method: z.string().describe('HTTP method (GET, POST, etc.)'),
+            url: z.string().describe('Full URL of the request'),
+            request_body: z.unknown().optional().describe('Request body sent'),
+            response_body: z.unknown().describe('Response body received'),
+            status: z.number().describe('HTTP status code'),
+            headers: z.record(z.string(), z.string()).optional().describe('Request headers'),
+        })).min(1).describe('Array of example request/response pairs'),
+    }, async ({ examples }) => {
+        try {
+            await requirePro();
+            const yamlSpec = generateOpenApiFromExamples(examples);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: yamlSpec,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            const isLicense = message.includes('TRUSS Pro license');
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: message,
+                            ...(isLicense
+                                ? {
+                                    upgrade_url: 'https://truss.dev/pricing',
+                                    price: '$25/mo',
+                                    features: [
+                                        'Generate OpenAPI specs from examples',
+                                        'Generate API test suites',
+                                        'Mock server generation',
+                                        'Spec comparison & breaking change detection',
+                                        'Multi-language client code generation',
+                                    ],
+                                }
+                                : {}),
+                        }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=generate-openapi.js.map

package/dist/tools/generate-openapi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-openapi.js","sourceRoot":"","sources":["../../src/tools/generate-openapi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAEvE,MAAM,UAAU,uBAAuB,CAAC,MAAiB;IACvD,MAAM,CAAC,IAAI,CACT,kBAAkB,EAClB,qJAAqJ,EACrJ;QACE,QAAQ,EAAE,CAAC,CAAC,KAAK,CACf,CAAC,CAAC,MAAM,CAAC;YACP,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;YAC5D,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;YACnD,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;YAClE,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;YAC7D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;YAC/C,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;SACjF,CAAC,CACH,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,yCAAyC,CAAC;KAC7D,EACD,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;QACrB,IAAI,CAAC;YACH,MAAM,UAAU,EAAE,CAAC;YAEnB,MAAM,QAAQ,GAAG,2BAA2B,CAAC,QAAkD,CAAC,CAAC;YAEjG,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,QAAQ;qBACf;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC;YAExD,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,KAAK,EAAE,OAAO;4BACd,GAAG,CAAC,SAAS;gCACX,CAAC,CAAC;oCACE,WAAW,EAAE,2BAA2B;oCACxC,KAAK,EAAE,QAAQ;oCACf,QAAQ,EAAE;wCACR,sCAAsC;wCACtC,0BAA0B;wCAC1B,wBAAwB;wCACxB,6CAA6C;wCAC7C,uCAAuC;qCACxC;iCACF;gCACH,CAAC,CAAC,EAAE,CAAC;yBACR,EAAE,IAAI,EAAE,CAAC,CAAC;qBACZ;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/generate-tests.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerGenerateTests(server: McpServer): void;
+//# sourceMappingURL=generate-tests.d.ts.map

package/dist/tools/generate-tests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-tests.d.ts","sourceRoot":"","sources":["../../src/tools/generate-tests.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA8D7D"}

package/dist/tools/generate-tests.js

@@ -0,0 +1,59 @@
+import { z } from 'zod';
+import { requirePro } from '../lib/license.js';
+import { parseOpenApiSpec } from '../lib/openapi-parser.js';
+import { generateTests } from '../lib/code-generator.js';
+export function registerGenerateTests(server) {
+    server.tool('generate_tests', '[Pro] Generate a complete API test suite from an OpenAPI spec. Supports Jest, Vitest, and Pytest frameworks. Generates happy-path and error-case tests.', {
+        spec: z.string().describe('OpenAPI/Swagger spec as JSON or YAML string'),
+        base_url: z.string().describe('Base URL of the API to test (e.g., http://localhost:3000)'),
+        framework: z
+            .enum(['jest', 'vitest', 'pytest'])
+            .optional()
+            .default('vitest')
+            .describe('Test framework to generate for (default: vitest)'),
+    }, async ({ spec, base_url, framework }) => {
+        try {
+            await requirePro();
+            const parsed = parseOpenApiSpec(spec);
+            const testCode = generateTests(parsed, base_url, framework);
+            const filename = framework === 'pytest'
+                ? 'test_api.py'
+                : `api.test.${framework === 'jest' ? 'js' : 'ts'}`;
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            filename,
+                            framework,
+                            endpoint_count: parsed.endpoints.length,
+                            code: testCode,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            const isLicense = message.includes('TRUSS Pro license');
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: message,
+                            ...(isLicense
+                                ? {
+                                    upgrade_url: 'https://truss.dev/pricing',
+                                    price: '$25/mo',
+                                }
+                                : {}),
+                        }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=generate-tests.js.map

package/dist/tools/generate-tests.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-tests.js","sourceRoot":"","sources":["../../src/tools/generate-tests.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD,MAAM,UAAU,qBAAqB,CAAC,MAAiB;IACrD,MAAM,CAAC,IAAI,CACT,gBAAgB,EAChB,yJAAyJ,EACzJ;QACE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;QACxE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2DAA2D,CAAC;QAC1F,SAAS,EAAE,CAAC;aACT,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;aAClC,QAAQ,EAAE;aACV,OAAO,CAAC,QAAQ,CAAC;aACjB,QAAQ,CAAC,kDAAkD,CAAC;KAChE,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,EAAE;QACtC,IAAI,CAAC;YACH,MAAM,UAAU,EAAE,CAAC;YAEnB,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;YACtC,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;YAE5D,MAAM,QAAQ,GACZ,SAAS,KAAK,QAAQ;gBACpB,CAAC,CAAC,aAAa;gBACf,CAAC,CAAC,YAAY,SAAS,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAEvD,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,QAAQ;4BACR,SAAS;4BACT,cAAc,EAAE,MAAM,CAAC,SAAS,CAAC,MAAM;4BACvC,IAAI,EAAE,QAAQ;yBACf,EAAE,IAAI,EAAE,CAAC,CAAC;qBACZ;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC;YAExD,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,KAAK,EAAE,OAAO;4BACd,GAAG,CAAC,SAAS;gCACX,CAAC,CAAC;oCACE,WAAW,EAAE,2BAA2B;oCACxC,KAAK,EAAE,QAAQ;iCAChB;gCACH,CAAC,CAAC,EAAE,CAAC;yBACR,EAAE,IAAI,EAAE,CAAC,CAAC;qBACZ;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/mock-server.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerMockServer(server: McpServer): void;
+//# sourceMappingURL=mock-server.d.ts.map

package/dist/tools/mock-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-server.d.ts","sourceRoot":"","sources":["../../src/tools/mock-server.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA6D1D"}

package/dist/tools/mock-server.js

@@ -0,0 +1,60 @@
+import { z } from 'zod';
+import { requirePro } from '../lib/license.js';
+import { parseOpenApiSpec } from '../lib/openapi-parser.js';
+import { generateMockServer } from '../lib/code-generator.js';
+export function registerMockServer(server) {
+    server.tool('mock_server', '[Pro] Generate a mock server configuration from an OpenAPI spec. Produces routes with sample responses and a db.json file ready for json-server or similar.', {
+        spec: z.string().describe('OpenAPI/Swagger spec as JSON or YAML string'),
+    }, async ({ spec }) => {
+        try {
+            await requirePro();
+            const parsed = parseOpenApiSpec(spec);
+            const mockConfig = generateMockServer(parsed);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            route_count: mockConfig.routes.length,
+                            routes: mockConfig.routes,
+                            mock_data: mockConfig.mock_data,
+                            usage_instructions: {
+                                json_server: [
+                                    '1. Save mock_data to db.json',
+                                    '2. npx json-server db.json --port 3001',
+                                    '3. Access endpoints at http://localhost:3001',
+                                ],
+                                custom: [
+                                    'Use the routes array to configure any mock server.',
+                                    'Each route has: method, path, status, response, headers.',
+                                ],
+                            },
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            const isLicense = message.includes('TRUSS Pro license');
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: message,
+                            ...(isLicense
+                                ? {
+                                    upgrade_url: 'https://truss.dev/pricing',
+                                    price: '$25/mo',
+                                }
+                                : {}),
+                        }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=mock-server.js.map

package/dist/tools/mock-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-server.js","sourceRoot":"","sources":["../../src/tools/mock-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,MAAM,UAAU,kBAAkB,CAAC,MAAiB;IAClD,MAAM,CAAC,IAAI,CACT,aAAa,EACb,6JAA6J,EAC7J;QACE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;KACzE,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QACjB,IAAI,CAAC;YACH,MAAM,UAAU,EAAE,CAAC;YAEnB,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;YACtC,MAAM,UAAU,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;YAE9C,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,WAAW,EAAE,UAAU,CAAC,MAAM,CAAC,MAAM;4BACrC,MAAM,EAAE,UAAU,CAAC,MAAM;4BACzB,SAAS,EAAE,UAAU,CAAC,SAAS;4BAC/B,kBAAkB,EAAE;gCAClB,WAAW,EAAE;oCACX,8BAA8B;oCAC9B,wCAAwC;oCACxC,8CAA8C;iCAC/C;gCACD,MAAM,EAAE;oCACN,oDAAoD;oCACpD,0DAA0D;iCAC3D;6BACF;yBACF,EAAE,IAAI,EAAE,CAAC,CAAC;qBACZ;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC;YAExD,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,KAAK,EAAE,OAAO;4BACd,GAAG,CAAC,SAAS;gCACX,CAAC,CAAC;oCACE,WAAW,EAAE,2BAA2B;oCACxC,KAAK,EAAE,QAAQ;iCAChB;gCACH,CAAC,CAAC,EAAE,CAAC;yBACR,EAAE,IAAI,EAAE,CAAC,CAAC;qBACZ;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/parse-openapi.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerParseOpenApi(server: McpServer): void;
+//# sourceMappingURL=parse-openapi.d.ts.map

package/dist/tools/parse-openapi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-openapi.d.ts","sourceRoot":"","sources":["../../src/tools/parse-openapi.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAiD5D"}

package/dist/tools/parse-openapi.js

@@ -0,0 +1,48 @@
+import { z } from 'zod';
+import { parseOpenApiSpec } from '../lib/openapi-parser.js';
+export function registerParseOpenApi(server) {
+    server.tool('parse_openapi', 'Parse an OpenAPI 3.x or Swagger 2.0 spec (JSON or YAML) and list all endpoints with their parameters, request bodies, and response schemas.', {
+        spec: z.string().describe('OpenAPI/Swagger spec content as JSON or YAML string'),
+    }, async ({ spec }) => {
+        try {
+            const parsed = parseOpenApiSpec(spec);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            info: parsed.info,
+                            servers: parsed.servers,
+                            endpoint_count: parsed.endpoints.length,
+                            endpoints: parsed.endpoints.map((ep) => ({
+                                method: ep.method,
+                                path: ep.path,
+                                summary: ep.summary,
+                                operationId: ep.operationId,
+                                tags: ep.tags,
+                                parameters: ep.parameters,
+                                request_body: ep.requestBody,
+                                responses: ep.responses,
+                            })),
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: err instanceof Error ? err.message : String(err),
+                            hint: 'Provide a valid OpenAPI 3.x or Swagger 2.0 spec as JSON or YAML string.',
+                        }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=parse-openapi.js.map

package/dist/tools/parse-openapi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-openapi.js","sourceRoot":"","sources":["../../src/tools/parse-openapi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D,MAAM,UAAU,oBAAoB,CAAC,MAAiB;IACpD,MAAM,CAAC,IAAI,CACT,eAAe,EACf,6IAA6I,EAC7I;QACE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qDAAqD,CAAC;KACjF,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QACjB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;YAEtC,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,IAAI,EAAE,MAAM,CAAC,IAAI;4BACjB,OAAO,EAAE,MAAM,CAAC,OAAO;4BACvB,cAAc,EAAE,MAAM,CAAC,SAAS,CAAC,MAAM;4BACvC,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;gCACvC,MAAM,EAAE,EAAE,CAAC,MAAM;gCACjB,IAAI,EAAE,EAAE,CAAC,IAAI;gCACb,OAAO,EAAE,EAAE,CAAC,OAAO;gCACnB,WAAW,EAAE,EAAE,CAAC,WAAW;gCAC3B,IAAI,EAAE,EAAE,CAAC,IAAI;gCACb,UAAU,EAAE,EAAE,CAAC,UAAU;gCACzB,YAAY,EAAE,EAAE,CAAC,WAAW;gCAC5B,SAAS,EAAE,EAAE,CAAC,SAAS;6BACxB,CAAC,CAAC;yBACJ,EAAE,IAAI,EAAE,CAAC,CAAC;qBACZ;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;4BACvD,IAAI,EAAE,yEAAyE;yBAChF,EAAE,IAAI,EAAE,CAAC,CAAC;qBACZ;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/test-endpoint.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerTestEndpoint(server: McpServer): void;
+//# sourceMappingURL=test-endpoint.d.ts.map

package/dist/tools/test-endpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-endpoint.d.ts","sourceRoot":"","sources":["../../src/tools/test-endpoint.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAkE5D"}

package/dist/tools/test-endpoint.js

@@ -0,0 +1,66 @@
+import { z } from 'zod';
+import { executeRequest } from '../lib/http-client.js';
+export function registerTestEndpoint(server) {
+    server.tool('test_endpoint', 'Send an HTTP request and get a structured response with status, headers, body, timing, and size. Supports GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS.', {
+        method: z.enum(['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'HEAD', 'OPTIONS']).describe('HTTP method'),
+        url: z.string().url().describe('Full URL to send the request to'),
+        headers: z.record(z.string(), z.string()).optional().describe('Request headers as key-value pairs'),
+        body: z.unknown().optional().describe('Request body (auto-serialized to JSON for objects)'),
+        timeout: z.number().min(100).max(120000).optional().describe('Request timeout in milliseconds (default: 30000, max: 120000)'),
+    }, async ({ method, url, headers, body, timeout }) => {
+        try {
+            const response = await executeRequest({
+                method,
+                url,
+                headers: headers,
+                body,
+                timeout,
+            });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            status: response.status,
+                            statusText: response.statusText,
+                            headers: response.headers,
+                            body: response.body,
+                            timing_ms: response.timing_ms,
+                            size_bytes: response.size_bytes,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            // Provide helpful error context
+            let hint = '';
+            if (message.includes('ECONNREFUSED')) {
+                hint = 'The server is not running or not accepting connections.';
+            }
+            else if (message.includes('ENOTFOUND')) {
+                hint = 'DNS lookup failed. Check the URL hostname.';
+            }
+            else if (message.includes('timeout') || message.includes('abort')) {
+                hint = 'Request timed out. Try increasing the timeout parameter.';
+            }
+            else if (message.includes('certificate')) {
+                hint = 'SSL/TLS certificate error. The server may have an invalid certificate.';
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: message,
+                            hint: hint || undefined,
+                        }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=test-endpoint.js.map

package/dist/tools/test-endpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-endpoint.js","sourceRoot":"","sources":["../../src/tools/test-endpoint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,MAAM,UAAU,oBAAoB,CAAC,MAAiB;IACpD,MAAM,CAAC,IAAI,CACT,eAAe,EACf,yJAAyJ,EACzJ;QACE,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC;QACpG,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;QACjE,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;QACnG,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oDAAoD,CAAC;QAC3F,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+DAA+D,CAAC;KAC9H,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE;QAChD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC;gBACpC,MAAM;gBACN,GAAG;gBACH,OAAO,EAAE,OAA6C;gBACtD,IAAI;gBACJ,OAAO;aACR,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,MAAM,EAAE,QAAQ,CAAC,MAAM;4BACvB,UAAU,EAAE,QAAQ,CAAC,UAAU;4BAC/B,OAAO,EAAE,QAAQ,CAAC,OAAO;4BACzB,IAAI,EAAE,QAAQ,CAAC,IAAI;4BACnB,SAAS,EAAE,QAAQ,CAAC,SAAS;4BAC7B,UAAU,EAAE,QAAQ,CAAC,UAAU;yBAChC,EAAE,IAAI,EAAE,CAAC,CAAC;qBACZ;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAEjE,gCAAgC;YAChC,IAAI,IAAI,GAAG,EAAE,CAAC;YACd,IAAI,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;gBACrC,IAAI,GAAG,yDAAyD,CAAC;YACnE,CAAC;iBAAM,IAAI,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;gBACzC,IAAI,GAAG,4CAA4C,CAAC;YACtD,CAAC;iBAAM,IAAI,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBACpE,IAAI,GAAG,0DAA0D,CAAC;YACpE,CAAC;iBAAM,IAAI,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;gBAC3C,IAAI,GAAG,wEAAwE,CAAC;YAClF,CAAC;YAED,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,KAAK,EAAE,OAAO;4BACd,IAAI,EAAE,IAAI,IAAI,SAAS;yBACxB,EAAE,IAAI,EAAE,CAAC,CAAC;qBACZ;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/validate-response.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerValidateResponse(server: McpServer): void;
+//# sourceMappingURL=validate-response.d.ts.map

package/dist/tools/validate-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-response.d.ts","sourceRoot":"","sources":["../../src/tools/validate-response.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAiDhE"}

package/dist/tools/validate-response.js

@@ -0,0 +1,44 @@
+import { z } from 'zod';
+import { validateResponse } from '../lib/schema-validator.js';
+export function registerValidateResponse(server) {
+    server.tool('validate_response', 'Validate an API response against an expected HTTP status code and optional JSON Schema. Returns validation result with detailed error messages.', {
+        response: z.object({
+            status: z.number().describe('HTTP status code from the response'),
+            body: z.unknown().describe('Response body to validate'),
+        }).describe('The API response to validate'),
+        expected_status: z.number().describe('Expected HTTP status code'),
+        expected_schema: z.unknown().optional().describe('Expected JSON Schema (draft-07) for the response body'),
+    }, async ({ response, expected_status, expected_schema }) => {
+        try {
+            const result = validateResponse(response, expected_status, expected_schema ?? undefined);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            valid: result.valid,
+                            errors: result.errors,
+                            ...(result.valid
+                                ? { message: 'Response matches expected status and schema.' }
+                                : { message: `Validation failed with ${result.errors.length} error(s).` }),
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: err instanceof Error ? err.message : String(err),
+                        }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=validate-response.js.map

package/dist/tools/validate-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-response.js","sourceRoot":"","sources":["../../src/tools/validate-response.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAE9D,MAAM,UAAU,wBAAwB,CAAC,MAAiB;IACxD,MAAM,CAAC,IAAI,CACT,mBAAmB,EACnB,iJAAiJ,EACjJ;QACE,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC;YACjB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;YACjE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;SACxD,CAAC,CAAC,QAAQ,CAAC,8BAA8B,CAAC;QAC3C,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;QACjE,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uDAAuD,CAAC;KAC1G,EACD,KAAK,EAAE,EAAE,QAAQ,EAAE,eAAe,EAAE,eAAe,EAAE,EAAE,EAAE;QACvD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,gBAAgB,CAC7B,QAA6C,EAC7C,eAAe,EACd,eAAoD,IAAI,SAAS,CACnE,CAAC;YAEF,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,KAAK,EAAE,MAAM,CAAC,KAAK;4BACnB,MAAM,EAAE,MAAM,CAAC,MAAM;4BACrB,GAAG,CAAC,MAAM,CAAC,KAAK;gCACd,CAAC,CAAC,EAAE,OAAO,EAAE,8CAA8C,EAAE;gCAC7D,CAAC,CAAC,EAAE,OAAO,EAAE,0BAA0B,MAAM,CAAC,MAAM,CAAC,MAAM,YAAY,EAAE,CAAC;yBAC7E,EAAE,IAAI,EAAE,CAAC,CAAC;qBACZ;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;yBACxD,EAAE,IAAI,EAAE,CAAC,CAAC;qBACZ;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}