Api Docs Generator API

POST https://api.findutils.com/api/tools/api-docs-generator/execute

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.

Open the tool Try it

Request body

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"
}

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"
  }'

const response = await fetch('https://api.findutils.com/api/tools/api-docs-generator/execute', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({"title":"Users API","endpoints":[{"method":"GET","path":"/users","summary":"List users","response_example":"{\"users\": []}"}],"format":"markdown"}),
});
const data = await response.json();

import requests

response = requests.post(
    "https://api.findutils.com/api/tools/api-docs-generator/execute",
    json={"title":"Users API","endpoints":[{"method":"GET","path":"/users","summary":"List users","response_example":"{\"users\": []}"}],"format":"markdown"},
)
data = response.json()

$ch = curl_init('https://api.findutils.com/api/tools/api-docs-generator/execute');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => '{"title":"Users API","endpoints":[{"method":"GET","path":"/users","summary":"List users","response_example":"{\"users\": []}"}],"format":"markdown"}',
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

Also an MCP tool

Call api_docs_generator from Claude, Cursor or any MCP client. Same arguments, same output.

https://mcp.findutils.com

MCP reference

Rate limit: 60 a minute, per IP
Auth: None
REST id: api-docs-generator
MCP name: api_docs_generator
Category: Data
Machine-readable: openapi.json · markdown.md

Request body

Example arguments

More Data tools

More to explore