HumanPen
About
Point an AI agent at a .docx/.pptx/.pdf and it lowers the file's AI-detection score, converts citations (APA/MLA/IEEE/GB-T 7714), condenses, or translates it — formatting, tables and citations intact.
Details
- Author
- humanpen
- Categories
- Productivity
Jump to
Setup
Install HumanPen in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/humanpen/humanpen-mcp
Follow the installation instructions in the repository README, then restart your MCP client.
Keywords:ai humanizer, mcp server, model context protocol, turnitin ai detection, reduce ai score, humanize ai text, bypass ai detection, docx ai humanizer, ai content rewriter, ai writing tool, claude mcp, cursor mcp, ithenticate ai report
Humanize what's flagged. Preserve the rest.An MCP server forHumanPen— a document-level AI humanizer that can humanize an entire document, rewrite user-selected passages, or automatically target flagged text from a Turnitin / iThenticate AI-detection report, editing.docx/.pptxfiles in place while preserving formatting, tables, images, citations, and formulas. Also converts citations between 12 styles, condenses to a word budget, and translates between 12 languages.
claude mcp add humanpen -s user -e HUMANPEN_API_KEY=hp_your_key -- npx -y humanpen-mcp
- Selective rewriting by detection report— import a Turnitin / iThenticate AI Writing Report to pinpoint flagged passages; unflagged content is never touched
- Format in, format out— a DOCX comes back as a DOCX, a PPTX as a PPTX; formatting, tables, images, and formulas survive intact and the result is still editable
- Academic structure preserved— in-text citations, reference lists, footnotes, TOC fields, cross-references, figure numbering, equations, and special formatting are treated as protected objects
- No error injection— restructures meaning and syntax to change expression; never adds grammar mistakes, spelling errors, or awkward sentences as a detection strategy
- Full-length documents— no per-input word limit; a single file can be up to 100 MB, no splitting into text boxes
- Free to keep going— still flagged? Re-humanize for free with a fresh report until the AI rate falls toor 0%
- Word-count control (experimental)— set a min/max word range to keep the output within a target length
- Pay per rewrite— billed on words actually changed, not the whole document; failed and cancelled jobs cost nothing; credits never expire
Sign up athttps://humanpen.netand create a key athttps://humanpen.net/settings/api-keys. New accounts start with free credits, enough to put a document through and see what comes back.
The key goes in an environment variable, never in a URL. URLs end up in server logs, proxy logs, shell history and screenshots.
claude mcp add humanpen -s user -e HUMANPEN_API_KEY=hp_your_key -- npx -y humanpen-mcp
-s userputs it in every project. The default scope islocal, which loads the server only in the directory you ran the command from — and looks like a broken install the first time you open Claude Code somewhere else.
If your version rejects-e(reported upstream), use the JSON form:
claude mcp add-json humanpen -s user '{"command":"npx","args":["-y","humanpen-mcp"],"env":{"HUMANPEN_API_KEY":"hp_your_key"}}'
[mcp_servers.humanpen] command = "npx" args = ["-y", "humanpen-mcp"] env = { HUMANPEN_API_KEY = "hp_your_key" }
codebuddy mcp add --scope user humanpen -- npx -y humanpen-mcp
It also reads${VAR}in its config, so the key can stay in your environment instead of the file:
{ "mcpServers": { "humanpen": { "command": "npx", "args": ["-y", "humanpen-mcp"], "env": { "HUMANPEN_API_KEY": "${HUMANPEN_API_KEY}" } } } }
~/.codebuddy/.mcp.jsonfor every project,<project>/.mcp.jsonfor one.
It hasgemini mcp add, but the argument order differs between versions — rungemini mcp add --helpand follow the usage line it prints. Pass the key with-e HUMANPEN_API_KEY=...and the scope with-s user; the default isproject, which is only the directory you ran it in.
Inclaude_desktop_config.json.Use the absolute path tonpx— runwhich npxand paste the result: a desktop app is launched by the OS with a minimalPATH, so the bare name that works in your terminal often is not found here, and the only symptom is that the tools never appear.
{ "mcpServers": { "humanpen": { "command": "npx", "args": ["-y", "humanpen-mcp"], "env": { "HUMANPEN_API_KEY": "hp_your_key" } } } }
All three read the same shape — Cursor in.cursor/mcp.json, Windsurf in~/.codeium/windsurf/mcp_config.json, Cline in its MCP settings panel:
{ "mcpServers": { "humanpen": { "command": "npx", "args": ["-y", "humanpen-mcp"], "env": { "HUMANPEN_API_KEY": "hp_your_key" } } } }
Inopencode.json— the key names differ slightly from everyone else's:
{ "mcp": { "humanpen": { "type": "local", "command": ["npx", "-y", "humanpen-mcp"], "environment": { "HUMANPEN_API_KEY": "hp_your_key" } } } }
{ "mcp": { "inputs": [ { "type": "promptString", "id": "humanpenKey", "description": "HumanPen API key", "password": true } ], "servers": { "humanpen": { "command": "npx", "args": ["-y", "humanpen-mcp"], "env": { "HUMANPEN_API_KEY": "${input:humanpenKey}" } } } } }
VS Code prompts once and stores the key in its secret store, so it never lands in a file you might commit.
git clone https://github.com/humanpen/humanpen-mcp cd humanpen-mcp && npm install && npm run build
Then point your client atnode /path/to/humanpen-mcp/dist/index.jsinstead ofnpx -y humanpen-mcp.
Any MCP client works: this is a plain stdio server started bynpx -y humanpen-mcpwithHUMANPEN_API_KEYin its environment.
Jobs take minutes; tool calls do not.Each operation waits about 55 seconds — enough for most documents — then returns ajob_idwith a note to callcheck_job. The work continues on the server either way; nothing is lost by the tool returning early.
ai_percentcan benull, and that is usually good news.Turnitin printsinstead of a number whenever AI writing comes inunder 20%— it will not quantify that band, because too much of it is false positives. Sonullmeans "under 20%, and Turnitin will say no more", never "0%" and never "no result".
Will this bring a Turnitin AI score down?Usually under 20% in one pass withbalanced— the threshold below which Turnitin prints*instead of a number. If it misses, hand the result back with the new report; only the passages still flagged get rewritten.
Does it work with iThenticate too?Yes — pass either report. The format is read from the file.
Is my document sent to the model?No. It uploads the file and answers with a path. A 40-page paper costs no tokens.
Documents you pass to a tool are uploaded over HTTPS to HumanPen's API (api.humanpen.net) for processing; results are written back to your disk, and processed files are kept server-side for about 7 days socheck_joband the free re-humanize pass can find them. Document contents never enter the model's context. The full policy — what is collected, retention, and how to reach us — is athttps://humanpen.net/legal/privacy.
npm install npm run build HUMANPEN_API_KEY=hp_... node selftest.mjs sample.docx report.pdf
selftest.mjsspawns the built server and talks JSON-RPC to it over stdio the way a real client does — proving the protocol, the tool registrations, stdout hygiene and one end-to-end job, not merely that the functions return. It needs a live key and spends credits, so it is a pre-release check rather than a CI step.
- API documentation·OpenAPI schema
- humanpen-skill— the same operations as an Agent Skill, if you would rather not run a server
- humanpen.net
The 1Password MCP server creates a bridge that allows MCP clients such as Codex and Kiro to manage your 1Password Environments with secure authorization prompts.
This is the 1st, easiest, and cheapest PPT, slides, presentation AI generation MCP Server in the world.
Persistent memory for any AI assistant. Zero token cost until recall. Stores memories in local SQLite, ranks by 6-factor scoring, returns results 79% smaller than JSON. Works with Claude, ChatGPT, Grok, Cursor, Windsurf, and any MCP client.
A MCP server that enables AI assistants to interact with Anki, the spaced repetition flashcard application.
Enables LLM clients to interact with macOS applications through AppleScript. Built using the @beyondbetter/bb-mcp-server library, this server provides safe, controlled execution of predefined scripts with optional support for arbitrary script execution.
An MCP server for WordPress plugin audits
Turn your AI assistant into a digital marketing hub that creates, organizes, and analyzes links and QR Codes on demand.
Connect AI clients to Cal.com scheduling through the Model Context Protocol using the hosted server at mcp.cal.com or a local instance.
Sync Calendars, Scheduling Links, AI Executive Scheduling Assistant, Unified Calendar
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
