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

Bookmarks Html To Csv

Convert a browser bookmarks.html export from Chrome, Firefox, Edge, Safari or any other browser that writes the Netscape bookmark format int

Csv To Bookmarks Html

Convert a CSV of links into a Netscape bookmarks.html file that Chrome, Firefox, Edge and Safari import.

Csv To Json

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

Csv To Sql

Convert CSV text into SQL INSERT statements, optionally preceded by a CREATE TABLE.

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.