api2ai: Optimizing MCP Tools Beyond OpenAPI Specifications

annette_dorothea · reddit · 2026-08-12

A developer discovered that generating MCP servers directly from OpenAPI specifications is suboptimal, as API descriptions are written for human developers rather than AI agents.

To solve this, the author open-sourced api2ai. It treats MCP tool creation as a curation problem: developers can explicitly select specific API operations to become tools and enrich them with AI-specific metadata, descriptions, and examples, while still using OpenAPI as the source of truth. Built with Langium, the project also includes a VS Code / Cursor extension.

Original post →

More from coding & agent

coding & agent channel →