Skip to main content
Glama

Essay Stats MCP: Essay Word Count and Writing Checker

You are about to hand in an essay and you are not sure if it is over the word limit, or how many pages it is. A chat assistant tends to guess at word counts. This server counts them properly, on your computer, so your assistant can give you real numbers.

Install it in Claude Code with one line:

claude mcp add essay-stats -- npx -y essay-stats-mcp

Then ask things like:

  • "My limit is 1500 words, not counting the works cited or quotes. Am I over?"

  • "How many pages is this essay in Arial 11 point with 1.5 spacing?"

  • "Find the passive voice and filler words in my draft."

Essay Stats MCP is an essay word counter and writing checker that runs offline. It counts words and pages, gives a readability score, and flags passive voice, filler words, long sentences and repeated sentence openers. It also gives the reading time.

There is no account, no API key and no network call. Your essay text never leaves your machine.

Quick start

Claude Code users can use the one line above. For other apps, copy the snippet for your client. It needs Node.js 20 or newer.

Claude Desktop

Open Settings, Developer, Edit Config, and add this to claude_desktop_config.json. Then restart Claude Desktop.

{
  "mcpServers": {
    "essay-stats": {
      "command": "npx",
      "args": ["-y", "essay-stats-mcp"]
    }
  }
}

Cursor

Add this to .cursor/mcp.json in your project, or to ~/.cursor/mcp.json for all projects.

{
  "mcpServers": {
    "essay-stats": {
      "command": "npx",
      "args": ["-y", "essay-stats-mcp"]
    }
  }
}

VS Code

Add this to .vscode/mcp.json in your workspace. VS Code uses a servers key instead of mcpServers.

{
  "servers": {
    "essay-stats": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "essay-stats-mcp"]
    }
  }
}

Windsurf

Use the same snippet as Claude Desktop in ~/.codeium/windsurf/mcp_config.json.

Related MCP server: avoid-ai-writing-mcp

Tools

Tool

What it does

count_text

Words, characters, sentences, paragraphs, reading time and an estimated page count for a font, size and line spacing.

readability_scores

Flesch Kincaid grade, Flesch reading ease, Gunning Fog and SMOG.

style_flags

Passive voice, repeated sentence openers, filler words and long sentences.

sentence_variety

How much sentence lengths change, with short, medium and long counts and runs of similar length.

check_word_limit

Compares the text with a word limit. Optional minimum, tolerance, and leaving out references and quotes.

word_frequency

The words used most often, with counts and share of the text, to spot overused terms.

All six tools only read the text you give them. Each one returns a short written answer and the same numbers as structured fields.

count_text

Inputs: text, and optional font (times new roman, arial, calibri, georgia, courier new or verdana), font_size in points (default 12) and spacing (single, 1.5 or double, default double). The page count is an estimate from typical words per page, so Word or Google Docs may differ by a little.

readability_scores

Input: text. The grades are roughly US school grades, so 12 is the end of high school. SMOG is designed for 30 sentences or more, so on a short text the result is marked as less reliable.

style_flags

Inputs: text and optional max_sentence_words (default 30). The checks are simple pattern rules. Use them as a prompt to reread a sentence, not as proof of a mistake.

Sentence numbers start at 1 and follow the order of the text. The sentence_list field gives each passive or long sentence with its number, and the text summary ends with a line listing those numbers, so a reply can point you to the right sentence.

sentence_variety

Input: text. Returns the shortest, longest and average sentence length in words, the standard deviation, and how many sentences are short (under 10 words), medium (10 to 24) or long (25 or more). It also lists runs of 3 or more sentences in a row whose lengths are within 3 words of the first one in the run, with their sentence numbers. Sentence numbers start at 1 and follow the order of the text.

word_frequency

Inputs: text, and optional top (how many words to list, default 10), min_count (fewest uses for a word to be listed, default 2) and include_common_words (also count small words such as the, and, of and to, default false). Case is ignored, and words under 3 letters are skipped unless include_common_words is true.

