bullet-mcp
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@bullet-mcpCheck my bullet points for the project summary"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.

bullet-mcp
MCP server for evidence-based bullet point summarization guidance. Validates and improves bullet lists using scientifically-validated principles from cognitive psychology and UX research.
Features
Score bullet lists (0-100) against 7 evidence-based rules
Letter grades (A/B/C/D/F) with actionable feedback
Research citations for each validation rule
Context awareness (document, presentation, reference)
Sections support for long documents with multiple chapters/topics
Related MCP server: verifiable-thinking-mcp
Installation
npm install bullet-mcpOr install globally:
npm install -g bullet-mcpUsage
Claude Desktop Configuration
Add to your Claude Desktop config (claude_desktop_config.json):
{
"mcpServers": {
"bullet": {
"command": "npx",
"args": ["bullet-mcp"]
}
}
}Tool: bullet
Validates bullet point lists against evidence-based cognitive research.
Input:
{
"items": [
{ "text": "Use 3-7 items per list for optimal recall", "importance": "high" },
{ "text": "Place critical information first and last" },
{ "text": "Maintain parallel grammatical structure" },
{ "text": "Keep lines between 45-75 characters" },
{ "text": "Limit hierarchy to 2 levels maximum" }
],
"context": "document"
}Output:
{
"overall_score": 97,
"grade": "A",
"summary": "Excellent bullet list following evidence-based best practices.",
"top_improvements": ["Consider adding detail or combining with a related point"],
"errors": [],
"warnings": [],
"suggestions": [...]
}Sectioned Mode (for long documents)
For long documents with multiple chapters or topics, use the sections format. Each section is validated separately (3-7 items per section), allowing unlimited total content.
Input:
{
"sections": [
{
"title": "Chapter 1: Introduction",
"items": [
{ "text": "Define the problem scope and context" },
{ "text": "Outline key objectives and goals" },
{ "text": "Summarize the main approach taken" }
]
},
{
"title": "Chapter 2: Methods",
"items": [
{ "text": "Describe data collection procedures" },
{ "text": "Explain analysis methodology used" },
{ "text": "Detail validation steps performed" }
],
"context": "reference"
}
],
"context": "document"
}Output includes per-section breakdown:
{
"overall_score": 95,
"grade": "A",
"section_scores": [
{ "title": "Chapter 1: Introduction", "score": 96, "grade": "A", "item_count": 3 },
{ "title": "Chapter 2: Methods", "score": 94, "grade": "A", "item_count": 3 }
],
"summary": "Excellent structured summary across 2 sections."
}Validation Rules
Rule | Threshold | Research Basis |
List Length | 3-7 items (5 optimal) | Miller (1956), Cowan (2001): Working memory 3-4 chunks |
Hierarchy | Max 2 levels | Kiger (1984), Nielsen: 2-level structures fastest |
Line Length | 45-75 chars (66 optimal) | Typography research on readability |
Serial Position | Important info first/last | Ebbinghaus (1885): U-shaped retention curve |
Parallel Structure | Consistent grammar | Frazier et al. (1984): Faster scanning |
First Words | Unique, scannable | Nielsen eye-tracking: First 2 words critical |
Formatting | Consistent punctuation | Usability research |
Context Options
document(default): Optimizes for scanning and referencepresentation: Warns that visuals may be 43% more persuasivereference: Optimizes for quick lookup
Environment Variables
Variable | Default | Description |
|
| Treat warnings as errors |
|
| Disable research citations in output |
|
| Disable colored console output |
Development
# Install dependencies
npm install
# Build
npm run build
# Test with MCP Inspector
npm run devResearch Foundation
This tool is based on docs/bullet-study.md, a synthesis of cognitive psychology research on optimal list design including:
Working memory capacity (Miller, Cowan)
Serial position effects (Ebbinghaus, Murdock)
Eye-tracking studies (Nielsen Norman Group)
Information architecture (Kiger, Zaphiris)
Typography research (45-75 character optimal line length)
License
MIT
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Tools
Related MCP Servers
- FlicenseDqualityDmaintenanceMCP Server for AI Summarization, Support for multiple content types: * Plain text * Web pages * PDF documents * EPUB books * HTML contentLast updated112164
- AlicenseBquality-maintenanceMCP server for structured reasoning with cognitive trap detection, verification, and context compressionLast updated5411
- AlicenseAqualityBmaintenanceAn MCP server that helps AI assistants generate valid, accessible Adaptive Cards for Teams, Outlook, Copilot, and other Microsoft and non-microsoft surfaces. 9 tools, 3 guided workflows, 924 tests to help you build an awesome AI experience.Last updated931MIT
- Alicense-qualityCmaintenanceAn MCP server that enforces the Microsoft Manual of Style (MSTP) rules. It extracts text from a provided PDF (mstp.pdf) and uses Large Language Models (LLMs) via the Groq API to check text for style violations and suggest corrections.Last updatedMIT
Related MCP Connectors
MCP server for generating rough-draft project plans from natural-language prompts.
MCP server providing access to the Scorecard API to evaluate and optimize LLM systems.
MCP Spec Compliance MCP — audits any MCP server.json against the official Model Context Protocol
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/nikkoxgonzales/bullet-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server