# Api Docs Generator — REST API endpoint `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.

- Category: data
- MCP server: https://mcp.findutils.com/ (Streamable HTTP, no API keys, 120 req/min per IP)
- REST endpoint: POST https://api.findutils.com/api/tools/api-docs-generator/execute (no API keys, 60 req/min per IP)
- Reference page: https://findutils.com/api/api-docs-generator/
- Same tool on the other surface: https://findutils.com/mcp/api-docs-generator/

## Call the endpoint (verified example)

```bash
curl -X POST https://api.findutils.com/api/tools/api-docs-generator/execute \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Users API",
    "endpoints": [
      {
        "method": "GET",
        "path": "/users",
        "summary": "List users",
        "response_example": "{\"users\": []}"
      }
    ],
    "format": "markdown"
  }'

# Parameter schema
curl https://api.findutils.com/api/tools/api-docs-generator
```

## Input schema

| Argument | Type | Required | Description |
|---|---|---|---|
| `title` | string | no | API title. Default: `"My API"`. |
| `version` | string | no | API version string. Default: `"1.0.0"`. |
| `base_url` | string | no | Base URL of the API. Default: `"https://api.example.com"`. |
| `description` | string | no | Short description of the API. Default: `""`. |
| `endpoints` | array | yes | 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 (markdown \| openapi) | no | Output format. Default: `"markdown"`. |

Example arguments (verified):

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

OpenAPI 3.1 spec: https://findutils.com/api/openapi.json · Interactive docs: https://findutils.com/api/docs/

## Also an MCP tool

```bash
claude mcp add findutils --transport http https://mcp.findutils.com/
```

Then ask the client to call `findutils:api_docs_generator`. Full MCP reference: https://findutils.com/mcp/api-docs-generator/

---
Full catalog: GET https://api.findutils.com/api/tools · https://findutils.com/api/ · https://findutils.com/llms.txt