# GPT Scrambler — LLM / AI Agent Reference

GPT Scrambler is a text humanization service that transforms AI-generated text to sound natural
and bypass AI detectors (Turnitin, GPTZero, Copyleaks, and others).

## MCP Server

GPT Scrambler provides an MCP (Model Context Protocol) server that AI agents can use to
humanize text without leaving their environment.

- npm package: @gptscrambler/mcp-server (https://www.npmjs.com/package/@gptscrambler/mcp-server)
- Source: https://github.com/gptscrambler/mcp-server
- Legacy package gptscrambler-mcp-server is deprecated; use @gptscrambler/mcp-server

**Install:**
```json
{
  "mcpServers": {
    "gpt-scrambler": {
      "command": "npx",
      "args": ["-y", "@gptscrambler/mcp-server"],
      "env": {
        "GPTSCRAMBLER_API_KEY": "<your_api_key>"
      }
    }
  }
}
```

**Available tools:**
- `humanize_text(text, language?)` — Humanize AI-generated text. Returns humanized text, words used, and remaining balance.
- `get_balance()` — Check remaining word balance and plan details.

## REST API

Base URL: https://gptscrambler.com/api/v1
Authentication: Bearer token (API key)

**POST /api/v1/humanize**
Humanize AI-generated text.

Request:
```json
{
  "text": "Your AI-generated text here",
  "language": "en",
  "mode": "standard"
}
```

Response:
```json
{
  "humanized_text": "...",
  "words_used": 123,
  "balance_remaining": 9877
}
```

**GET /api/v1/balance**
Check remaining word balance.

Response:
```json
{
  "balance_remaining": 9877,
  "plan": "api",
  "reset_date": "2026-06-20"
}
```

## Error Codes

- 401 invalid_api_key — API key is missing or invalid
- 402 insufficient_balance — Not enough words remaining
- 403 trial_exhausted — Free trial used, upgrade required
- 400 text_too_short / text_too_long — Word count outside allowed range (10–3000 words)
- 429 — Rate limit exceeded (60 requests/hour)

## Plans

- Free trial: 200 words for API/MCP only (separate from web balance, one-time)
- API Plan: $49.99/month — 100,000 words, fixed global price

## Site Pages

- Home: https://gptscrambler.com/en
- AI Scrambler: https://gptscrambler.com/en/ai-scrambler
- ChatGPT Scrambler: https://gptscrambler.com/en/chatgpt-scrambler
- MCP Server & API: https://gptscrambler.com/en/mcp
- Pricing: https://gptscrambler.com/en/pricing
- Blog: https://gptscrambler.com/en/blog
- Chrome Extension: https://gptscrambler.com/en/chrome-extension
- Docs: https://gptscrambler.com/en/docs
- Sitemap: https://gptscrambler.com/sitemap.xml
- Full reference (extended): https://gptscrambler.com/llms-full.txt

## Links

- Website: https://gptscrambler.com
- API & MCP docs: https://gptscrambler.com/en/mcp
- MCP setup (docs): https://gptscrambler.com/en/docs/mcp
- REST API reference: https://gptscrambler.com/en/docs/api
- npm: https://www.npmjs.com/package/@gptscrambler/mcp-server
- GitHub: https://github.com/gptscrambler/mcp-server
- Pricing: https://gptscrambler.com/en/pricing
- Get API key: https://gptscrambler.com/app/settings/api-access