openapi-dynamic-mcp 0.1.0

package/dist/mcp/server.js

@@ -0,0 +1,125 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+import { getApiEndpointTool, getApiSchemaTool, listApiEndpointsTool, listApisTool, makeEndpointRequestTool } from "./tools/index.js";
+import { fail } from "./tools/common.js";
+const TOOLS = [
+    {
+        name: "list_apis",
+        description: "List configured APIs loaded from the YAML configuration.",
+        inputSchema: {
+            type: "object",
+            properties: {},
+            additionalProperties: false
+        }
+    },
+    {
+        name: "list_api_endpoints",
+        description: "List endpoints from a specific API with optional filters.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                apiName: { type: "string" },
+                method: { type: "string" },
+                tag: { type: "string" },
+                pathContains: { type: "string" },
+                limit: { type: "integer", minimum: 1 },
+                cursor: { type: "string" }
+            },
+            required: ["apiName"],
+            additionalProperties: false
+        }
+    },
+    {
+        name: "get_api_endpoint",
+        description: "Get details for one endpoint in a specific API.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                apiName: { type: "string" },
+                endpointId: { type: "string" }
+            },
+            required: ["apiName", "endpointId"],
+            additionalProperties: false
+        }
+    },
+    {
+        name: "get_api_schema",
+        description: "Get the full dereferenced API schema or a JSON pointer fragment.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                apiName: { type: "string" },
+                pointer: { type: "string" }
+            },
+            required: ["apiName"],
+            additionalProperties: false
+        }
+    },
+    {
+        name: "make_endpoint_request",
+        description: "Execute an HTTP request for an endpoint by endpointId.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                apiName: { type: "string" },
+                endpointId: { type: "string" },
+                pathParams: { type: "object" },
+                query: { type: "object" },
+                headers: { type: "object", additionalProperties: { type: "string" } },
+                cookies: { type: "object", additionalProperties: { type: "string" } },
+                body: {},
+                contentType: { type: "string" },
+                accept: { type: "string" },
+                timeoutMs: { type: "integer", minimum: 1 },
+                retry429: {
+                    type: "object",
+                    properties: {
+                        maxRetries: { type: "integer", minimum: 0 },
+                        baseDelayMs: { type: "integer", minimum: 1 },
+                        maxDelayMs: { type: "integer", minimum: 1 },
+                        jitterRatio: { type: "number", minimum: 0, maximum: 1 },
+                        respectRetryAfter: { type: "boolean" }
+                    },
+                    additionalProperties: false
+                }
+            },
+            required: ["apiName", "endpointId"],
+            additionalProperties: false
+        }
+    }
+];
+export async function startMcpServer(context) {
+    const server = new Server({
+        name: "openapi-mcp",
+        version: "0.1.0"
+    }, {
+        capabilities: {
+            tools: {}
+        }
+    });
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+        return { tools: [...TOOLS] };
+    });
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const toolName = request.params.name;
+        const args = request.params.arguments ?? {};
+        switch (toolName) {
+            case "list_apis":
+                return listApisTool(context);
+            case "list_api_endpoints":
+                return listApiEndpointsTool(context, args);
+            case "get_api_endpoint":
+                return getApiEndpointTool(context, args);
+            case "get_api_schema":
+                return getApiSchemaTool(context, args);
+            case "make_endpoint_request":
+                return makeEndpointRequestTool(context, args);
+            default:
+                return fail(new Error(`Unknown tool: ${toolName}`));
+        }
+    });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

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

package/dist/mcp/tools/common.d.ts

@@ -0,0 +1,16 @@
+import type { LoadedApi } from "../../types.js";
+import type { ToolContext } from "../context.js";
+import { z } from "zod";
+export interface ToolResult {
+    isError?: boolean;
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    structuredContent?: unknown;
+}
+export declare function ok(data: unknown): ToolResult;
+export declare function fail(error: unknown): ToolResult;
+export declare function requireApi(context: ToolContext, apiName: string): LoadedApi;
+export declare function parseInput<T extends z.ZodTypeAny>(args: unknown, schema: T): z.infer<T>;
+export declare function toStringMap(value: Record<string, unknown> | undefined | null): Record<string, string>;

package/dist/mcp/tools/common.js