check_word_limit

Inputs: text, limit, and optional minimum, tolerance_percent, exclude_references and exclude_quotes. References are cut from a heading line such as References, Works Cited or Bibliography to the end. Quotes are lines starting with > and text inside double quotes.

FAQ: how words and pages are counted

How does it count a word?

It splits the text on spaces and line breaks and counts each piece that has at least one letter or digit in it. That is the same idea Word and Google Docs use. A hyphenated word such as well known counts as one word when written with a hyphen, and a number like 2024 counts as one word.

Why can my count differ from Word?

Mostly because of what gets pasted. A dash or symbol standing alone between spaces is counted by Word but not here, since it has no letter or digit. Footnotes, headers, footers and text boxes only count if you paste them in. If the two numbers differ by a few words, check those first.

How is the page number worked out?

count_text divides the word count by a fixed words per page figure for the font you pick, then adjusts for font size and line spacing. It is an estimate, not a layout. It does not know your margins, headings, title page, tables or images, so Word can show a different page count. For a hard page rule, trust the page count in your own document.

What does check_word_limit leave out?

Nothing unless you ask. With exclude_references it drops everything from a heading line such as References, Works Cited or Bibliography to the end. With exclude_quotes it drops lines starting with > and text inside double quotes. The answer shows the total, the counted words and how many words were left out, so you can match it to what your instructor counts.

Does the tolerance change the word count?

No. The count stays the same. tolerance_percent only widens the allowed limit, so a limit of 1500 with 10 percent tolerance allows up to 1650 words. The answer says when you are over the limit but inside the tolerance.

Example prompts

  • "Count the words in this essay and tell me how many pages it is in Arial 11 point with 1.5 spacing."

  • "What reading level is this essay? Give me the Flesch Kincaid, Gunning Fog and SMOG scores."

  • "Find the passive voice and filler words in my draft."

  • "My limit is 1500 words, not counting the works cited or quotes. Am I over?"

  • "Which sentences are over 25 words long?"

  • "Do my sentences all sound the same length?"

  • "Which words do I overuse in this essay?"

How it compares

Essay Stats MCP does one job: it measures a piece of writing you give it. Other tools in this area do different jobs, so the table below is about what each kind of tool is for, not about which is better.

Essay Stats MCP

Brightspace MCP servers, such as brightspace-mcp-server

Online grammar and writing checkers

Asking a chat assistant to count

Main job

Word count, page estimate, readability and style flags for an essay

Reading course data from Brightspace, such as courses and assignments

Fixing grammar, spelling and tone

General answers

Works on your own draft text

Yes

No, it works on course data

Yes

Yes

Exact word and page numbers

Yes, counted by code

Not its purpose

Usually a word count only

Often a guess

Word limit check that skips references and quotes

Yes, with check_word_limit

No

Rarely

Unreliable

Needs an account or API key

No

Depends on the server, check its README

Often an account

Depends on the app

Sends your text over the network

No

Depends on the server

Usually yes

Yes, to the assistant

Runs as a local MCP server

Yes

Yes

Not usually

Not applicable

Essay Stats MCP does not fix your writing or reach into Brightspace. If you want Brightspace data next to it, see the next section for our own server, brightspace-d2l-mcp.

Works well with

If your school uses Brightspace, you can run brightspace-d2l-mcp next to Essay Stats MCP in the same app. That server has its own setup, so follow its README to install and sign in. Essay Stats MCP does not talk to it and does not need it.

With both added to your MCP config, you can ask your assistant to look up the word limit in your assignment details, then pass that number to check_word_limit along with your draft. For example:

  • "Find the word limit for my history essay in Brightspace, then check this draft against it, leaving out the works cited."

  • "Look up my assignment instructions, then tell me if this draft is under the limit and how many pages it is."

The assignment details come from the other server. The counting and checking happen here, on your machine, and Essay Stats MCP makes no network calls.

Privacy

