Api Docs Generator

Data REST API MCP

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.

This page documents the HTTP endpoint POST /api/tools/api-docs-generator/execute. See the MCP reference →

Use in the browser View as Markdown

Call it over REST

POST https://api.findutils.com/api/tools/api-docs-generator/execute · no API keys · 60 requests/min per IP

Execute — verified arguments

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 for this endpoint

curl https://api.findutils.com/api/tools/api-docs-generator

Interactive docs · OpenAPI 3.1 spec · All REST tools

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)

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

Arguments that carry JSON as a string are shown decoded for readability. The Copy button copies the exact wire arguments.

Also an MCP tool

Claude, Cursor, and any MCP client can call this tool as findutils:api_docs_generator after one connect command.

Connect once

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

Open the MCP reference for Api Docs Generator →

More Data tools

Csv To Json

Parse CSV text into an array of objects keyed by the header row.

Graphql To Typescript

Convert a GraphQL SDL schema into TypeScript type definitions and return the generated code with counts of emitted types, enums, and inputs.

Html Table To Json

Convert an HTML <table> into JSON — an array of objects keyed by the header row, or an array of row arrays.

Jq Playground

Returns the result of running a jq-style filter over a JSON document.

Json Comparer

Returns a git-style line diff of two JSON documents after both are pretty-printed with 2-space indentation.

Json Diff

Returns the semantic differences between two JSON documents as a list of added, removed and modified paths with their old and new values, pl

Json Faker

Returns an array of fake JSON records built from a field list, for testing and prototyping.

Json Flatten

Flatten a nested JSON object into a single-level map with dot-separated keys.