Analyze text readability (Flesch, FK Grade, SMOG, ARI) with improvement suggestions via mcp-readability (npx)

{
  "server": "mcp-readability",
  "version": "latest",
  "transport": "stdio",
  "install": "npm install --prefix /tmp/mcp-readability mcp-readability",
  "entry": "node_modules/mcp-readability/dist/index.js",
  "tools": ["analyze_readability"],
  "calls": [
    {
      "tool": "analyze_readability",
      "args": {
        "text": "The cat sat on the mat. It was a warm day. The sun was bright. Birds sang in the trees. Children played in the park.",
        "include_suggestions": true
      },
      "result": {
        "scores": {
          "flesch_reading_ease": 113.8,
          "flesch_kincaid_grade": -1.4,
          "smog_index": 3,
          "ari": -2.5
        },
        "reading_level": "Elementary (under 6th grade)",
        "audience": "General public / young readers",
        "stats": {
          "word_count": 25,
          "sentence_count": 5,
          "syllable_count": 26,
          "avg_words_per_sentence": 5,
          "avg_syllables_per_word": 1.04
        },
        "suggestions": ["No major readability issues found — text looks good for the target audience."]
      },
      "ms": 2
    },
    {
      "tool": "analyze_readability",
      "args": {
        "text": "The epistemological ramifications of quantum decoherence in macroscopic thermodynamic systems necessitate a comprehensive reevaluation of established phenomenological frameworks.",
        "include_suggestions": true
      },
      "result": {
        "scores": {
          "flesch_reading_ease": -95.5,
          "flesch_kincaid_grade": 30.9,
          "smog_index": 21.2,
          "ari": 29.6
        },
        "reading_level": "Graduate (17th grade+)",
        "audience": "Graduate students / specialists",
        "stats": {
          "word_count": 52,
          "sentence_count": 3,
          "syllable_count": 175,
          "avg_words_per_sentence": 17.3,
          "avg_syllables_per_word": 3.37
        },
        "suggestions": ["16 words have 5+ syllables — consider simpler alternatives: epistemological, ramifications, thermodynamic, phenomenological, heteroscedasticity"]
      },
      "ms": 1
    },
    {
      "tool": "analyze_readability",
      "args": {
        "text": "To install the package, run npm install in your terminal. The server starts on port 3000 by default.",
        "include_suggestions": true
      },
      "result": {
        "scores": {
          "flesch_reading_ease": 68.4,
          "flesch_kincaid_grade": 6.1,
          "smog_index": 7.9,
          "ari": 5.4
        },
        "reading_level": "Middle School (6th–8th grade)",
        "audience": "Middle school students",
        "stats": {
          "word_count": 48,
          "sentence_count": 5
        },
        "suggestions": ["1 passive voice instance detected — prefer active voice where possible. Examples: "is stored""]
      },
      "ms": 1
    },
    {
      "tool": "analyze_readability",
      "args": {
        "text": "The quick brown fox jumps over the lazy dog.",
        "include_suggestions": false
      },
      "result": {
        "scores": {
          "flesch_reading_ease": 79.5,
          "flesch_kincaid_grade": 4.5,
          "smog_index": 7.5,
          "ari": 4.4
        },
        "reading_level": "Elementary (under 6th grade)"
      },
      "ms": 0
    },
    {
      "tool": "analyze_readability",
      "args": {
        "text": "Hello world.",
        "include_suggestions": true
      },
      "result": {
        "scores": {
          "flesch_reading_ease": 77.9,
          "flesch_kincaid_grade": 2.9,
          "smog_index": 3,
          "ari": 3.1
        },
        "reading_level": "Elementary (under 6th grade)",
        "suggestions": ["No major readability issues found — text looks good for the target audience."]
      },
      "ms": 1
    },
    {
      "tool": "analyze_readability",
      "args": {
        "text": "The report was written by the committee. The decision was made yesterday. The results were analyzed by the team.",
        "include_suggestions": true
      },
      "result": {
        "scores": {
          "flesch_reading_ease": 64.1,
          "flesch_kincaid_grade": 5.9,
          "smog_index": 9,
          "ari": 4.6
        },
        "reading_level": "Middle School (6th–8th grade)",
        "suggestions": ["4 passive voice instances detected — prefer active voice where possible. Examples: "was written", "were analyzed", "was completed""]
      },
      "ms": 0
    }
  ],
  "success_rate": "6/6 (100%)",
  "p50_ms": 1
}