Everything is calculated locally by a small Node.js program talking to your app over standard input and output. It makes no network requests, stores nothing and needs no keys or passwords. The text you paste is used for the one call and then dropped.

Development

npm install
npm run build
npm test

More free student MCP servers

All free, open source and read only where they touch your accounts. Browse the full list at brightspacemcp.com/more-mcps.

Server

What it does

Brightspace MCP

D2L Brightspace for AI. Due dates with real submission status, grades, a target grade calculator and course files.

Canvas MCP

Canvas LMS for AI, read only. Due dates, missing work, grades and announcements.

Moodle MCP

Moodle for AI, read only. Due dates, overdue work, grades and announcements.

Google Classroom MCP

Google Classroom for AI, read only. Todos, due dates, missing work and grades.

GPA Calculator MCP

GPA, grade conversion and the grade you need on the final, for AI. Works offline, no account.

Citations MCP

APA, MLA and Chicago citations from a DOI, an ISBN or typed details. No account.

Study Planner MCP

Exam study schedules, spaced repetition dates, pomodoro plans and assignment milestones. Works offline.

Paper Finder MCP

Search scholarly papers, find open access copies and related work through OpenAlex. No key needed.

BibTeX Reference Manager MCP

Clean, convert, dedupe and lint BibTeX, RIS and CSL JSON reference lists, and make cite keys. Works offline.

Open Textbook Finder MCP

Find free legal copies of textbooks on OpenStax, DOAB and Open Library, look up editions by ISBN and suggest cheaper older ones.

STEM Calculator MCP

Chemistry and physics homework math: molar mass, balancing equations, grams to moles, unit conversion and significant figures. Works offline.

Syllabus to Calendar MCP

Syllabus to calendar MCP server. Extract dates from syllabus text, build an ics calendar, expand recurring classes and merge calendars. Works offline, no account.

Job Application Tracker MCP

Job application tracker MCP server. Track internships, jobs, interviews and deadlines offline, see what is coming up, and export your list as CSV or Markdown. No account and no API keys.

License

MIT

Available Tools

6 tools
check_word_limitCheck a word limitA
Read-onlyIdempotent

Compare an essay against a word limit. Inputs: text, limit (the maximum word count), optional minimum (a lower bound), optional tolerance_percent (how far over the limit is still acceptable, default 0, a common rule is 10), optional exclude_references (cut everything from a heading line such as References, Works Cited or Bibliography to the end) and optional exclude_quotes (leave out block quotes that start with > and text inside double quotes). Returns the counted words, how many are left or over, and what was excluded. Example: "Is this under 2000 words if I leave out the works cited and quotes?"

Inputs: text (required), limit (required), minimum, exclude_quotes, +2 more. Returns: limit, status, minimum, words_over, +6 more

count_textCount words, sentences and pagesA
Read-onlyIdempotent

Count the words, characters, sentences and paragraphs in a text, and estimate how many pages it fills at a given font, font size and line spacing. Inputs: text, and optional font (times new roman, arial, calibri, georgia, courier new or verdana, default times new roman), font_size in points (default 12) and spacing (single, 1.5 or double, default double). The page count is an estimate from typical words per page, so a word processor may differ by a little. Also returns an estimated reading time at 238 words per minute. Example: "Count the words in this essay and estimate the pages in Times New Roman 12 double spaced."

Inputs: text (required), font, spacing, font_size. Returns: font, words, spacing, font_size, +6 more

readability_scoresReadability scoresA
Read-onlyIdempotent

Score how hard a text is to read with three standard formulas: Flesch Kincaid grade level (plus the Flesch reading ease score), Gunning Fog index and SMOG index. Each grade is roughly a US school grade, so 12 is the end of high school and 16 is a college degree. Input: text. SMOG is built for samples of 30 sentences or more, so on shorter text the tool still returns a number but marks it as less reliable. Example: "Give me the Flesch Kincaid, Gunning Fog and SMOG scores for this paper."

Inputs: text (required). Returns: smog, words, sentences, syllables, +6 more

sentence_varietySentence varietyA
Read-onlyIdempotent

