Acrolinx MCP Server

A Model Context Protocol (MCP) server that integrates with the Acrolinx NextGen API to provide advanced text analysis and improvement capabilities to AI assistants like Claude and Cursor.

Features

Text Rewriting: Automatically improve text for clarity, tone, and style guide compliance
Content Analysis: Get detailed quality scores across multiple dimensions
Writing Suggestions: Receive specific recommendations for text improvements
Style Guide Support: AP, Chicago Manual of Style, Microsoft, and Proofpoint
Multiple Dialects: American, British, Australian, and Canadian English
Tone Flexibility: Academic, business, casual, conversational, formal, gen-z, informal, and technical

Installation

Prerequisites

Node.js 18.0.0 or higher
An Acrolinx API key

Setup

Clone the repository:

git clone https://github.com/acrolinx/nextgen-mcp.git
cd nextgen-mcp

Install dependencies:

npm install

Configure environment variables:

cp .env.example .env
# Edit .env and add your ACROLINX_API_KEY

Build the project:

npm run build

Configuration

Variable	Required	Description	Default
`ACROLINX_API_KEY`	Yes	Your Acrolinx API key	-
`ACROLINX_BASE_URL`	No	API base URL	`https://app.acrolinx.cloud`
`DEBUG`	No	Enable debug logging	`false`
`MAX_TEXT_LENGTH`	No	Maximum text length (chars)	`100000`
`WORKFLOW_TIMEOUT`	No	Workflow timeout (ms)	`60000`
`POLL_INTERVAL`	No	Status check interval (ms)	`2000`
`MAX_RETRIES`	No	API retry attempts	`3`

Usage with AI IDEs

This MCP server is compatible with any IDE that supports the Model Context Protocol, including Claude Desktop and Cursor.

Configuration

The configuration is identical for all MCP-compatible IDEs. Only the configuration file location differs:

IDE	Configuration File Location
Claude Desktop (macOS)	`~/Library/Application Support/Claude/claude_desktop_config.json`
Claude Desktop (Windows)	`%APPDATA%\Claude\claude_desktop_config.json`
Cursor (macOS/Linux)	`~/.cursor/mcp.json`
Cursor (Windows)	`%USERPROFILE%\.cursor\mcp.json`

Option 1: Run directly from GitHub (recommended)

Add this configuration to your IDE's MCP configuration file:

{
  "mcpServers": {
    "acrolinx": {
      "command": "npx",
      "args": [
        "-y",
        "github:acrolinx/nextgen-mcp"
      ],
      "env": {
        "ACROLINX_API_KEY": "your_api_key_here"
      }
    }
  }
}

Option 2: Run from local installation

For local development or if you prefer to run from a local installation:

{
  "mcpServers": {
    "acrolinx": {
      "command": "node",
      "args": ["/path/to/nextgen-mcp/dist/index.js"],
      "env": {
        "ACROLINX_API_KEY": "your_api_key_here"
      }
    }
  }
}

Note: After updating the configuration, restart your IDE for the changes to take effect.

Using with Cursor

When using this MCP server with Cursor, you'll see a "Calling undefined" message with a "Run tool" button when the AI wants to use Acrolinx tools. This is normal behavior - simply click "Run tool" to approve the analysis. This manual approval is Cursor's security feature for MCP tool execution.

Available Tools

`acrolinx_rewrite`

Automatically rewrite and improve text content.

Parameters:

text (required): The text to rewrite
dialect: Language dialect (default: "american_english")
tone: Desired tone (default: "formal")
style_guide: Style guide to follow (default: "microsoft")

`acrolinx_check`

Analyze text for quality issues without making changes.

Parameters:

text (required): The text to analyze
dialect: Language dialect (default: "american_english")
tone: Target tone to check against (default: "formal")
style_guide: Style guide to check against (default: "microsoft")

`acrolinx_suggestions`

Get detailed editing suggestions for improving text.

Parameters:

text (required): The text to get suggestions for
dialect: Language dialect (default: "american_english")
tone: Target tone for suggestions (default: "formal")
style_guide: Style guide for suggestions (default: "microsoft")

`acrolinx_workflow_status`

Check the status of an asynchronous workflow.

Parameters:

workflow_id (required): The workflow ID to check
workflow_type (required): Type of workflow ("rewrites", "checks", or "suggestions")

Development

Running in Development Mode

npm run dev

Running Tests

# Test suggestions endpoint
node test-suggestions.js

# Test complete workflow
node test-suggestions-complete.js

Building

npm run build

Troubleshooting

Common Issues

"Calling undefined" message in Cursor: This is normal Cursor behavior, not an error. When you see this message with a "Run tool" button, click the button to execute the Acrolinx analysis. This is Cursor's security feature requiring manual approval for MCP tool execution.
"Client closed" error in Cursor: Try clearing the npx cache: npx clear-npx-cache and restart Cursor
API key issues: Verify your ACROLINX_API_KEY is correctly set in the environment variables
Permission errors: On Unix systems, ensure the compiled JavaScript file is executable (chmod +x dist/index.js)

Debug Mode

Enable debug logging by setting DEBUG=true in your environment:

DEBUG=true npm run start

Architecture

The server implements the Model Context Protocol using stdio transport and provides four main tools that interact with the Acrolinx NextGen API. Key features include:

Cross-IDE Compatibility: Works with Claude Desktop, Cursor, and any MCP-compatible IDE
Retry Logic: Exponential backoff for improved reliability
Timeout Handling: Configurable timeouts for long-running operations
Comprehensive Logging: Debug mode for troubleshooting
Type Safety: Full TypeScript implementation with proper type guards
Graceful Shutdown: Proper cleanup on termination

License

MIT

Contributing

Fork the repository
Create a feature branch
Make your changes
Run npm run build to ensure everything compiles
Submit a pull request

Support

For issues and questions:

Create an issue on GitHub
Check the Acrolinx documentation
Contact Acrolinx support

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

A Model Context Protocol server that integrates with the Acrolinx NextGen API to provide advanced text analysis and improvement capabilities to AI assistants like Claude, offering features such as text rewriting, content analysis, and writing suggestions.

Related MCP Servers

Notion MCP Server
emmanuelsystems
A
security
F
license
A
quality
A Model Context Protocol server that connects AI assistants like Claude to Notion workspaces, enabling them to view, search, create, and update Notion databases, pages, and content blocks.
Last updated -
12
706
1
JavaScript
Prem MCP Server
ucalyptus
-
security
F
license
-
quality
A Model Context Protocol server implementation that enables seamless integration with Claude and other MCP-compatible clients to access Prem AI's language models, RAG capabilities, and document management features.
Last updated -
JavaScript
MCP Outline Server
Vortiago
A
security
A
license
A
quality
A Model Context Protocol server that enables AI assistants like Claude to interact with Outline document services, supporting document searching, reading, creation, editing, and comment management.
Last updated -
25
29
Python
MIT License
microCMS MCP Server
microcmsio
A
security
A
license
A
quality
A Model Context Protocol server that enables AI assistants like Claude to interact with microCMS content management system through six core tools for performing CRUD operations on microCMS list-type APIs.
Last updated -
10
13
11
TypeScript
MIT License

View all related MCP servers

Acrolinx MCP Server