openapi-tool-scaffold

Generate Python MCP stdio server code from OpenAPI 3.x specifications.

1|Updated Jan 31, 2026
One-click install
npx skills add https://github.com/kjaylee/misskim-skills --skill openapi-tool-scaffold
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openapi-tool-scaffold
Source: https://github.com/kjaylee/misskim-skills/tree/main/skills/openapi-tool-scaffold
Command: npx skills add https://github.com/kjaylee/misskim-skills --skill openapi-tool-scaffold

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires PyYAML, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill automates the conversion of OpenAPI 3.x specifications into executable Python MCP stdio server code, significantly reducing the manual effort and potential errors involved in integrating external REST APIs.

Core Features & Use Cases

  • OpenAPI to MCP Conversion: Automatically generates Python MCP server code from OpenAPI 3.x JSON or YAML specifications.
  • Endpoint to Tool Mapping: Transforms REST API endpoints into callable MCP tools.
  • Authentication Handling: Supports common authentication schemes (Bearer, API Key, OAuth stub) by reading environment variables.
  • Use Case: Quickly create MCP tools for a new external microservice by simply providing its OpenAPI specification, enabling seamless integration into your existing agentic workflows.

Quick Start

Use the openapi-tool-scaffold skill to convert the OpenAPI specification at 'https://petstore3.swagger.io/api/v3/openapi.json' into a Python MCP server file named 'petstore-mcp-server.py'.

Frequently Asked Questions about openapi-tool-scaffold

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate Python MCP server code from an OpenAPI specification?

Generate Python MCP server code from OpenAPI 3.x specifications by parsing JSON or YAML inputs to automatically create callable MCP tools for each REST API endpoint. This automated conversion significantly reduces manual coding effort and integration errors.

How does OpenAPI to MCP tool conversion handle REST API authentication?

OpenAPI to MCP tool conversion handles REST API authentication by mapping common schemes like Bearer tokens and API Keys to environment variables. This approach securely injects credentials at runtime without hardcoding sensitive information into the generated server code.

Can I use a YAML OpenAPI spec to create callable MCP tools?

Yes, you can create callable MCP tools from a YAML OpenAPI spec. The parser natively supports both JSON and YAML input formats, transforming REST API endpoints into executable Python functions while correctly mapping parameters and request bodies.

What Python version is required for running an MCP stdio server generated from OpenAPI?

Python 3.10 or higher is required for running an MCP stdio server generated from OpenAPI. The code generation focuses on modern Python compatibility and relies on minimal external dependencies, primarily requiring PyYAML for parsing.

What's the best way to automate MCP tool creation for external REST APIs?

The best way to automate MCP tool creation for external REST APIs is providing an OpenAPI 3.x document to a code generation script. It instantly scaffolds a Python MCP stdio server, translating endpoints and parameters into ready-to-use tools for agentic workflows.