API Docs Generator AI MCP Server

By MEOK AI Labs — Generate OpenAPI/Swagger specifications from natural language API descriptions

Installation

pip install api-docs-generator-ai-mcp

Usage

# Run standalone
python server.py

# Or via MCP
mcp install api-docs-generator-ai-mcp

Tools

generate_endpoint

Generate an OpenAPI endpoint definition from a description. Supports path parameters and request bodies.

Parameters:

• path (str): API path (e.g., '/users/{id}')
• method (str): HTTP method (get, post, put, patch, delete)
• summary (str): Endpoint summary
• request_body (str): Request body fields as 'name:type,name2:type2'
• response_description (str): Response description

generate_schema

Generate an OpenAPI schema component from field definitions.

Parameters:

• name (str): Schema name
• fields (str): Fields as 'name:type,name2:type2'

generate_full_spec

Generate a complete OpenAPI 3.0 spec with info, paths, and components.

Parameters:

• title (str): API title
• description (str): API description
• version (str): API version (default '1.0.0')
• endpoints_json (str): JSON array of endpoint objects

add_auth_to_spec

Add authentication scheme to an OpenAPI spec (bearer, api_key, basic, oauth2).

Parameters:

• spec_json (str): OpenAPI spec as JSON string
• auth_type (str): Auth type — 'bearer', 'api_key', 'basic', 'oauth2'

validate_spec

Validate an OpenAPI spec for common issues (missing fields, invalid methods, etc.).

Parameters:

• spec_json (str): OpenAPI spec as JSON string

Authentication

Free tier: 50 calls/day. Upgrade at meok.ai/pricing for unlimited access.

License

MIT — MEOK AI Labs