openapi 3.0+ specification parsing and dereferencing
Parses and fully dereferences OpenAPI 3.0+ specifications using @apidevtools/swagger-parser, resolving all $ref pointers and external schema definitions into a unified in-memory representation. Handles both local file paths and remote URLs, normalizing the specification structure for downstream tool extraction and validation schema generation.
Unique: Uses @apidevtools/swagger-parser for full dereferencing with automatic $ref resolution, rather than naive regex-based reference handling, ensuring complex nested schemas and external definitions are correctly flattened into a single canonical representation
vs alternatives: More robust than manual OpenAPI parsing because it handles recursive $refs, external schema files, and circular references automatically, whereas custom parsers often fail on complex real-world APIs
rest api operation extraction to mcp tool definitions
Converts OpenAPI paths and operations into McpToolDefinition[] array by extracting operation metadata (operationId, summary, description), parameter schemas, request/response bodies, and HTTP method details. Maps REST semantics (path params, query params, headers, request bodies) to MCP tool input schemas with proper categorization and naming conventions.
Unique: Implements extractToolsFromApi() function that maps REST operation semantics directly to MCP tool contracts, preserving parameter types, required fields, and descriptions in a single pass, rather than requiring manual tool definition or separate schema transformation steps
vs alternatives: Faster and more accurate than manual tool definition because it automatically extracts all operation metadata from OpenAPI in one pass, whereas manual approaches require developers to re-specify each parameter and description
rest api request proxying with axios http client
Proxies validated MCP tool calls to target REST APIs using axios HTTP client, handling request construction (method, URL, headers, body), response parsing, and error handling. Automatically constructs URLs from OpenAPI path templates and parameters, injects authentication headers, and returns API responses to MCP clients with appropriate status code and body mapping.
Unique: Uses axios to construct and execute HTTP requests based on OpenAPI operation definitions, automatically mapping MCP tool inputs to REST parameters (path, query, body) and handling response parsing, whereas manual proxying requires explicit URL construction and header management
vs alternatives: More maintainable than manual HTTP construction because URL templates, parameter mapping, and headers are derived from OpenAPI definitions, reducing the risk of mismatches between spec and implementation
typescript type definitions and schema export for generated code
Exports McpToolDefinition type and other type definitions for use in generated code and programmatic API, providing TypeScript type safety for tool definitions, input schemas, and configuration objects. Type definitions are included in the generated project's tsconfig.json and enable IDE autocomplete and compile-time type checking.
Unique: Generates and exports McpToolDefinition type alongside code, enabling type-safe programmatic API usage and IDE support in generated projects, whereas many generators only produce untyped JavaScript output
vs alternatives: More developer-friendly than untyped code because TypeScript type checking catches errors at compile time and IDEs provide autocomplete, whereas untyped approaches require runtime testing to catch type mismatches
generated project dependency management and package.json configuration
Generates package.json with all required runtime dependencies (@modelcontextprotocol/sdk, axios, zod, Hono for web/HTTP transports) and development dependencies (TypeScript, @types packages), with pinned versions for reproducibility. Includes scripts for building, running, and testing the generated server, making the project immediately deployable with npm install && npm start.
Unique: Generates transport-specific package.json with only required dependencies (e.g., Hono only for web/HTTP transports, not for stdio), reducing bundle size and dependency bloat compared to generators that include all optional dependencies
vs alternatives: More efficient than monolithic dependency lists because transport-specific dependencies are only included when needed, whereas generic generators include all possible dependencies regardless of transport mode
json schema to zod validation schema code generation
Transforms OpenAPI JSON Schema definitions into executable Zod validation code via json-schema-to-zod library integration. Generates TypeScript code strings that define Zod schemas for request/response validation, handling type mappings (string, number, boolean, object, array), constraints (minLength, maxLength, pattern, enum), and nested object structures.
Unique: Leverages json-schema-to-zod library to automatically transpile JSON Schema constraints into Zod validation code, enabling runtime type checking without manual schema duplication, whereas most generators either skip validation or require hand-written schemas
vs alternatives: More maintainable than manual Zod schema writing because schema definitions stay in OpenAPI and are auto-generated, reducing drift between API documentation and validation logic
multi-transport mcp server code generation (stdio, sse, http)
Generates complete TypeScript MCP server implementations supporting three transport modes: stdio (standard input/output for local processes), SSE (Server-Sent Events via Hono web server for browser clients), and streamable-http (HTTP with streaming responses via Hono). Each transport generates transport-specific entry points (index.ts for stdio, web-server.ts for SSE, streamable-http.ts for HTTP) with appropriate request/response handling and dependency injection.
Unique: Generates transport-specific entry points from a single OpenAPI spec, with Hono-based web/HTTP servers and native stdio support, allowing the same API to be deployed as a CLI tool, web service, or HTTP endpoint without code duplication
vs alternatives: More flexible than single-transport generators because it supports three distinct deployment models from one spec, whereas most MCP generators only support stdio or require manual transport layer implementation
openapi x-mcp extension filtering for selective tool exposure
Parses and respects the x-mcp OpenAPI extension to selectively include or exclude operations from MCP tool generation. Allows API developers to annotate operations with x-mcp: {enabled: false} to hide internal or deprecated endpoints from MCP exposure, providing fine-grained control over which REST operations become MCP tools without modifying the OpenAPI spec structure.
Unique: Implements custom x-mcp OpenAPI extension for declarative operation filtering, allowing API specs to define MCP visibility inline without external configuration files, whereas most generators expose all operations or require separate allowlist/blocklist files
vs alternatives: More maintainable than external filtering configs because visibility rules stay in the OpenAPI spec alongside operation definitions, reducing configuration drift and making intent explicit to API maintainers
+5 more capabilities