GPTHuman Humanizer

by GPTHuman-ai

332 downloads
Not rated
GitHub

About

MCP server providing access to GPTHuman's API, the leading platform for rewriting AI-generated text into more natural, human-sounding prose, that successfully bypasses AI detectors.

Details

Author
GPTHuman-ai
Downloads
332
Categories
Other

- Single humanize_text tool for rewriting AI text.
- Supports four tones: Standard, HighSchool, College, PhD.
- Three rewrite modes: Professional, Balanced, Enhanced.
- Returns a human score and metadata with each rewrite.
- Input must be 300–2,000 characters; output includes word/credit counts.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name GPTHuman Humanizer
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Set the GPTHUMAN_API_KEY environment variable to a valid API key from GPTHuman.ai, then run npx -y @gpthuman/mcp-server. Configure the server in your client’s MCP settings (e.g., ~/.cursor/mcp.json or claude_desktop_config.json) by specifying the command and environment variable. The server exposes a single humanize_text tool.

humanize_text

Transforms AI-generated text into a more natural, human-sounding variant while preserving the requested tone and rewrite mode. Input must be at least 300 characters and must not exceed 2,000 words.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "gpthuman humanizer": {
            "gpthuman": {
                "command": "npx",
                "args": [
                    "-y",
                    "@gpthuman/mcp-server"
                ],
                "env": {
                    "GPTHUMAN_API_KEY": "your-api-key-here"
                }
            }
        }
    }
}

McpServers

{
    "gpthuman": {
        "command": "npx",
        "args": [
            "-y",
            "@gpthuman/mcp-server"
        ],
        "env": {
            "GPTHUMAN_API_KEY": "your-api-key-here"
        }
    }
}

A Model Context Protocol (MCP) server providing access to GPTHuman's API, the leading platform for rewriting AI-generated text into more natural, human-sounding prose, with AI-detector metadata returned when available. This allows any MCP-compatible client (Cursor, Claude Desktop, etc.) to call the humanizer tool natively.

The server is shipped as a single humanize_text tool that rewrites AI-generated text into a more natural, human-sounding variant, while preserving the requested tone and rewrite mode.

Quick Start



You can run the server directly and test it in 60 seconds:

``bash
export GPTHUMAN_API_KEY=...
npx -y @gpthuman/mcp-server
`


Requirements



- Node.js
>= 22.0.0
- A GPTHuman API key — get one at GPTHuman.ai

Configuration



The server reads a single environment variable:

| Variable | Required | Description |
| ------------------ | -------- | ---------------------------- |
|
GPTHUMAN_API_KEY | Yes | Your GPTHuman API key. |

Installation



Cursor



Add the server to
~/.cursor/mcp.json (or your workspace .cursor/mcp.json):

`json
{
"mcpServers": {
"gpthuman": {
"command": "npx",
"args": ["-y", "@gpthuman/mcp-server"],
"env": {
"GPTHUMAN_API_KEY": "your-api-key-here"
}
}
}
}
`

> Security Note: While the example above places the
GPTHUMAN_API_KEY directly in JSON, we recommend using environment variables or local secret storage when possible. Never commit .cursor/mcp.json with real API keys to version control.

Claude Desktop



Add it to
claude_desktop_config.json:

`json
{
"mcpServers": {
"gpthuman": {
"command": "npx",
"args": ["-y", "@gpthuman/mcp-server"],
"env": {
"GPTHUMAN_API_KEY": "your-api-key-here"
}
}
}
}
`

Other clients



Any MCP client that supports the stdio transport can run the server with:

`bash
GPTHUMAN_API_KEY=your-api-key-here npx -y @gpthuman/mcp-server
`

Tools



humanize_text



Transforms AI-generated text into a more natural, human-sounding variant designed to bypass AI detectors, while preserving the requested tone and rewrite mode.

Input parameters

| Name | Type | Required | Default | Description |
| ------ | ------ | -------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------- |
|
text | string | Yes | — | The text to humanize. Must be at least 300 characters and at most 2,000 words. |
|
tone | enum | No | College | Target reading level / tone. One of Standard, HighSchool, College, PhD. |
|
mode | enum | No | Balanced | Rewrite strategy. One of Professional, Balanced, Enhanced. |

Output

The tool returns two content blocks:

1. The humanized text (the primary payload).
2. A markdown summary with metadata: AI-detector human score, similarity to original, readability, detected language, applied tone and mode, input/output word and character counts, credit usage, remaining credit balance, and the request ID.

Example call (from an MCP client)

`json
{
"name": "humanize_text",
"arguments": {
"text": "Your AI-generated text of at least 300 characters goes here...",
"tone": "College",
"mode": "Balanced"
}
}
`

Example Output
`
---
Metadata Summary:
- Human Score: 98%
- Similarity: 85%
- Readability: College-level
- Credit Usage: 142
- Remaining Balance: 4,858
- Request ID: req_xyz123
``

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.