avoid-ai-writing-mcp

A local, deterministic MCP server for auditing prose with the published avoid-ai-writing-detector.

It exposes two read-only tools:

• score_text returns a compact score, classification, confidence, and counts.
• audit_text adds a bounded set of flagged patterns, suggested alternatives, statistics, and highlighted sentence regions.

The server makes no network calls and uses no language model. Text stays inside the local MCP process. Scores are heuristic writing-pattern signals, not proof that a person or model wrote the text.

Requirements

• Node.js 20 or newer
• An MCP host that supports local stdio servers

Install

Add this server to Claude Code:

claude mcp add avoid-ai-writing -- npx -y avoid-ai-writing-mcp

Or add it to an MCP JSON configuration:

{
  "mcpServers": {
    "avoid-ai-writing": {
      "command": "npx",
      "args": ["-y", "avoid-ai-writing-mcp"]
    }
  }
}

To run the current source directly from GitHub instead, use github:conorbronsdon/avoid-ai-writing-mcp as the package spec.

The package uses stdio for protocol messages. It does not open a port or send input to an API.

Tool inputs

Both tools accept:

| Field | Type | Required | Description | | --- | --- | --- | --- | | text | string | yes | Text to evaluate locally (maximum 100,000 characters). | | context | enum | no | general (default), technical, marketing, or personal. |

technical mode reduces noise from patterns that are normal in code-adjacent writing. The other modes preserve the detector's context-specific behavior.

audit_text returns at most 100 issues and 100 highlighted regions. Its truncated field reports how many additional items the detector produced.

Development

npm install
npm test
npm run inspect

npm run inspect launches the official MCP Inspector against the local stdio entry point.

Scope

This package intentionally does not expose a rewrite tool. Rewriting requires editorial judgment and often a hosted model; adding that would undermine this server's deterministic, local, privacy-preserving contract.

License

MIT