@@ -0,0 +1,60 @@
+import { asErrorResponse, OpenApiMcpError } from "../../errors.js";
+export function ok(data) {
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(data, null, 2)
+            }
+        ],
+        structuredContent: data
+    };
+}
+export function fail(error) {
+    const payload = asErrorResponse(error);
+    return {
+        isError: true,
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(payload, null, 2)
+            }
+        ],
+        structuredContent: payload
+    };
+}
+export function requireApi(context, apiName) {
+    const api = context.registry.byName.get(apiName.toLowerCase());
+    if (!api) {
+        throw new OpenApiMcpError("API_NOT_FOUND", `Unknown API '${apiName}'`);
+    }
+    return api;
+}
+export function parseInput(args, schema) {
+    const parsed = schema.safeParse(args ?? {});
+    if (parsed.success) {
+        return parsed.data;
+    }
+    const issue = parsed.error.issues[0];
+    const path = issue.path.length ? issue.path.join(".") : "arguments";
+    throw new OpenApiMcpError("REQUEST_ERROR", `${path}: ${issue.message}`, {
+        issues: parsed.error.issues.map((item) => ({
+            path: item.path,
+            message: item.message
+        }))
+    });
+}
+export function toStringMap(value) {
+    if (!value) {
+        return {};
+    }
+    const out = {};
+    for (const [key, item] of Object.entries(value)) {
+        if (item === undefined || item === null) {
+            continue;
+        }
+        out[key] = String(item);
+    }
+    return out;
+}
+//# sourceMappingURL=common.js.map

package/dist/mcp/tools/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../../src/mcp/tools/common.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAWnE,MAAM,UAAU,EAAE,CAAC,IAAa;IAC9B,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;aACpC;SACF;QACD,iBAAiB,EAAE,IAAI;KACxB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,KAAc;IACjC,MAAM,OAAO,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IACvC,OAAO;QACL,OAAO,EAAE,IAAI;QACb,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;aACvC;SACF;QACD,iBAAiB,EAAE,OAAO;KAC3B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,OAAoB,EAAE,OAAe;IAC9D,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAC/D,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,eAAe,CAAC,eAAe,EAAE,gBAAgB,OAAO,GAAG,CAAC,CAAC;IACzE,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,IAAa,EACb,MAAS;IAET,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IAC5C,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC;IACpE,MAAM,IAAI,eAAe,CAAC,eAAe,EAAE,GAAG,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,EAAE;QACtE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACzC,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC,CAAC;KACJ,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,KAAiD;IAEjD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChD,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YACxC,SAAS;QACX,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/mcp/tools/getApiEndpoint.d.ts

@@ -0,0 +1,3 @@
+import type { ToolContext } from "../context.js";
+import { type ToolResult } from "./common.js";
+export declare function getApiEndpointTool(context: ToolContext, args: unknown): Promise<ToolResult>;

package/dist/mcp/tools/getApiEndpoint.js

@@ -0,0 +1,59 @@
+import { OpenApiMcpError } from "../../errors.js";
+import { z } from "zod";
+import { fail, ok, parseInput, requireApi } from "./common.js";
+const getApiEndpointInputSchema = z
+    .object({
+    apiName: z.string().min(1),
+    endpointId: z.string().min(1)
+})
+    .strict();
+export async function getApiEndpointTool(context, args) {
+    try {
+        const input = parseInput(args, getApiEndpointInputSchema);
+        const apiName = input.apiName;
+        const endpointId = input.endpointId;
+        const api = requireApi(context, apiName);
+        const endpoint = api.endpointById.get(endpointId);
+        if (!endpoint) {
+            throw new OpenApiMcpError("ENDPOINT_NOT_FOUND", `Unknown endpoint '${endpointId}'`, {
+                apiName
+            });
+        }
+        const parameters = [...(endpoint.pathItem.parameters ?? []), ...(endpoint.operation.parameters ?? [])]
+            .filter((item) => !("$ref" in item))
+            .map((param) => ({
+            name: param.name,
+            in: param.in,
+            required: param.required ?? false,
+            description: param.description,
+            style: param.style,
+            explode: param.explode,
+            schema: param.schema
+        }));
+        const requestContentTypes = Object.keys(endpoint.operation.requestBody && "$ref" in endpoint.operation.requestBody
+            ? {}
+            : endpoint.operation.requestBody?.content ?? {});
+        return ok({
+            endpointId: endpoint.endpointId,
+            method: endpoint.method,
+            path: endpoint.path,
+            operationId: endpoint.operationId,
+            summary: endpoint.summary,
+            description: endpoint.description,
+            tags: endpoint.tags ?? [],
+            parameters,
+            requestBody: {
+                required: endpoint.operation.requestBody && !("$ref" in endpoint.operation.requestBody)
+                    ? endpoint.operation.requestBody.required ?? false
+                    : false,
+                contentTypes: requestContentTypes
+            },
+            responses: endpoint.operation.responses,
+            security: endpoint.operation.security ?? api.schema.security ?? []
+        });
+    }
+    catch (error) {
+        return fail(error);
+    }
+}
+//# sourceMappingURL=getApiEndpoint.js.map

