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-serveris deprecated. Use@gptscrambler/mcp-serverinstead.
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
npxavailable in your shell (npmv5.2+)
npm package
| Package | @gptscrambler/mcp-server |
| Install | npx -y @gptscrambler/mcp-server (used automatically in the config below) |
| Repository | gptscrambler/mcp-server |
Claude Desktop
Edit your Claude Desktop configuration file:
| Platform | Path |
|---|---|
| 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
| Variable | Required | Description |
|---|---|---|
GPTSCRAMBLER_API_KEY | ✓ | Your sk_live_... API key |
GPTSCRAMBLER_API_URL | — | Override API base URL. Default: https://gptscrambler.com |
Available tools
humanize_text
Rewrite AI-generated text to sound more human.
| Parameter | Type | Required | Description |
|---|---|---|---|
text | string | ✓ | The text to humanize (10–3,000 words) |
language | string | — | BCP 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.