essay-stats-mcp 0.1.1 → 0.1.2

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.1.2
+
+- Add worked examples to word_frequency and style_flags errors
+- Add competitor comparison table to README
+- Update the table of sibling MCP servers in the README
+
 ## 0.1.1
 
 - Tool descriptions now include example prompts, so clients can show what to ask each tool.

package/README.md

@@ -85,6 +85,22 @@ Inputs: `text`, `limit`, and optional `minimum`, `tolerance_percent`, `exclude_r
 - "Which sentences are over 25 words long?"
 - "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](https://www.npmjs.com/package/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.
@@ -108,6 +124,26 @@ 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](https://brightspacemcp.com/more-mcps/).
+
+| Server | What it does |
+| --- | --- |
+| [Brightspace MCP](https://github.com/AnonymousOnyx22/brightspace-d2l-mcp) | D2L Brightspace for AI. Due dates with real submission status, grades, a target grade calculator and course files. |
+| [Canvas MCP](https://github.com/AnonymousOnyx22/canvas-lms-student-mcp) | Canvas LMS for AI, read only. Due dates, missing work, grades and announcements. |
+| [Moodle MCP](https://github.com/AnonymousOnyx22/moodle-student-mcp) | Moodle for AI, read only. Due dates, overdue work, grades and announcements. |
+| [Google Classroom MCP](https://github.com/AnonymousOnyx22/google-classroom-student-mcp) | Google Classroom for AI, read only. Todos, due dates, missing work and grades. |
+| [GPA Calculator MCP](https://github.com/AnonymousOnyx22/gpa-calculator-mcp) | GPA, grade conversion and the grade you need on the final, for AI. Works offline, no account. |
+| [Citations MCP](https://github.com/AnonymousOnyx22/student-citations-mcp) | APA, MLA and Chicago citations from a DOI, an ISBN or typed details. No account. |
+| [Study Planner MCP](https://github.com/AnonymousOnyx22/study-planner-mcp) | Exam study schedules, spaced repetition dates, pomodoro plans and assignment milestones. Works offline. |
+| [Paper Finder MCP](https://github.com/AnonymousOnyx22/paper-finder-student-mcp) | Search scholarly papers, find open access copies and related work through OpenAlex. No key needed. |
+| [BibTeX Reference Manager MCP](https://github.com/AnonymousOnyx22/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](https://github.com/AnonymousOnyx22/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](https://github.com/AnonymousOnyx22/stem-calc-student-mcp) | Chemistry and physics homework math: molar mass, balancing equations, grams to moles, unit conversion and significant figures. Works offline. |
+| [Syllabus to Calendar MCP](https://github.com/AnonymousOnyx22/syllabus-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](https://github.com/AnonymousOnyx22/job-tracker-student-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

package/build/src/server.js

@@ -1,7 +1,7 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { registerTools } from "./core/tools.js";
 import { tools } from "./tools.js";
-export const VERSION = "0.1.1";
+export const VERSION = "0.1.2";
 export function createServer() {
     const server = new McpServer({ name: "essay-stats-mcp", version: VERSION });
     registerTools(server, tools);

package/build/src/tools.js

@@ -4,9 +4,12 @@ const EMPTY_TEXT_HINT = `text is empty. Paste the essay text to analyse. Worked
 const textInput = z.string().min(1, EMPTY_TEXT_HINT);
 function requireText(text, toolName) {
     if (!/[A-Za-z0-9]/.test(text)) {
-        const example = toolName === "check_word_limit"
-            ? `{ "text": "Your essay content here.", "limit": 1500, "exclude_references": true }`
-            : `{ "text": "Your essay content here." }`;
+        const examples = {
+            check_word_limit: `{ "text": "Your essay content here.", "limit": 1500, "exclude_references": true }`,
+            word_frequency: `{ "text": "Your essay content here.", "top": 10, "min_count": 2 }`,
+            style_flags: `{ "text": "Your essay content here.", "max_sentence_words": 30 }`,
+        };
+        const example = examples[toolName] ?? `{ "text": "Your essay content here." }`;
         throw new Error(`The text has no words in it. Paste the essay text and try again. Worked example for ${toolName}: ${example}`);
     }
 }

package/llms.txt

@@ -1,6 +1,8 @@
 # Essay Stats MCP
 
-> An MCP server with offline writing metrics for essays. It counts words and pages, scores readability, flags style problems and checks word limits. No account, no API key, no network.
+> An MCP server with offline writing metrics for essays. It counts words and pages, scores readability, flags style problems and checks word limits. No account, no API key, no network. Your essay text never leaves your machine.
+
+Claude Code users can install it with one line: `claude mcp add essay-stats -- npx -y essay-stats-mcp`
 
 Package: essay-stats-mcp (npm). Registry name: io.github.AnonymousOnyx22/essay-stats-mcp. Runs over stdio. Needs Node.js 20 or newer.
 
@@ -38,6 +40,18 @@ All tools are read only and work on text passed in the call.
 - "Flag passive voice and filler words in my draft."
 - "Which words do I overuse in this essay?"
 - "Is this under 2000 words if I leave out the works cited and quotes?"
+- "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?"
+- "What reading level is this essay?"
+- "Which sentences are over 25 words long?"
+
+## Tool examples
+
+- count_text: "Count the words in this essay and tell me how many pages it is in Arial 11 point with 1.5 spacing." Uses font arial, font_size 11 and spacing 1.5.
+- readability_scores: "Give me the Flesch Kincaid, Gunning Fog and SMOG scores for this paper." Grades are roughly US school grades.
+- style_flags: "Which sentences are over 25 words long?" Uses max_sentence_words 25. Sentence numbers start at 1.
+- word_frequency: "Show my 15 most used words." Uses top 15.
+- check_word_limit: "My limit is 1500 words, not counting the works cited or quotes." Uses limit 1500 with exclude_references and exclude_quotes set to true.
 
 ## Privacy
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "essay-stats-mcp",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Essay Stats MCP counts words and pages offline for essays, scores readability, flags passive voice and filler words, and checks word limits against assignment requirements. No account, no network.",
   "type": "module",
   "main": "build/src/index.js",