# Cognitive Load Scorer MCP for AI Agents MCP

> Cognitive Load Scorer quantifies the mental effort required to process text by measuring linguistic complexity. It identifies where readers might struggle with dense vocabulary, convoluted grammar, or high memory load. Use it to audit documentation, UI copy, and educational content to strip away friction and improve clarity.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_1KOk7RIHolegTPgiDAmHVbg9WXzxAjAtmJSywT4M/mcp
- **Tags:** text-analysis, cognitive-load, linguistics, readability, nlp

## Description

This MCP lets you turn subjective complaints about "hard to read" text into measurable data. Instead of guessing if a paragraph is confusing, you can have your agent run a technical audit on any piece of content. It breaks down the specific reasons why a reader might get stuck, whether it's because the vocabulary is too dense or the sentence structure is just too convoluted. If you're trying to make your documentation more accessible or your UI copy more intuitive, this tool gives you a clear score on where the friction lives. You can check if a list of instructions is too long for a human to remember or if a technical explanation is burying the point in complex grammar. It's a practical way to enforce readability standards across large projects. By connecting this to the Vinkius catalog, you get a specialized lens for auditing content quality at scale.

## Tools

### evaluate_lexical_difficulty
This tool checks the difficulty of the words used in a text. It helps you see if your vocabulary is too dense for your audience.

### analyze_syntactic_structure
This tool breaks down sentence construction. It identifies complex grammar that might cause a reader to lose their place.

### calculate_working_memory_load
This tool measures how much information a reader has to hold in their head at once. It's great for checking if instructions are too long.

## Prompt Examples

**Prompt:** 
```
Is this instruction list too hard to remember: 'First, open the app, then navigate to settings, click the profile icon, select security, and then toggle the two-factor auth switch'?
```

**Response:** 
```
The analysis shows a high list pressure for this set of instructions.

**Memory Load Breakdown:**
* **Action Count:** 6 distinct steps
* **Buffer Usage:** High
* **Friction Point:** The sequence is too long for a single mental pass.

**Recommendation:** Break this into a numbered list or a multi-step guide to reduce the cognitive load on the user.
```

**Prompt:** 
```
Check the vocabulary in this sentence: 'The implementation of the API via RESTful architecture requires authentication.'
```

**Response:** 
```
The vocabulary evaluation indicates high decoding overhead for a general audience.

**Key Terms:**
* **RESTful:** Technical jargon
* **Architecture:** High complexity in this context

**Verdict:** If your audience is not developer-focused, these terms will slow down reading speed. Consider using simpler language like "how the system is built."
```

**Prompt:** 
```
How complex is this sentence: 'The researcher, who had studied the phenomenon for decades, noted that the results were not unexpected.'
```

**Response:** 
```
The sentence structure analysis shows a high clause depth.

**Structural Analysis:**
* **Clause Depth:** 2
* **Negation Density:** High (use of "not unexpected")

**Verdict:** The nested structure and double negatives create unnecessary friction. It's wordy and can be simplified for better flow.
```

## Capabilities

### Score vocabulary difficulty
Get a clear sense of how complex the words in a text are for your target audience.

### Map sentence complexity
Identify long or nested structures that slow down reading speed.

### Measure memory pressure
See if a list or set of instructions exceeds a reader's ability to keep it in mind.

### Audit content friction
Find specific spots in a document where users are likely to lose focus.

### Validate readability standards
Check if your copy meets specific linguistic requirements for clarity.

## Use Cases

### Simplifying onboarding flows
A UX writer wants to know if a new onboarding flow is too complex. They ask their agent to check the memory load of the instructions to see if users can remember the steps.

### Auditing technical API docs
A tech writer has a dense paragraph about a new API. They use the tool to find where the syntax gets too messy and needs simplification for junior developers.

### Checking educational materials
An educator wants to simplify a textbook chapter. They run a lexical difficulty check to identify gatekeeper words that might confuse students.

### Optimizing marketing landing pages
A marketing team wants to ensure a landing page is skimmable. They audit the copy for cognitive friction to see where potential customers might stop reading.

## Benefits

- Stop guessing about readability by getting hard scores on vocabulary difficulty using evaluate_lexical_difficulty.
- Identify wall of text issues early by checking sentence construction with analyze_syntactic_structure.
- Prevent user errors in instructions by measuring memory limits with calculate_working_memory_load.
- Improve accessibility for all users by finding and removing linguistic friction points.
- Scale content audits across thousands of pages without manual proofreading.
- Maintain consistent brand voice by identifying and removing unnecessary linguistic complexity.

## How It Works

The bottom line is you get a data-backed audit of how hard your text is to process.

1. Feed any block of text or a list of instructions into your AI client.
2. The MCP analyzes the grammar, vocabulary, and structure of the input.
3. You get a breakdown of the cognitive load and specific friction points.

## Frequently Asked Questions

**What is Cognitive Load Scorer?**
It's an MCP that measures how hard it is for a human to process your text. It looks at vocabulary, grammar, and memory load to find friction.

**How does it help with UX writing?**
It gives you data on whether your UI copy is too dense. You can see exactly where a user might get stuck on a button or a label.

**Can I use it for technical docs?**
Yes, it's perfect for auditing API guides. It helps you find where the syntax becomes too complex for a new user.

**Does it just give a readability score?**
It's more detailed than a simple grade level. It breaks down the specific reasons for the difficulty, like sentence structure or memory load.

**How do I use it with my agent?**
Just give your AI client a block of text and ask it to analyze the cognitive load. It will return a breakdown of the linguistic complexity.

**Is it good for accessibility?**
Yes, it helps you ensure content is accessible to people with different cognitive needs by highlighting high-friction areas.

**What does the `analyze_syntactic_structure` tool measure?**
It determines structural effort by calculating maximum nested clause depth and negation density within your text.

**How is lexical difficulty evaluated?**
The `evaluate_lexical_difficulty` tool compares words against lists of concrete and abstract terms, while also measuring the density of jargon and acronyms.

**Can I use this to check for reader fatigue?**
Yes, by using `calculate_working_memory_load`, you can identify high-pressure structures like long lists that increase the risk of cognitive overload.