skills.rest
speakeasy-api
speakeasy-apiOFFICIAL
Explore all skills by this author →
Website𝕏@speakeasydevGitHub

generate-mcp-server

Generate an MCP server from an OpenAPI specification using Speakeasy CLI.

19|6|Updated Jan 23, 2026
Search Tags:#automation#MCP#OpenAPI#AI integration#SDK generation#CLI workflow
One-click install
npx skills add https://github.com/speakeasy-api/skills --skill generate-mcp-server
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: generate-mcp-server
Source: https://github.com/speakeasy-api/skills/tree/main/skills/generate-mcp-server
Command: npx skills add https://github.com/speakeasy-api/skills --skill generate-mcp-server

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Generate an MCP server from an OpenAPI spec to expose API operations as AI-callable tools for agents like Claude.

Core Features & Use Cases

  • Generate an MCP server from an API described by OpenAPI spec.
  • Expose API operations as tools for AI assistants and automated workflows.
  • Workflow-based generation with overlays, CLI, Docker support, and deployment.

Quick Start

To generate an MCP server, prepare an OpenAPI spec and follow the step-by-step workflow described in this skill. Create a scopes overlay, configure .speakeasy/workflow.yaml, set up .speakeasy/gen.yaml, and run speakeasy run.

Frequently Asked Questions about generate-mcp-server

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

FAQPage Schema
How do I generate an MCP server from an OpenAPI spec?▼

To generate an MCP server from an OpenAPI spec, configure the .speakeasy workflow with enableMCPServer enabled, set up gen.yaml, and run speakeasy CLI to expose API operations as AI-callable tools.

What is an MCP server used for in AI integration?▼

An MCP server exposes API operations as AI-callable tools for agents like Claude, enabling automated workflows and AI-assisted API integration directly from an OpenAPI specification.

Do I need Speakeasy CLI to create an MCP server from OpenAPI?▼

Yes, generating an MCP server requires the Speakeasy CLI alongside a valid OpenAPI spec and an overlay workflow configured with enableMCPServer to execute the generation process.

Can I deploy an MCP server using Docker after generating it from OpenAPI?▼

Yes, the MCP server generation workflow supports Docker and deployment configurations, allowing you to containerize and run the AI-callable tools created from your OpenAPI specification.

How do overlays work when generating MCP servers from OpenAPI specs?▼

Overlays work within the .speakeasy workflow configuration to customize and control the generation of your MCP server, ensuring the OpenAPI spec operations are accurately exposed as AI-callable tools.

Related Skills

Explore More Software Engineering Skills→
speakeasy-apispeakeasy-api
19

manage-openapi-overlays

Create, apply, and validate OpenAPI overlays using the speakeasy CLI.

Official
Intermediate
githubnextgithubnext
4.9k

copilot-cli

Automate coding workflows via GitHub Copilot CLI with MCP server configuration.

Official
Intermediate
speakeasy-apispeakeasy-api
19

generate-terraform-provider

Generate a Terraform provider from an OpenAPI spec using the Speakeasy CLI.

Official
Advanced
berea-chberea-ch

generate-mcp-server

Generate an MCP server from an OpenAPI specification using the Speakeasy CLI.

Official
Advanced