# Content Length Scorer MCP

> Content Length Scorer analyzes your writing against industry standards for content types. It tells you if micro-copy, standard descriptions, or pillar posts are too short, too long, or just right for their intended purpose.

## Overview
- **Category:** seo
- **Price:** Free
- **Tags:** word-count, seo-optimization, copywriting, content-analysis, text-metrics

## Description

Writing copy that hits the mark isn't just about what you say; it's about how much you say. This MCP evaluates your text against established word count boundaries based on whether the content is meant to be a quick callout, a detailed landing page section, or a long-form blog post. You can first run through all available categories using this service and then check specific texts. The system reveals if your copy falls below minimum requirements, hits the sweet spot, or runs way over. This deep analysis lets you know exactly what range you need to target before writing a single word. By connecting via Vinkius, you get access to industry-vetted metrics for every type of content.

## Tools

### analyze_content_compliance
Checks if a specific block of text meets the length rules for its intended purpose.

### get_type_thresholds
Retrieves the exact minimum and maximum word count targets for any given content category.

### list_supported_intents
Provides a full list of every content type that this scorer can analyze.

## Prompt Examples

**Prompt:** 
```
Is this text optimal for a micro content type: 'Welcome to our new store!'?
```

**Response:** 
```
The word count is 6. For the micro category, this falls within the optimal range.
```

**Prompt:** 
```
Check if a 500-word blog post is too long for the pillar category.
```

**Response:** 
```
A 500-word count for a pillar content type is classified as BELOW the optimal range.
```

**Prompt:** 
```
What are the word count boundaries for standard content?
```

**Response:** 
```
For the standard content type, the optimal range is between 50 and 250 words.
```

## Capabilities

### Identify supported content formats
View a list of all defined categories the scorer can evaluate your copy against.

### Determine required word counts
Get the specific minimum and maximum word count range for any selected content type.

### Check text compliance status
Run a piece of writing through the system to see if its current length is optimal, too short, or excessive.

## Use Cases

### The short product description is failing conversion rates.
A marketing specialist needs to update a dozen product pages quickly. They use `list_supported_intents` to verify 'standard descriptions' are supported, then run the existing copy through `analyze_content_compliance`. The system flags them all as 'BELOW', guiding the team on exactly how many more words they need.

### Writing a long-form guide for SEO that feels thin.
A technical writer is building a pillar post. They first use `get_type_thresholds` to find out the optimal range for 'pillar blog posts.' When they run their draft through `analyze_content_compliance`, it confirms the document is significantly below target, prompting them to expand key sections.

### Creating micro-copy that feels too wordy.
A UX designer needs copy for a new checkout flow. They check the optimal range using `get_type_thresholds` for 'micro-copy.' When they run their initial draft through, the system flags it as 'EXCESSIVE,' forcing them to cut jargon and get punchier.

### Vetting a new content pillar against old guidelines.
A team lead wants to make sure all new guides are compliant. They use `list_supported_intents` to confirm the type, then feed the draft into `analyze_content_compliance`. The tool gives an immediate grade (BELOW/OPTIMAL/EXCESSIVE) against established best practices.

## Benefits

- Stops you from publishing content that's too brief. By using `analyze_content_compliance`, your agent immediately flags text as 'BELOW' optimal standards, so you know exactly what needs padding or expansion.
- Saves time by automating guideline checks. Instead of looking up word count rules in a spreadsheet, use `get_type_thresholds` to pull the precise min/max words for any content type instantly.
- Eliminates guesswork about content types. You can run through all available categories using `list_supported_intents` to build your workflow playbook before you even start writing.
- Ensures consistency across platforms. Whether it's a tiny button or a huge pillar post, this MCP keeps your brand voice hitting the right length every time.
- Reduces back-and-forth revisions. Knowing the technical boundaries upfront means your drafts are closer to final quality on the first pass.

## How It Works

The bottom line is you stop guessing about length and start writing only within proven boundaries.

1. First, list all supported content types to confirm your category (e.g., 'micro-copy' or 'pillar post').
2. Next, retrieve the specific target word count range for that selected type.
3. Finally, input your text and run it through the compliance check to get a pass/fail status.

## Frequently Asked Questions

**How does `analyze_content_compliance` work?**
`analyze_content_compliance` takes your text and tells you if it's 'BELOW,' 'OPTIMAL,' or 'EXCESSIVE' compared to the rules for its intended content type.

**What do I use `get_type_thresholds` for?**
Use `get_type_thresholds` when you need precise data. It pulls the minimum and maximum word count numbers for a specific category, like 'micro-copy.'

**Do I need to use `list_supported_intents` first?**
It's smart to check with `list_supported_intents` first. It shows you every content type the system recognizes, preventing errors if your content is niche.

**`analyze_content_compliance` vs. manual checking, what's better?**
The MCP approach is better because it combines all steps into one check. You get a single compliance grade instead of just a raw word count number.

**If I use `analyze_content_compliance` with text exceeding 5,000 words, what happens?**
The tool will return a specific input size error. The response body includes documentation detailing the maximum token limit and suggesting you split the content into smaller chunks for analysis.

**What error message should I expect if `get_type_thresholds` receives an unsupported category name?**
You'll receive a clear validation failure. The response body tells you exactly which parameters are mandatory and cross-references the valid options available via `list_supported_intents`.

**Are there rate limits when calling `analyze_content_compliance` repeatedly?**
Yes, Vinkius enforces standard usage limits. The API response includes a header that shows the exact time you can call the tool again to prevent throttling issues.

**When integrating this MCP, how does `list_supported_intents` help with setup?**
It provides an exhaustive list of all usable content types. You use these returned categories to ensure your agent has the correct context before attempting any compliance checks.