Swagger/OpenAPI MCP Server

Implementation Reference

• src/index.ts:309-329 (registration)

  Registration of the 'list_apis' tool using this.server.tool(), including empty input schema {} and inline handler function.

    "list_apis",
    {},
    async () => {
      const apiList = Array.from(this.apis.entries()).map(([id, api]) => ({
        id,
        title: api.spec.info?.title || id,
        version: api.spec.info?.version,
        description: api.spec.info?.description,
        pathCount: Object.keys(api.spec.paths || {}).length
      }));
  
      return {
        content: [{
          type: "text",
          text: apiList.length > 0 
            ? JSON.stringify(apiList, null, 2)
            : "No APIs loaded. Use the load_api tool to load an API specification."
        }]
      };
    }
  );

• src/index.ts:312-328 (handler)

  The handler function that executes the list_apis tool logic: iterates over loaded APIs, formats a list with id, title, version, description, pathCount, and returns as JSON or a message if none loaded.

    const apiList = Array.from(this.apis.entries()).map(([id, api]) => ({
      id,
      title: api.spec.info?.title || id,
      version: api.spec.info?.version,
      description: api.spec.info?.description,
      pathCount: Object.keys(api.spec.paths || {}).length
    }));
  
    return {
      content: [{
        type: "text",
        text: apiList.length > 0 
          ? JSON.stringify(apiList, null, 2)
          : "No APIs loaded. Use the load_api tool to load an API specification."
      }]
    };
  }