package/dist/mcp/tools/getApiEndpoint.js.map

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

package/dist/mcp/tools/getApiSchema.d.ts

@@ -0,0 +1,3 @@
+import type { ToolContext } from "../context.js";
+import { type ToolResult } from "./common.js";
+export declare function getApiSchemaTool(context: ToolContext, args: unknown): Promise<ToolResult>;

package/dist/mcp/tools/getApiSchema.js

@@ -0,0 +1,27 @@
+import { getByJsonPointer } from "../../openapi/jsonPointer.js";
+import { z } from "zod";
+import { fail, ok, parseInput, requireApi } from "./common.js";
+const getApiSchemaInputSchema = z
+    .object({
+    apiName: z.string().min(1),
+    pointer: z.string().optional()
+})
+    .strict();
+export async function getApiSchemaTool(context, args) {
+    try {
+        const input = parseInput(args, getApiSchemaInputSchema);
+        const apiName = input.apiName;
+        const pointer = input.pointer;
+        const api = requireApi(context, apiName);
+        const schema = getByJsonPointer(api.schema, pointer);
+        return ok({
+            apiName: api.config.name,
+            pointer: pointer ?? "",
+            schema
+        });
+    }
+    catch (error) {
+        return fail(error);
+    }
+}
+//# sourceMappingURL=getApiSchema.js.map

package/dist/mcp/tools/getApiSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getApiSchema.js","sourceRoot":"","sources":["../../../src/mcp/tools/getApiSchema.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,UAAU,EAAE,UAAU,EAAmB,MAAM,aAAa,CAAC;AAEhF,MAAM,uBAAuB,GAAG,CAAC;KAC9B,MAAM,CAAC;IACN,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC/B,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAAoB,EAAE,IAAa;IACxE,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,EAAE,uBAAuB,CAAC,CAAC;QACxD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QAC9B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QAE9B,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,gBAAgB,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAErD,OAAO,EAAE,CAAC;YACR,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI;YACxB,OAAO,EAAE,OAAO,IAAI,EAAE;YACtB,MAAM;SACP,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,5 @@
+export { getApiEndpointTool } from "./getApiEndpoint.js";
+export { getApiSchemaTool } from "./getApiSchema.js";
+export { listApiEndpointsTool } from "./listApiEndpoints.js";
+export { listApisTool } from "./listApis.js";
+export { makeEndpointRequestTool } from "./makeEndpointRequest.js";

package/dist/mcp/tools/index.js

@@ -0,0 +1,6 @@
+export { getApiEndpointTool } from "./getApiEndpoint.js";
+export { getApiSchemaTool } from "./getApiSchema.js";
+export { listApiEndpointsTool } from "./listApiEndpoints.js";
+export { listApisTool } from "./listApis.js";
+export { makeEndpointRequestTool } from "./makeEndpointRequest.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mcp/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/mcp/tools/listApiEndpoints.d.ts

@@ -0,0 +1,3 @@
+import type { ToolContext } from "../context.js";
+import { type ToolResult } from "./common.js";
+export declare function listApiEndpointsTool(context: ToolContext, args: unknown): Promise<ToolResult>;

package/dist/mcp/tools/listApiEndpoints.js

