• SCORE
  • LEVEL
  • AUDIENCE
  • HUMAN

How to audit text readability with your AI

Connect this MCP to your AI client once. From there, you can run readability checks on any text you paste or any file you provide.

Ask AI about this page

Short answer

How can I check if my writing is too hard to read?

Your AI uses the calculate_readability tool to generate a Flesch-Kincaid score for your text. This score tells you exactly how difficult your writing is for your specific audience. You'll see the breakdown of how the AI processes your text below.

The results you get.

Where your data lands.

The AI processes your text and hands you these specific outcomes.

SCORE

Flesch-Kincaid score

The AI runs calculate_readability to give you a numerical grade. This number represents the reading ease of your content.

LEVEL

Target grade level

The tool translates the score into a standard grade level. You'll know if you're writing for a middle schooler or a PhD.

AUDIENCE

Accessibility check

The AI compares your score against your intended reader profile. This tells you if your message will actually land with your users.

HUMAN

Manual rewrite needed

The AI identifies where the score is too high. You'll need to step in and simplify those specific sentences yourself.

The workflow

What your AI does when text arrives.

The AI handles the math so you can focus on the message.

  1. Analyze text

    Your AI takes the raw text you provide and prepares it for the scoring engine.

    calculate_readability

  2. Calculate score

    The agent invokes the tool to run the Flesch-Kincaid formula on your words.

    calculate_readability

  3. Determine grade

    The AI converts the raw data into a readable grade level for your report.

    calculate_readability

  4. Report findings

    The AI presents the final score and grade level directly in your chat interface.

    calculate_readability

Try it

Copy these to start.

Paste these into your chat to trigger the tool.

Starting points

These are basic ways to start. Swap out the bracketed text for your actual content.

Readability SEO Scorer Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_WiIQBtWG2XXtbfQrp50ggwByPvAHzwBxJQ1QjjSM/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Readability SEO Scorer capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "readability-seo-scorer-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_WiIQBtWG2XXtbfQrp50ggwByPvAHzwBxJQ1QjjSM/mcp"
    }
  }
}
Copy into chat04

  • Calculate the readability score for this paragraph: [paste text here]

  • Check the Flesch-Kincaid grade level for my latest blog post: [paste text here]

  • Is this technical documentation too difficult for a general audience? [paste text here]

  • Run a readability audit on the content in this file: [attach file]

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Readability & SEO Scorer once, then ask.

Click the link to connect the MCP to your client. Your credentials stay encrypted, and you can start auditing text immediately.

Connect Readability & SEO Scorer to your AI

FAQ

How the tool behaves

  • 01

    Can the AI rewrite my text to be easier to read?

    No. The tool only calculates the score and grade level. You must perform the actual rewriting yourself.

  • 02

    Does the AI change my original document?

    No. The tool only reads the text you provide to generate a score. It does not modify your files.

  • 03

    What grade level is considered 'good'?

    It depends on your audience. A technical manual might need a higher grade, while a marketing email should be much lower.

  • 04

    Can I use this with Claude or Cursor?

    Yes. Any MCP-compatible client can use this once you connect it through Vinkius.

  • 05

    Does it work on long documents?

    Yes, as long as you provide the text or the file to your AI client.

  • More questions about Readability & SEO Scorer? The Connector page answers them. See everything the Readability & SEO Scorer Connector can do

Connect Readability SEO Scorer to Claude, Cursor, ChatGPT & more