cyberneticlibrary
← library

Generate MCP servers from OpenAPI specs

generate-mcpcommandsetup L3★1
Darshitpandya/api-lifecycle-devex-ax ↗
What it does

Generate MCP server config from intent-enriched OpenAPI spec

Best for

API teams needing low-friction MCP tool exposure for agents without manual tool definition boilerplate.

Inputs
  • · OpenAPI spec with x-capability annotations
  • · Path to spec (ask if not provided)
Outputs
  • · MCP tool definitions (operationId → name/description/inputSchema)
  • · MCP server config JSON
  • · Registration instructions (Claude Desktop, Kiro, agent framework)
Requires
  • · OpenAPI parser
  • · MCP config schema
Preconditions
  • · Spec has x-capability on every operation
  • · Mapping guide (03-agent-bridge/mapping-guide.md) exists
Failure modes
  • · Spec missing x-capability — directs user to /make-api-agent-ready first
  • · Malformed OpenAPI — parser fails (ask for spec validation)
  • · operationId not unique — MCP config ambiguous (flag as error)
Trust signals
  • · Prerequisite check (x-capability) prevents garbage output
  • · Reuses mapping guide (single source of truth for naming patterns)
  • · Produces registration instructions (not just JSON)