Skip to content

Api Docs Generator MCP tool

MCP findutils:api_docs_generator

Return API documentation generated from a list of endpoints, as Markdown (with table of contents, request/response examples) or as an OpenAPI 3.0.3 JSON specification.

Arguments

application/json
  • title

    string optional

    API title. Default "My API".

  • version

    string optional

    API version string. Default "1.0.0".

  • base_url

    string optional

    Base URL of the API. Default "https://api.example.com".

  • description

    string optional

    Short description of the API. Default "".

  • endpoints

    array required

    Endpoints: objects with method (GET|POST|PUT|PATCH|DELETE), path, and optional summary, description, request_body (JSON text), response_example (JSON text), response_code (default "200").

  • format

    string optional

    Output format. One of markdown · openapi. Default "markdown".

Example arguments

Verified
{
  "title": "Users API",
  "endpoints": [
    {
      "method": "GET",
      "path": "/users",
      "summary": "List users",
      "response_example": {
        "users": []
      }
    }
  ],
  "format": "markdown"
}