readability-scorer Connector for AI agents.
3 live capabilities
Get mathematically precise Flesch-Kincaid and Gunning Fog scores for your content.
Waiting for input…
Why people use readability-scorer
Fix AI Hallucinations with Deterministic Readability Scorer Content Analysis
This Connector changes the workflow by using a Javascript engine to do the actual math. Instead of guessing, your agent gets a precise score every time. You get a reliable audit of your work in seconds.
What Vinkius changes
You get mathematically perfect readability data instead of AI hallucinations.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Blog Optimization
An editor asks the agent to check if a 1,000-word post is readable for a 10th-grade audience to ensure it stays accessible.
- Real-world use case 02
Legal Simplification
A lawyer wants to know which sections of a contract are too complex for a layperson to understand using the Gunning Fog Index.
- Real-world use case 03
Newsletter Planning
A marketer checks the estimated reading time of a weekly update to ensure it stays under two minutes for mobile users.
Complete set · 3capabilities
The complete readability-scorer capability set.
These are the exact actions your AI can choose when you ask it to work with readability-scorer.
01—03
3 capabilities in this set.
Part of 3 available through readability-scorer.
- 01 Capability
Calculate flesch kincaid
Provides the Flesch-Kincaid Reading Ease and Grade Level scores for a given text string. It uses math to ensure the result is consistent every time.
- 02 Capability
Calculate gunning fog
Calculates the Gunning Fog Index to measure the complexity of your content. It identifies how many complex words are in your writing.
- 03 Capability
Calculate reading time
Returns an exact reading time estimation based on your specified words per minute. It gives you a precise count in minutes and seconds.
Set up in minutes
One URL. Then ask readability-scorer to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use readability-scorer from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_xn51InkPXPF6UvzWpq82RMb2AMpXMdXdY0wxIUyC/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it readability-scorer, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable readability-scorer for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_xn51InkPXPF6UvzWpq82RMb2AMpXMdXdY0wxIUyC/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the readability-scorer URL.
- Step 03
Save and start
Save the connection and enable readability-scorer in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"deterministic-readability-scorer": {
"url": "https://edge.vinkius.com/vk_preview_xn51InkPXPF6UvzWpq82RMb2AMpXMdXdY0wxIUyC/mcp"
}
}
} - Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using readability-scorer
Open Agent mode in chat and ask: "Using readability-scorer, help me...". 3 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"deterministic-readability-scorer": {
"url": "https://edge.vinkius.com/vk_preview_xn51InkPXPF6UvzWpq82RMb2AMpXMdXdY0wxIUyC/mcp"
}
}
} - Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using readability-scorer
Ask Copilot: "Using readability-scorer, help me...". 3 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"deterministic-readability-scorer": {
"url": "https://edge.vinkius.com/vk_preview_xn51InkPXPF6UvzWpq82RMb2AMpXMdXdY0wxIUyC/mcp"
}
}
} - Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using readability-scorer
Open Cascade and ask: "Using readability-scorer, help me...". 3 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"deterministic-readability-scorer": {
"url": "https://edge.vinkius.com/vk_preview_xn51InkPXPF6UvzWpq82RMb2AMpXMdXdY0wxIUyC/mcp"
}
}
} - Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using readability-scorer
Ask Cline: "Using readability-scorer, help me...". 3 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add deterministic-readability-scorer --transport http "https://edge.vinkius.com/vk_preview_xn51InkPXPF6UvzWpq82RMb2AMpXMdXdY0wxIUyC/mcp" - Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using readability-scorer
Ask Claude: "Using readability-scorer, show me...". 3 tools are ready
Where the request belongs
Work readability-scorer can move forward.
Content editors, SEO managers, and UX writers who need to move beyond 'vibes' and into hard data. It is for anyone whose job depends on making sure a message is actually understood by the right audience.
Content Editor
Checking if a blog post hits the right audience level on a Tuesday afternoon.
SEO Manager
Ensuring meta descriptions and headers stay within readability limits for search ranking.
UX Writer
Verifying that app copy is simple enough for quick scanning by non-technical users.
Technical Writer
Simplifying complex documentation for non-expert users to improve support tickets.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsText Readability Scorer
Calculate mathematically accurate readability metrics (Flesch-Kincaid, Gunning Fog, SMOG) for any text. Stop relying on AI 'feelings'. get exact US grade levels for SEO and compliance.
Readability Score Analyzer
Analyze text complexity using standard linguistic formulas like Flesch-Kincaid and SMOG.
Cognitive Load Scorer
Quantify the mental effort required to process text by measuring linguistic complexity.
Legal Plain Language Scorer
Analyze legal text for readability, syntax complexity, and defined term consistency.
Readability & SEO Scorer
Audit text for SEO performance using Flesch-Kincaid, sentence density, and passive voice analysis.
Sentence Rhythm Analyzer
Analyze prose rhythm, sentence length variance, and structural scannability.
Bring your own AI
Change the model, client or framework. Keep readability-scorer connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about readability-scorer.
The practical details behind the request, access and result.
Can the Deterministic Readability Scorer give me a grade level?
Yes, it uses the Flesch-Kincaid algorithm to provide a mathematically accurate grade level score for any text you provide.
How does it avoid AI hallucinations?
It doesn't rely on the LLM's memory or patterns. It routes your text through a Javascript engine that performs actual math on the characters.
Can I change the reading speed for the time estimate?
Yes, you can specify a custom Words Per Minute (WPM) count to get a reading time that fits your specific audience.
Is this good for SEO?
Absolutely. It helps you ensure your content is accessible and readable, which are key factors for keeping users engaged on your site.
What is the Gunning Fog Index?
It is a readability test that estimates the years of education needed to understand a text. It specifically looks at sentence length and complex words.
Does this work for very long documents?
Yes, you can provide long strings of text, and the Connector will process them to give you the total scores for the entire piece.
Why do AI models fail at calculating readability scores?
Readability formulas require knowing the exact number of phonetic syllables. LLMs process text in semantic tokens (e.g., 'unbelievable' might be 2 tokens, but it has 5 syllables). They cannot count syllables accurately, making algorithmic capabilities mandatory.
Does it support multiple languages?
The syllable counting heuristic is highly optimized for English, which is the baseline for Flesch-Kincaid. However, the reading time and basic word/sentence extraction work flawlessly across all Latin-script languages.
Are there any external library dependencies?
No. We utilize a custom Regular Expression syllable engine built natively into the TypeScript architecture, achieving 0ms latency processing without downloading external NLP packages.
One connection away
Give your agent a direct line to readability-scorer.
Connect readability-scorer once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available