Documentation

MCP Server

Connect GPT Scrambler to Claude Desktop, Cursor, or any MCP-compatible AI client using the Model Context Protocol.

The GPT Scrambler MCP server is published on npm as @gptscrambler/mcp-server and runs over stdio (no local file access). Source code: github.com/gptscrambler/mcp-server.

Note: The legacy unscoped package gptscrambler-mcp-server is deprecated. Use @gptscrambler/mcp-server instead.

Overview and pricing: MCP & API landing page · REST API: API reference

Prerequisites

  • An API key — generate one at Settings → API Access
  • Node.js 18 or later
  • npx available in your shell (npm v5.2+)

npm package

Package@gptscrambler/mcp-server
Installnpx -y @gptscrambler/mcp-server (used automatically in the config below)
Repositorygptscrambler/mcp-server

Claude Desktop

Edit your Claude Desktop configuration file:

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

Add the gpt-scrambler server under mcpServers:

{
  "mcpServers": {
    "gpt-scrambler": {
      "command": "npx",
      "args": ["-y", "@gptscrambler/mcp-server"],
      "env": {
        "GPTSCRAMBLER_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

Restart Claude Desktop. The humanize_text and get_balance tools will appear in the tools panel.


Cursor

Add to .cursor/mcp.json in your project root (project-scoped), or ~/.cursor/mcp.json (global):

{
  "mcpServers": {
    "gpt-scrambler": {
      "command": "npx",
      "args": ["-y", "@gptscrambler/mcp-server"],
      "env": {
        "GPTSCRAMBLER_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

Cursor picks up the file automatically — no restart needed.


Environment variables

VariableRequiredDescription
GPTSCRAMBLER_API_KEYYour sk_live_... API key
GPTSCRAMBLER_API_URLOverride API base URL. Default: https://gptscrambler.com

Available tools

humanize_text

Rewrite AI-generated text to sound more human.

ParameterTypeRequiredDescription
textstringThe text to humanize (10–3,000 words)
languagestringBCP 47 language code, e.g. en, de
mode"standard" | "aggressive"Rewrite strength. Default: standard

Example prompt to Claude or Cursor:

Humanize this text using GPT Scrambler: "Artificial intelligence is transforming..."


get_balance

Returns your remaining word balance, active plan, and next reset date. No parameters required.

Returns the same payload as GET /api/v1/balance.