Back to Projects

api2mcp

Standalone TypeScript npm package that converts API specifications into working MCP servers, exposing any documented API as MCP tools. Forms a core component of the PlugFit platform, published independently for reuse.

Architecture Overview

TypeScript library that parses API specs and generates MCP server definitions with per-endpoint tool mappings; a core piece of PlugFit, also published standalone to npm.

Key Challenges

Handling inconsistent and incomplete API specs while producing valid, usable MCP tool schemas.

Security Considerations

Input validation and safe handling of untrusted spec definitions.

Future Improvements

Future work includes broader spec-format support and auto-generated auth handling.

Technical Impact

  • Built and published a standalone TypeScript npm package (@swayam5342/api2mcp) that transforms API specs into runnable MCP servers.
  • Developed it as a core component of the PlugFit platform, published independently for reuse.
  • Designed a spec-parsing and tool-generation pipeline mapping API endpoints to MCP tool definitions.