Skip to content
HALOWERK

Denkwerk

tool description lint

Runs deterministic rules over tool definitions in any common format: description missing, too short (<40 characters) or too long (>1024), vague verbs without an object, parameters without description, generic parameter names such as data/input/value, enums without explanation, negated boolean names, inconsistent name style and duplicate names. Returns findings per tool and a score from 0 to 100.

POST https://denk.halowerk.com/v1/tool-description-lint

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
toolsarrayYesTool definitions in OpenAI, OpenAI Responses, Anthropic, Gemini or MCP format (mixed allowed).
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "tools"
  ],
  "properties": {
    "tools": {
      "type": "array",
      "minItems": 1,
      "maxItems": 128,
      "items": {
        "type": "object"
      },
      "description": "Tool definitions in OpenAI, OpenAI Responses, Anthropic, Gemini or MCP format (mixed allowed)."
    }
  }
}

Open original schema

Published input example

{
  "tools": [
    {
      "name": "process",
      "description": "Handles data.",
      "input_schema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "string"
          }
        }
      }
    }
  ]
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub โ†’