Show how much the sentence lengths in an essay change, since a good rhythm mixes short, medium and long sentences. Input: text. Returns the shortest, longest and average sentence length in words, the standard deviation, how many sentences are short (under 10 words), medium (10 to 24) and long (25 or more), and any runs of 3 or more sentences in a row whose lengths are within 3 words of the first one in the run, with their sentence numbers. Sentence numbers start at 1 and follow the order of the text. This is a simple measure of rhythm, so treat it as a prompt to reread. Example: "Do my sentences all sound the same length?"

Inputs: text (required). Returns: lengths, sentences, long_count, short_count, +6 more

style_flagsStyle flagsA
Read-onlyIdempotent

Flag common style problems in an essay: sentences in the passive voice, sentences that start with the same word as a neighbour (or three or more times), filler words and phrases such as very, just, in order to, and sentences that are too long. Inputs: text, and optional max_sentence_words (default 30), the length above which a sentence counts as long. Sentence numbers start at 1 and follow the order of the text, so number 3 is the third sentence. The sentence_list field gives each passive or long sentence with its number, and the text summary ends with a line listing those numbers. The checks are simple pattern rules, so treat them as prompts to reread, not as errors. Example: "Flag passive voice and filler words in my draft."

Inputs: text (required), max_sentence_words. Returns: filler, sentences, filler_count, passive_count, +5 more

word_frequencyWord frequencyA
Read-onlyIdempotent

Find the words an essay uses most, to spot overused or repeated terms. Inputs: text, and optional top (how many words to list, default 10), min_count (fewest uses for a word to be listed, default 2) and include_common_words (also count small words such as the, and, of and to, default false). Case is ignored, and words under 3 letters are skipped unless include_common_words is true. Each word comes with its count and its share of all the words in the text. Example: "Which words do I overuse in this essay?"

Inputs: text (required), top, min_count, include_common_words. Returns: top, words, min_count, total_words, +1 more

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 6 tools

    Disambiguation4/5

    Each tool has a mostly distinct analytical purpose, but there are two soft overlaps: check_word_limit and count_text both count words (one for limit compliance, one for full stats/pages), and style_flags and sentence_variety both surface sentence-length problems. The descriptions differentiate them well enough (limit/exclusions vs. counts and page estimation; passive/filler checks vs. length distribution) that an agent can choose correctly, but they could occasionally be confused.

    Naming Consistency4/5

    All names are clean snake_case and readable, but they split into two conventions: verb-led (check_word_limit, count_text) and noun-led (word_frequency, readability_scores, style_flags, sentence_variety). The noun-led names are defensible as analysis outputs, yet there is no single predictable template.

    Tool Count5/5

    Six tools is well-scoped for an essay-stats server: counting, frequency, readability, style, word limits and sentence variety. Each tool earns its place and none looks like filler.

    Completeness4/5

    The surface covers the core essay-analysis workflow well: length compliance, vocabulary repetition, readability formulas, style flags and sentence rhythm. Minor gaps remain (e.g. vocabulary diversity/type-token ratio, paragraph-level breakdowns, or spelling/grammar checks), but agents can work around these.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Provides text statistics and readability scores (Flesch Reading Ease, Flesch-Kincaid Grade Level) via offline, keyless tools.
      68 npm
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Provides local, deterministic scoring and detailed auditing of text for AI-writing patterns via two read-only tools, with no network calls or language models.
      2
      9 npm
      3
      MIT
    • F
      license
      Not graded
      quality
      A
      maintenance
      Enables agents to analyze inline prose or files on disk for formulaic AI writing patterns, returning a 0-100 score, band label, specific violations with context, and concrete advice. Uses purely programmatic, configurable rules with no LLM judge or API calls.
      -
    • F
      license
      Not graded
      quality
      A
      maintenance
      Enables agents to analyze text or files and receive numeric slop scores, band labels, specific violations with context, and concrete writing advice, using rule-based diagnostics with no LLM judge or API calls.
      -