Pain in the Agent MCP server

Pain in the Agent MCP

Use the Pain in the Agent text tools from an AI client. Humanize drafts, rewrite text watermarks, compare versions or check AI writing signals. Confirmed email accounts share 100 successful operations per month across all tools, the website, API and MCP, with 100–10,000 characters per text.

The research and examples describe tests of rewrite methods against reference SynthID Text watermarks. Those measurements are separate from the live tool workflow. This client cannot verify Claude or Gemini's private watermark keys. AI writing signals are experimental style observations, not proof of authorship.

Installation

First sign in and create an API key. Keep the key in your client's secret settings or environment, outside conversations and source control. You do not need an OpenRouter or OpenAI key.

Claude Desktop

Download the .mcpb file from the latest release, open it in Claude Desktop, and enter the service key in its API key setting. The MCPB bundle contains its Node dependencies. It uses Node.js 22 or later.

Codex

Clone this repository or extract a release. The committed dist/index.cjs is ready to run without npm install. Add this to your Codex MCP configuration, replacing the example absolute path with your checkout:

[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

Set PAININTHEAGENTAPIKEY in the environment that starts Codex. Omit PAININTHEAGENTBASEURL for the public service. Restart the client after changing its environment.

A Codex plugin is also included at plugins/painintheagent-mcp/, with a repository marketplace at .agents/plugins/marketplace.json. To add this source, run codex plugin marketplace add krllagent/painintheagent-mcp and select Pain in the Agent from that source in the app. The generated catalog is named personal; it is a repository source, separate from OpenAI's public plugin directory. The plugin forwards the same two environment variables.

Claude Code

Set PAININTHEAGENTAPIKEY in the environment that starts Claude Code. Then use:

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

The plugin includes a rewrite skill and the MCP server. A local checkout can also be loaded with claude --plugin-dir /absolute/path/painintheagent-mcp/claude-plugins/painintheagent-mcp.

Cursor and other local MCP clients

Configure a stdio server with command node and one argument, the absolute path to dist/index.cjs. Supply PAININTHEAGENTAPIKEY through your client's environment or secret setting. Clients have different environment-variable substitution syntax, so use the format your client documents. The MCPB and source release contain the same server.

Tools

Shortened. The full README is on GitHub.