libb-cognitive-clarity
v1.0.4
Published
MCP server for cognitive accessibility analysis — score any message through 15 clinical cognitive assessment gates before it reaches a human
Maintainers
Readme
Libb Cognitive Clarity — MCP Server
Score any message through 15 clinical cognitive assessment gates before it reaches a human.
Built on clinical speech-language pathology research, Libb measures whether a message is cognitively processable — not just grammatically correct, but actually understandable by the person reading it.
Why this exists
Every day, workplace communications fail — not because they contain errors, but because they exceed the cognitive processing capacity of the reader. Policy updates buried in passive voice. Action items hidden inside nested clauses. Deadlines expressed as "in the near future."
These aren't style problems. They're cognitive accessibility barriers that disproportionately impact neurodivergent employees, non-native speakers, and anyone under cognitive load.
Libb Cognitive Clarity gives AI agents and automation platforms the ability to catch these barriers before messages ship.
Installation
npm install -g libb-cognitive-clarityQuick Start — Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"libb-cognitive-clarity": {
"command": "libb-cognitive-clarity"
}
}
}Restart Claude Desktop. You can now ask Claude to analyze any text for cognitive clarity.
Quick Start — Claude Cowork
Add to your Cowork MCP configuration:
{
"mcpServers": {
"libb-cognitive-clarity": {
"command": "npx",
"args": ["-y", "libb-cognitive-clarity"]
}
}
}Available Tools
| Tool | Description |
|------|-------------|
| analyze_message | Full 15-gate analysis with Cognitive Processability Score, gate-by-gate breakdown, flagged issues with suggested fixes, and a cognitively accessible rewrite |
| quick_check | Fast pass/flag screening — score and flagged gates only |
The 15 Cognitive Execution Gates
Every message is scored across 15 clinical assessment gates derived from the proprietary CCVM (Cognitive-Communication Vulnerability Mapping) Framework:
| # | Gate | |---|------| | 1 | Ambiguity Load | | 2 | Inference Demand | | 3 | Action Burial | | 4 | Hedge Density | | 5 | Passive Deflection | | 6 | Temporal Vagueness | | 7 | Jargon Saturation | | 8 | Cognitive Stacking | | 9 | Referential Ambiguity | | 10 | Negative Framing | | 11 | Modal Confusion | | 12 | Format Accessibility | | 13 | Emotional Tone Masking | | 14 | Cultural Load | | 15 | Processing Bottleneck |
Each gate applies clinically-derived assessment criteria to identify specific cognitive friction patterns. The assessment methodology is protected under pending patent applications.
Cognitive Processability Score (CPS)
Every analysis returns a Cognitive Processability Score indicating how accessible the message is to the broadest range of readers, including neurodivergent individuals, non-native speakers, and those under cognitive load.
Use it before sending
- Emails and Slack messages
- HR communications and policy updates
- Job descriptions and postings
- Training materials and onboarding docs
- Customer-facing support responses
- Any communication where misunderstanding has consequences
Compliance alignment
Libb Cognitive Clarity supports organizational compliance with:
- Illinois HB 3773 — AI-assisted hiring communication requirements
- Colorado SB 24-205 — Algorithmic discrimination prevention
- NYC Local Law 144 — Automated employment decision tools
- WCAG 2.2 AA — Web content cognitive accessibility
- W3C COGA — Cognitive and Learning Disabilities Accessibility guidance
Requirements
- Node.js >= 18
- Works with any MCP-compatible client (Claude Desktop, Claude Cowork, or any platform supporting the Model Context Protocol)
Built by
Cognitive Velocity Consulting — Bridging clinical speech-language pathology expertise with enterprise AI governance.
The CCVM Framework, Cognitive Execution Gates, and Linguistic Ergonomics methodology are proprietary to Cognitive Velocity Consulting. Patent pending.
License
MIT — This license applies to the MCP server client code. The underlying cognitive assessment methodology, CCVM Framework, and Linguistic Ergonomics methodology are proprietary intellectual property of Cognitive Velocity Consulting and are not licensed under this MIT license.
