{"success":true,"version":"v1","request":{"tool":"get_calculator_schema","calculator_id":"reading-level"},"result":{"entity_type":"calculator","id":"reading-level","calculator_id":"reading-level","canonical_url":"https://tttkmbb.com/everyday/reading-level","name":"Reading Level Calculator","title":"Reading Level Calculator – Flesch Reading Ease, Flesch–Kincaid Grade, Gunning Fog, Coleman–Liau and ARI","category":"everyday","category_name":"Everyday Life","tool_name":"estimate_reading_level","featured_mcp_tool":false,"description":"Counts the words, sentences, syllables and letters of an English text and computes five readability scores (Flesch Reading Ease, Flesch–Kincaid grade, Gunning fog index, Coleman–Liau index, Automated Readability Index) plus their average US grade level.","use_when":"You want to know how hard a passage is to read, which school grade it targets, or need to compare drafts for plain-language editing.","do_not_use_when":"The text is not English (syllable and formula constants are English-specific), is under about 100 words (scores are unstable), or you only need reading time (use reading-time).","inputs":[{"name":"text","label":"Text","type":"string","required":true,"description":"The passage to analyse (up to 20,000 characters). Sentences end at . ! or ? followed by a space.","example":"The cat sat on the mat. It was a sunny day and the children played outside until dinner."}],"outputs":[{"name":"word_count","label":"Words","type":"integer","decimals":4,"description":"Whitespace-separated tokens containing a letter or digit."},{"name":"sentence_count","label":"Sentences","type":"integer","decimals":4,"description":"Segments ending in . ! or ? (minimum 1)."},{"name":"syllable_count","label":"Syllables","type":"integer","decimals":4,"description":"Estimated with a vowel-group heuristic."},{"name":"complex_word_count","label":"Complex words","type":"integer","decimals":4,"description":"Words with three or more syllables (Gunning fog)."},{"name":"words_per_sentence","label":"Words per sentence","type":"number","decimals":2,"description":"word_count / sentence_count."},{"name":"syllables_per_word","label":"Syllables per word","type":"number","decimals":3,"description":"syllable_count / word_count."},{"name":"flesch_reading_ease","label":"Flesch Reading Ease","type":"number","decimals":2,"description":"0–100 scale; higher is easier (60–70 is plain English)."},{"name":"flesch_reading_ease_label","label":"Reading ease","type":"string","decimals":4,"description":"Flesch's descriptive band for the score."},{"name":"flesch_kincaid_grade","label":"Flesch–Kincaid grade","type":"number","decimals":2,"description":"US school grade level."},{"name":"gunning_fog","label":"Gunning fog index","type":"number","decimals":2,"description":"Years of formal education needed."},{"name":"coleman_liau","label":"Coleman–Liau index","type":"number","decimals":2,"description":"Grade level from letters and sentences per 100 words."},{"name":"ari","label":"Automated Readability Index","type":"number","decimals":2,"description":"Grade level from characters per word and words per sentence."},{"name":"average_grade","label":"Average grade level","type":"number","decimals":2,"description":"Mean of the four grade-level indices."},{"name":"audience","label":"Audience","type":"string","decimals":4,"description":"Schooling band for the average grade."}],"input_schema":{"type":"object","properties":{"text":{"description":"The passage to analyse (up to 20,000 characters). Sentences end at . ! or ? followed by a space.","type":"string","examples":["The cat sat on the mat. It was a sunny day and the children played outside until dinner."]}},"additionalProperties":false,"required":["text"]},"output_schema":{"type":"object","properties":{"word_count":{"description":"Whitespace-separated tokens containing a letter or digit.","type":"integer"},"sentence_count":{"description":"Segments ending in . ! or ? (minimum 1).","type":"integer"},"syllable_count":{"description":"Estimated with a vowel-group heuristic.","type":"integer"},"complex_word_count":{"description":"Words with three or more syllables (Gunning fog).","type":"integer"},"words_per_sentence":{"description":"word_count / sentence_count.","type":"number"},"syllables_per_word":{"description":"syllable_count / word_count.","type":"number"},"flesch_reading_ease":{"description":"0–100 scale; higher is easier (60–70 is plain English).","type":"number"},"flesch_reading_ease_label":{"description":"Flesch's descriptive band for the score.","type":"string"},"flesch_kincaid_grade":{"description":"US school grade level.","type":"number"},"gunning_fog":{"description":"Years of formal education needed.","type":"number"},"coleman_liau":{"description":"Grade level from letters and sentences per 100 words.","type":"number"},"ari":{"description":"Grade level from characters per word and words per sentence.","type":"number"},"average_grade":{"description":"Mean of the four grade-level indices.","type":"number"},"audience":{"description":"Schooling band for the average grade.","type":"string"}}},"formula":"FRE = 206.835 − 1.015 × (words / sentences) − 84.6 × (syllables / words); FK grade = 0.39 × (words / sentences) + 11.8 × (syllables / words) − 15.59; Fog = 0.4 × [(words / sentences) + 100 × (complex_words / words)]; Coleman–Liau = 0.0588 × L − 0.296 × S − 15.8 with L = letters per 100 words and S = sentences per 100 words; ARI = 4.71 × (letters + digits) / words + 0.5 × words / sentences − 21.43; average_grade = mean(FK, Fog, Coleman–Liau, ARI)","method":"Syllables are estimated by counting vowel groups (a, e, i, o, u, y) and subtracting a silent final -e, -ed or -es under common spelling rules; complex words are simply those with three or more estimated syllables (the strict fog definition also excludes proper nouns and compound words). Expect ±1 grade versus manual counts.","sources":[{"name":"Flesch–Kincaid readability tests (Wikipedia)","url":"https://en.wikipedia.org/wiki/Flesch%E2%80%93Kincaid_readability_tests","type":"reference","retrieved_at":"2026-09-24"},{"name":"Gunning fog index (Wikipedia)","url":"https://en.wikipedia.org/wiki/Gunning_fog_index","type":"reference","retrieved_at":"2026-09-24"},{"name":"Coleman–Liau index and Automated readability index (Wikipedia)","url":"https://en.wikipedia.org/wiki/Coleman%E2%80%93Liau_index","type":"reference","retrieved_at":"2026-09-24"}],"freshness":{"type":"static","max_age_seconds":null,"note":"Deterministic formula with fixed constants; results never go stale. Inputs supplied by the caller determine the output."},"examples":[{"name":"Two simple sentences (18 words, 23 syllables)","inputs":{"text":"The cat sat on the mat. It was a sunny day and the children played outside until dinner."},"expected":{"word_count":18,"sentence_count":2,"syllable_count":23,"complex_word_count":0,"words_per_sentence":9,"syllables_per_word":1.278,"flesch_reading_ease":89.6,"flesch_reading_ease_label":"Easy","flesch_kincaid_grade":3,"gunning_fog":3.6,"coleman_liau":3.45,"ari":1.13,"average_grade":2.79,"audience":"Elementary school"},"url":"https://tttkmbb.com/api/v1/calculate/reading-level?text=The+cat+sat+on+the+mat.+It+was+a+sunny+day+and+the+children+played+outside+until+dinner."},{"name":"Two technical sentences (22 words, 45 syllables)","inputs":{"text":"Readability formulas estimate the education level needed to understand a document. They rely on sentence length and syllable counts rather than meaning."},"expected":{"word_count":22,"sentence_count":2,"syllable_count":45,"complex_word_count":7,"flesch_reading_ease":22.62,"flesch_reading_ease_label":"Very difficult","flesch_kincaid_grade":12.84,"gunning_fog":17.13,"coleman_liau":15.99,"ari":11.69,"average_grade":14.41,"audience":"College"},"url":"https://tttkmbb.com/api/v1/calculate/reading-level?text=Readability+formulas+estimate+the+education+level+needed+to+understand+a+document.+They+rely+on+sentence+length+and+syllable+counts+rather+than+meaning."}],"faq":[{"q":"Why do the indices disagree?","a":"They weight different proxies: Flesch–Kincaid and fog use syllables, Coleman–Liau and ARI use letters per word. Differences of 2–3 grades on short texts are normal; the average is a fairer single figure."},{"q":"What score should I aim for?","a":"Plain-language guidance for the general public is Flesch Reading Ease 60 or higher and grade 8 or below; legal and academic texts often score 30–50 (college level)."},{"q":"Do abbreviations break sentence counting?","a":"Yes: 'e.g. ' or 'Dr. ' followed by a space ends a sentence. Remove the periods from abbreviations for an accurate count."}],"tags":["readability calculator","flesch kincaid grade level","reading ease score","gunning fog index","text grade level"],"related":[{"calculator_id":"reading-time","reason":"How long the same text takes to read."},{"calculator_id":"typing-speed","reason":"Words per minute for typing."}],"links":{"html":"https://tttkmbb.com/everyday/reading-level","markdown":"https://tttkmbb.com/everyday/reading-level.md","json":"https://tttkmbb.com/everyday/reading-level.json","api":"https://tttkmbb.com/api/v1/calculate/reading-level","schema":"https://tttkmbb.com/api/v1/calculators/reading-level","openapi":"https://tttkmbb.com/openapi.json","mcp":"https://tttkmbb.com/mcp"},"version":"v1","updated_at":"2026-09-24"},"timestamp":"2026-09-24T01:58:30Z","next_actions":[{"tool":"run_calculator","calculator_id":"reading-level","reason":"Run Reading Level Calculator with the inputs above."}],"links":{"markdown":"https://tttkmbb.com/everyday/reading-level.md"}}