Score text readability (Flesch, FK Grade, SMOG, ARI) with improvement suggestions via mcp-readability — passive voice, complex words, long sentences

{
  "server": "mcp-readability",
  "version": "latest",
  "transport": "stdio",
  "install": "npm install mcp-readability",
  "run": "node node_modules/mcp-readability/dist/index.js",
  "tools": ["analyze_readability"],
  "calls": [
    {
      "tool": "analyze_readability",
      "input": {
        "text": "The cat sat on the mat. It was a good day. The sun was warm and bright.",
        "include_suggestions": true
      },
      "output": {
        "scores": {
          "flesch_reading_ease": 116.5,
          "flesch_kincaid_grade": -1.6,
          "smog_index": 3,
          "ari": -4.2
        },
        "reading_level": "Elementary (under 6th grade)",
        "audience": "General public / young readers",
        "stats": {
          "word_count": 17,
          "sentence_count": 3,
          "syllable_count": 17
        },
        "suggestions": ["No major readability issues found — text looks good for the target audience."]
      },
      "ms": 2
    },
    {
      "tool": "analyze_readability",
      "input": {
        "text": "The epistemological ramifications of post-structuralist deconstructionism necessitate a fundamental reconceptualization...",
        "include_suggestions": true
      },
      "output": {
        "scores": {
          "flesch_reading_ease": -105.1,
          "flesch_kincaid_grade": 37.1,
          "smog_index": 29.3,
          "ari": 38.4
        },
        "reading_level": "Graduate (17th grade+)",
        "suggestions": ["1 sentence exceeds 25 words", "10 words have 5+ syllables"]
      },
      "ms": 1
    },
    {
      "tool": "analyze_readability",
      "input": {
        "text": "The agreement shall be terminated by either party...",
        "include_suggestions": true
      },
      "output": {
        "scores": {
          "flesch_reading_ease": 33.4,
          "flesch_kincaid_grade": 11.7
        },
        "reading_level": "High School (9th–12th grade)",
        "suggestions": ["4 passive voice instances detected — prefer active voice where possible. Examples: "be terminated", "be maintained", "be resolved""]
      },
      "ms": 0
    },
    {
      "tool": "analyze_readability",
      "input": {
        "text": "Hello.",
        "include_suggestions": true
      },
      "output": {
        "scores": {
          "flesch_reading_ease": 36.6,
          "flesch_kincaid_grade": 8.4
        },
        "reading_level": "Middle School (6th–8th grade)",
        "stats": {
          "word_count": 1,
          "sentence_count": 1
        }
      },
      "ms": 0,
      "note": "single-word edge case — formula degenerates, misleading grade level"
    }
  ],
  "success_rate": "8/8 (100%)",
  "p50_ms": 0.5
}