@@ -0,0 +1,55 @@
+import { z } from "zod";
+import { fail, ok, parseInput, requireApi } from "./common.js";
+const listApiEndpointsInputSchema = z
+    .object({
+    apiName: z.string().min(1),
+    method: z.string().optional(),
+    tag: z.string().optional(),
+    pathContains: z.string().optional(),
+    limit: z.number().int().positive().optional(),
+    cursor: z.string().optional()
+})
+    .strict();
+export async function listApiEndpointsTool(context, args) {
+    try {
+        const input = parseInput(args, listApiEndpointsInputSchema);
+        const api = requireApi(context, input.apiName);
+        const methodFilter = input.method?.toLowerCase();
+        const tagFilter = input.tag;
+        const pathContains = input.pathContains;
+        const limit = Math.min(input.limit ?? 50, 200);
+        const offset = typeof input.cursor === "string" && input.cursor.trim()
+            ? Number.parseInt(input.cursor, 10)
+            : 0;
+        const filtered = api.endpoints.filter((endpoint) => {
+            if (methodFilter && endpoint.method !== methodFilter) {
+                return false;
+            }
+            if (tagFilter && !(endpoint.tags ?? []).includes(tagFilter)) {
+                return false;
+            }
+            if (pathContains && !endpoint.path.includes(pathContains)) {
+                return false;
+            }
+            return true;
+        });
+        const safeOffset = Number.isFinite(offset) && offset >= 0 ? offset : 0;
+        const paged = filtered.slice(safeOffset, safeOffset + limit);
+        const nextOffset = safeOffset + paged.length;
+        return ok({
+            endpoints: paged.map((endpoint) => ({
+                endpointId: endpoint.endpointId,
+                method: endpoint.method,
+                path: endpoint.path,
+                operationId: endpoint.operationId,
+                summary: endpoint.summary,
+                tags: endpoint.tags ?? []
+            })),
+            nextCursor: nextOffset < filtered.length ? String(nextOffset) : undefined
+        });
+    }
+    catch (error) {
+        return fail(error);
+    }
+}
+//# sourceMappingURL=listApiEndpoints.js.map

package/dist/mcp/tools/listApiEndpoints.js.map

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

package/dist/mcp/tools/listApis.d.ts

@@ -0,0 +1,3 @@
+import type { ToolContext } from "../context.js";
+import { type ToolResult } from "./common.js";
+export declare function listApisTool(context: ToolContext): Promise<ToolResult>;

package/dist/mcp/tools/listApis.js

@@ -0,0 +1,18 @@
+import { fail, ok } from "./common.js";
+export async function listApisTool(context) {
+    try {
+        const apis = [...context.registry.byName.values()].map((api) => ({
+            name: api.config.name,
+            title: api.schema.info?.title,
+            version: api.schema.info?.version,
+            baseUrl: api.baseUrl,
+            specPath: api.schemaPath,
+            authSchemes: api.authSchemeNames
+        }));
+        return ok({ apis });
+    }
+    catch (error) {
+        return fail(error);
+    }
+}
+//# sourceMappingURL=listApis.js.map

package/dist/mcp/tools/listApis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listApis.js","sourceRoot":"","sources":["../../../src/mcp/tools/listApis.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,EAAE,EAAmB,MAAM,aAAa,CAAC;AAExD,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAoB;IACrD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YAC/D,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI;YACrB,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK;YAC7B,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO;YACjC,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,QAAQ,EAAE,GAAG,CAAC,UAAU;YACxB,WAAW,EAAE,GAAG,CAAC,eAAe;SACjC,CAAC,CAAC,CAAC;QAEJ,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IACtB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;AACH,CAAC"}

package/dist/mcp/tools/makeEndpointRequest.d.ts

@@ -0,0 +1,3 @@
+import type { ToolContext } from "../context.js";
+import { type ToolResult } from "./common.js";
+export declare function makeEndpointRequestTool(context: ToolContext, args: unknown): Promise<ToolResult>;

package/dist/mcp/tools/makeEndpointRequest.js

