# Readability & SEO Scorer MCP

> Readability & SEO Scorer audits text structure, ensuring your content hits both search engine requirements and human readability marks. This MCP calculates Flesch-Kincaid scores, flags 'walls of text' from overly long sentences or paragraphs, and analyzes writing style to catch passive voice usage. It helps you write copy that ranks well while actually being easy for a reader to digest.

## Overview
- **Category:** seo
- **Price:** Free
- **Tags:** readability, seo, content-audit, text-analysis, flesch-kincaid

## Description

Your content needs to do two things: rank highly in search results and sound natural when people read it. This MCP checks both boxes automatically. It gives you a clear score showing how accessible your text is, using the Flesch-Kincaid Reading Ease method. But scoring isn't enough; sometimes your writing is just too dense. We use a tool to identify those structural issues—the paragraphs and sentences that feel overwhelming to read. Plus, it checks for passive voice, helping you strip out filler words so your message hits hard. Connecting this MCP via Vinkius gives your AI agent immediate access to these three critical quality checks, meaning every piece of copy passes through a professional editorial filter before publication.

## Tools

### audit_density
Checks text structure for overly long sentences or paragraphs that hurt user engagement.

### calculate_readability
Calculates the Flesch-Kincaid score to measure how easy your writing is to read.

### analyze_style
Finds passive voice usage and gives you a breakdown of your overall writing style.

## Prompt Examples

**Prompt:** 
```
What is the readability score of this text: 'The quick brown fox jumps over the lazy dog.'
```

**Response:** 
```
The reading ease score for the provided text is 105.2, which falls into the 'very easy' complexity level.
```

**Prompt:** 
```
Check this paragraph for structural density issues: 'This is a very long sentence that contains many words in order to test if the density audit tool can correctly identify it as a long sentence during the analysis process.'
```

**Response:** 
```
The audit identified 1 structural alert: The sentence exceeds the default word count threshold of 20 words.
```

**Prompt:** 
```
Analyze this text for passive voice: 'The cake was eaten by the boy.'
```

**Response:** 
```
Detected 1 instance of passive voice. Suggestion: Use active voice, e.g., 'The boy ate the cake.'
```

## Capabilities

### Assess reading difficulty
Get an objective Flesch-Kincaid score that tells you how easily your target audience can understand the text.

### Identify structural density problems
Flags excessively long sentences or huge paragraphs, preventing user drop-off from 'walls of text'.

### Improve writing voice and flow
Detects instances of passive voice to make your prose direct and engaging.

## Use Cases

### A B2B company needs to overhaul its product documentation.
The technical writer pastes the manual section and runs `analyze_style`. The agent finds dozens of passive voice instances, allowing the writer to quickly revise vague sentences into active, clear instructions. This dramatically improves the overall tone.

### An SEO team is launching a new cornerstone guide.
The content strategist runs `calculate_readability` and finds the score is too high (too complex). They then use `audit_density` to break up long paragraphs, resulting in clearer, more digestible chunks of text for search engines.

### A marketing team needs quick social media copy reviews.
The marketer runs the tool on a draft post. It flags that the sentences are too lengthy and dense. They revise it to be punchy and short, ensuring maximum impact for limited online attention spans.

## Benefits

- Boost search performance by ensuring your content passes structural checks. The `audit_density` tool flags those 'walls of text' that make users bail out immediately.
- Know exactly who you’re talking to. The `calculate_readability` tool provides a concrete score, letting you tailor the complexity for your ideal reader.
- Make your writing sound authoritative and direct. Use `analyze_style` to quickly pinpoint passive voice and turn weak phrasing into strong statements.
- Save time on manual reviews. Instead of running three different checks in three separate platforms, this MCP bundles everything into one audit.
- Increase conversion rates. Readable content keeps users engaged longer. This helps you maintain a high score across all metrics.

## How It Works

The bottom line is you get an instant, three-part editorial audit that tells you exactly what needs fixing before your content goes live.

1. Paste the text you want reviewed into your AI client.
2. Select the appropriate scoring or analysis tool (readability, density, or style) within the MCP interface.
3. The system runs the check and returns a detailed report identifying specific scores, structural alerts, or voice issues.

## Frequently Asked Questions

**How does `calculate_readability` work?**
It uses the Flesch-Kincaid formula to score text difficulty. A higher score means the content is easier for a general audience to read and understand.

**What does `audit_density` look for?**
`audit_density` specifically flags sections that are too long, meaning they create 'walls of text' that frustrate readers and lower engagement rates.

**How can I fix passive voice using `analyze_style`?**
The tool doesn't rewrite the content for you. Instead, it highlights every instance of passive voice, giving you a suggestion on how to switch to active voice, making your writing punchier.

**Do I need all three tools together?**
Yes. The three metrics—readability, density, and style—are interdependent. Using them together gives the most accurate picture of content quality for both search engines and readers.

**If I need to audit a large document using all three tools, is there a recommended way to handle performance with `calculate_readability`, `audit_density`, and `analyze_style`?**
You can submit the text in batches via your AI client. The MCP handles concurrent execution of all tools efficiently. If you're processing thousands of words, monitor for rate limit warnings from Vinkius.

**What happens if I run `analyze_style` on a passage that is already direct and uses no passive voice?**
The tool will return zero detection alerts. This doesn't mean the text is perfect; it just means the current analysis couldn't find any specific instances of passive construction.

**When I use `audit_density`, does Vinkius retain my original source material after the audit is complete?**
No. The MCP processes your text in real time and only returns the analysis results. Your original content data isn't stored or retained by Vinkius.

**If I receive an error when calling `calculate_readability`, what are the most common causes?**
Errors usually stem from providing non-string input, like a null value or an image. Ensure that you're only passing clean text strings to the function.