This section provides guidelines on how to create high-quality OpenAPI specifications for use with the OpenEdge MCP Server. Following these guidelines ensures that the MCP tools generated from your specifications are clean, intuitive, and predictable. High-quality specifications provide the following benefits:
  • Clear tool names and arguments derived from operationId, parameters, and request body schemas
  • Accurate input validation possibilities
  • Helpful tool descriptions that improve agent reasoning
  • Reduced ambiguity in downstream integration