@@ -0,0 +1,63 @@
+import { executeEndpointRequest } from "../../http/requestExecutor.js";
+import { OpenApiMcpError } from "../../errors.js";
+import { z } from "zod";
+import { fail, ok, parseInput, requireApi, toStringMap } from "./common.js";
+const makeEndpointRequestInputSchema = z
+    .object({
+    apiName: z.string().min(1),
+    endpointId: z.string().min(1),
+    pathParams: z.record(z.unknown()).nullable().optional(),
+    query: z.record(z.unknown()).nullable().optional(),
+    headers: z.record(z.unknown()).nullable().optional(),
+    cookies: z.record(z.unknown()).nullable().optional(),
+    body: z.unknown().optional(),
+    contentType: z.string().optional(),
+    accept: z.string().optional(),
+    timeoutMs: z.number().int().positive().optional(),
+    retry429: z
+        .object({
+        maxRetries: z.number().int().nonnegative().optional(),
+        baseDelayMs: z.number().int().positive().optional(),
+        maxDelayMs: z.number().int().positive().optional(),
+        jitterRatio: z.number().min(0).max(1).optional(),
+        respectRetryAfter: z.boolean().optional()
+    })
+        .strict()
+        .nullable()
+        .optional()
+})
+    .strict();
+export async function makeEndpointRequestTool(context, args) {
+    try {
+        const input = parseInput(args, makeEndpointRequestInputSchema);
+        const apiName = input.apiName;
+        const endpointId = input.endpointId;
+        const api = requireApi(context, apiName);
+        const endpoint = api.endpointById.get(endpointId);
+        if (!endpoint) {
+            throw new OpenApiMcpError("ENDPOINT_NOT_FOUND", `Unknown endpoint '${endpointId}'`, {
+                apiName
+            });
+        }
+        const result = await executeEndpointRequest({
+            api,
+            endpoint,
+            pathParams: input.pathParams ?? {},
+            query: input.query ?? {},
+            headers: toStringMap(input.headers),
+            cookies: toStringMap(input.cookies),
+            body: input.body,
+            contentType: input.contentType,
+            accept: input.accept,
+            timeoutMs: input.timeoutMs,
+            retry429: input.retry429 ?? undefined,
+            oauthClient: context.oauthClient,
+            env: context.env
+        });
+        return ok(result);
+    }
+    catch (error) {
+        return fail(error);
+    }
+}
+//# sourceMappingURL=makeEndpointRequest.js.map

package/dist/mcp/tools/makeEndpointRequest.js.map

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

package/dist/openapi/endpointIndex.d.ts

@@ -0,0 +1,6 @@
+import type { OpenAPIV3 } from "openapi-types";
+import type { EndpointDefinition } from "../types.js";
+export declare function buildEndpointIndex(document: OpenAPIV3.Document): {
+    endpoints: EndpointDefinition[];
+    endpointById: Map<string, EndpointDefinition>;
+};

package/dist/openapi/endpointIndex.js

@@ -0,0 +1,75 @@
+import { OpenApiMcpError } from "../errors.js";
+const METHODS = [
+    "get",
+    "put",
+    "post",
+    "delete",
+    "options",
+    "head",
+    "patch",
+    "trace"
+];
+function normalizePathForId(path) {
+    return path.replace(/\s+/g, "").replace(/\/+$/, "") || "/";
+}
+export function buildEndpointIndex(document) {
+    const paths = document.paths ?? {};
+    const opIdCounts = new Map();
+    for (const path of Object.keys(paths)) {
+        const item = paths[path];
+        if (!item) {
+            continue;
+        }
+        for (const method of METHODS) {
+            const op = item[method];
+            if (op?.operationId) {
+                opIdCounts.set(op.operationId, (opIdCounts.get(op.operationId) ?? 0) + 1);
+            }
+        }
+    }
+    const endpoints = [];
+    const endpointById = new Map();
+    for (const path of Object.keys(paths)) {
+        const pathItem = paths[path];
+        if (!pathItem) {
+            continue;
+        }
+        for (const method of METHODS) {
+            const operation = pathItem[method];
+            if (!operation) {
+                continue;
+            }
+            const uniqueOpId = operation.operationId && opIdCounts.get(operation.operationId) === 1
+                ? operation.operationId
+                : undefined;
+            const endpointId = uniqueOpId ?? `${method.toUpperCase()} ${normalizePathForId(path)}`;
+            const endpoint = {
+                endpointId,
+                method,
+                path,
+                operationId: operation.operationId,
+                summary: operation.summary,
+                description: operation.description,
+                tags: operation.tags,
+                operation,
+                pathItem: pathItem
+            };
+            if (endpointById.has(endpointId)) {
+                throw new OpenApiMcpError("SCHEMA_ERROR", `Endpoint ID collision for '${endpointId}'`, {
+                    path,
+                    method
+                });
+            }
+            endpointById.set(endpointId, endpoint);
+            endpoints.push(endpoint);
+        }
+    }
+    endpoints.sort((a, b) => {
+        if (a.path === b.path) {
+            return a.method.localeCompare(b.method);
+        }
+        return a.path.localeCompare(b.path);
+    });
+    return { endpoints, endpointById };
+}
+//# sourceMappingURL=endpointIndex.js.map

package/dist/openapi/endpointIndex.js.map

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

package/dist/openapi/jsonPointer.d.ts

@@ -0,0 +1 @@
+export declare function getByJsonPointer(root: unknown, pointer?: string): unknown;