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.

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

1. Clone the repository:

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

2. Install dependencies:

npm install

3. Configure environment variables:

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

4. 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 Claude Desktop

Add the server to your Claude Desktop configuration:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

Option 1: Run directly from GitHub (recommended)

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

Option 2: Run from local installation

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

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

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:

• 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

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

DEBUG=true npm run start

License

MIT

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Run npm run build to ensure everything compiles
5. Submit a pull request

Support

For issues and questions:

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