Nextgen MCP

🚀 Acrolinx MCP Server

A Model Context Protocol (MCP) server integrating with the Acrolinx NextGen API to offer advanced text analysis and enhancement capabilities to AI assistants such as Claude.

🚀 Quick Start

The Acrolinx MCP Server is a powerful tool that integrates with the Acrolinx NextGen API. It provides advanced text analysis and improvement capabilities for AI assistants like Claude. To get started, follow the installation and configuration steps below.

✨ Features

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

📦 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

📚 Documentation

Configuration

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

Basic Usage

The Acrolinx MCP Server provides several useful tools for text analysis and improvement. Here are some basic usage examples of these 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")

🔧 Technical Details

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

This project is licensed under the MIT license.

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