Compute Flesch Reading Ease and Flesch-Kincaid Grade Level for a block of English text.

Use this to check how easy your own draft output (a reply, a document, documentation) will be for a reader to understand before sending it -- useful for agents that want to self-check plain-language quality, or for comparing readability across different drafts.

Args:

• text (string, 1-20000 chars): The text to score.

• response_format ('markdown' | 'json'): Output format (default: 'markdown').

Returns: For JSON format: { "supported": boolean, // false if the text contains non-Latin script (Flesch formulas assume English) "fleschReadingEase": number|null, // 0-100, higher = easier; null if unsupported or no words found "fleschKincaidGradeLevel": number|null, // approximate US school grade level "gradeLevelLabel": string|null, // human description, e.g. "standard (around 8th-9th grade)" "sentenceCount": number, "wordCount": number, "syllableCount": number, "avgWordsPerSentence": number, "avgSyllablesPerWord": number }

Examples:

• Use when: "Is this support-ticket reply easy enough to understand?" -> score the reply text

• Use when: "Which of these two drafts reads more simply?" -> score both, compare fleschReadingEase

• Don't use when: the text is not primarily English -- scoring is skipped for non-Latin script and only structural counts are returned

Error Handling:

• Returns an error if text is empty or exceeds 20000 characters (split long documents into sections first).

Rewrite English text in plainer language: breaks overly long sentences at natural clause boundaries and swaps common bureaucratic vocabulary ("utilize" -> "use", "prior to" -> "before") for plainer equivalents. Also reports the Flesch Reading Ease score before and after, so you can confirm the rewrite actually helped.

Use this before sending a reply, document, or notice to a user who may benefit from plainer language -- including as a self-check step for an agent's own drafted output.

Args:

• text (string, 1-20000 chars): The English text to simplify.

• response_format ('markdown' | 'json'): Output format (default: 'markdown').

Returns: For JSON format: { "supported": boolean, // false if text contains non-Latin script (English-only feature); simplifiedText equals the input unchanged in that case "simplifiedText": string, "changeCount": number, // total words/phrases substituted "changes": [ { "start": number, "end": number, "original": string, "simplified": string } ], // offsets index into simplifiedText "truncated": boolean, // true if changeCount exceeds 50 (only the first 50 are listed) "fleschReadingEaseBefore": number|null, "fleschReadingEaseAfter": number|null }

Examples:

• Use when: "Make this notice easier to read" -> pass the notice text

• Use when: checking whether your own drafted reply is needlessly complex before sending it

• Don't use when: the text is not primarily English -- word substitution is skipped for non-Latin script (Arabic morphology in particular makes naive word-swapping unreliable) and the text is returned unchanged, with supported=false

Error Handling:

• Returns an error if text is empty or exceeds 20000 characters.