Pain in the Agent

Pain in the Agent MCP

通过 AI 客户端使用 Pain in the Agent 文本工具：移除文本水印、让草稿更自然、比较版本或检查 AI 写作。改写使用你账户月度方案的字符额度：每月 $5，可处理 100,000 个字符，每段文本最多 10,000 个字符；网站和远程 MCP 共用该额度。只有成功生成且内容有变化的结果才会收费。比较和 AI 检查免费，每天最多 100 次；没有方案时，每段文本最多 1,000 个字符，有方案时最多 10,000 个字符。网站提供的免费试用次数（每个浏览器 3 次）不适用于 API 或此客户端。

研究和示例介绍了针对参考 SynthID Text 水印测试改写方法的情况。这些测量与实时工具工作流分开。此客户端无法验证 Claude 或 Gemini 的私有水印密钥。AI 写作信号是实验性的风格观察，并不能证明作者身份。

安装

请先登录并订阅及创建 API 密钥；改写需要该账户开通月度方案。将密钥保存在客户端的机密设置或环境变量中，不要放在对话或源代码管理中。你不需要 OpenRouter 或 OpenAI 密钥。

Claude Desktop

从最新版本下载 .mcpb 文件，在 Claude Desktop 中打开，并在其 API 密钥设置中输入服务密钥。MCPB 包含所需的 Node 依赖项。需要 Node.js 22 或更高版本。

Codex

克隆此仓库或解压某个版本。已提交的 dist/index.cjs 无需运行 npm install 即可使用。将以下内容添加到 Codex MCP 配置中，并将示例绝对路径替换为你的检出目录：

[mcp_servers.painintheagent]
command = "node"
args = ["/absolute/path/painintheagent-mcp/dist/index.cjs"]
env_vars = ["PAININTHEAGENT_API_KEY", "PAININTHEAGENT_BASE_URL"]
startup_timeout_sec = 15
tool_timeout_sec = 40

在启动 Codex 的环境中设置 PAININTHEAGENT_API_KEY。使用公共服务时，无需设置 PAININTHEAGENT_BASE_URL。更改环境后，请重启客户端。

此外，还包含位于 plugins/painintheagent-mcp/ 的 Codex 插件，以及位于 .agents/plugins/marketplace.json 的仓库市场。要添加此来源，请运行 codex plugin marketplace add krllagent/painintheagent-mcp，然后在应用中从该来源选择 Pain in the Agent。生成的目录名为 personal；它是一个仓库来源，与 OpenAI 的公共插件目录分开。该插件会转发相同的两个环境变量。

Claude Code

在启动 Claude Code 的环境中设置 PAININTHEAGENT_API_KEY。然后使用：

/plugin marketplace add krllagent/painintheagent-mcp
/plugin install painintheagent-mcp@painintheagent

该插件包含一个 rewrite 技能和 MCP 服务。也可以使用本地检出目录，通过 claude --plugin-dir /absolute/path/painintheagent-mcp/claude-plugins/painintheagent-mcp 加载。

Cursor 和其他本地 MCP 客户端

配置一个 stdio 服务，命令设为 node，并将 dist/index.cjs 的绝对路径设为唯一参数。通过客户端的环境变量或机密设置提供 PAININTHEAGENT_API_KEY。不同客户端的环境变量替换语法各不相同，请使用客户端文档说明的格式。MCPB 和源代码版本包含相同的服务。

工具

工具	功能
start_rewrite	启动去水印改写，并立即返回 run_id。使用计划中的字符额度。接受 slop_removal，但该参数不起作用。
start_humanize	通过通篇替换措辞，让文本更自然并去除水印，同时提供改写前后的 AI 评分。使用计划中的字符额度。
start_watermark_comparison	比较 source_text 和 candidate_text，检查含义是否发生变化。在每日检查额度内免费。不会检测供应商水印。
start_ai_detection	使用训练好的 AI 检测器对至少 80 个词进行评分（0–100），并标出 AI 写作模式。在每日检查额度内免费。
get_result	读取任意文本工具的进度或已保存结果，不会启动模型处理。
get_rewrite	返回该 ID 对应的进度、附带保真度说明的已保存结果，或错误。不会启动模型处理。
get_limits	读取账户的字符额度、单篇文本上限，以及付费月份结束时间。

请让你的 Agent 使用所需工具，并展示其来源说明或引用的风格证据。处理期间请保持客户端打开；深度改写可能需要几分钟。本地 MCP 进程会维持流式连接，关闭进程可能会中断任务。独立的远程 MCP 端点 https://painintheagent.com/mcp 支持 OAuth，并会在断开连接后继续处理排队的任务。

请保存请求 ID。如果数据流中断，请使用同一个 ID 调用 get_result。旧名称 get_rewrite 仍然可用。客户端不会自动重试 POST 请求。使用相同的操作和输入重复使用某个 ID，会检索该次运行；如果操作、候选文本或选项不同，则会被拒绝。失败的运行不会消耗字符额度。待处理请求会预留字符额度，直到任务完成或达到服务端截止时间；这些 ID 不能用于启动新的任务。

隐私与网关

只会发送你提供的文本。此客户端不会读取你的文件、将文本保存到磁盘，也不会发送遥测数据。托管服务会将文本发送给其模型提供商，并按照隐私政策所述存储源文本和结果。你的 MCP 主机可能会根据自身设置保留工具的输入和输出。请勿提交机密信息或个人敏感数据。

客户端会读取 PAININTHEAGENT_API_KEY 和可选的 PAININTHEAGENT_BASE_URL。默认基础 URL 为 https://painintheagent.com。配置的网关会接收每个请求；不会回退使用其他凭据或端点。仅允许对 localhost 网关使用 HTTP。身份验证使用 bearer 标头，并且会拒绝重定向。

开发

npm ci --ignore-scripts
npm run build
npm test
node scripts/package.mjs

测试使用虚构文本和本地模拟 HTTP 服务，涵盖端点选择、身份验证失败、请求复用、数据流中断，以及通过 stdio 使用 MCP 的全新打包安装。测试不会调用付费模型，也不代表已对线上服务提供商进行验证。

请参阅 API 参考和发行状态。客户端采用 MIT 许可证。托管服务和研究各有其自身的条款和证据。