watermarkbuster-mcp 1.0.0 → 1.0.1

package/README.md

@@ -1,6 +1,6 @@
 # Watermark Buster MCP
 
-Connect a local MCP client to the hosted Watermark Buster tools. The package is a bridge. It does not run the cleaning engine on your computer.
+Connect an MCP client to the hosted Watermark Buster tools. This package is a local stdio bridge. It does not run the cleaning engine on your computer.
 
 ## Requirements
 
@@ -9,7 +9,37 @@ Connect a local MCP client to the hosted Watermark Buster tools. The package is
 
 No account, API token, GPU, Python, or local model is required.
 
-## Use with `npx`
+## Run without installing
+
+Use `npx` to download and start the current package:
+
+```bash
+npx -y watermarkbuster-mcp
+```
+
+The command waits for MCP messages on standard input. It does not open a user interface or show a prompt. Normally, your MCP client starts this command for you.
+
+## Install the command
+
+Install the command on your computer:
+
+```bash
+npm install --global watermarkbuster-mcp
+```
+
+Your MCP client can then start:
+
+```text
+watermarkbuster-mcp
+```
+
+To add the package to one Node.js project instead, run:
+
+```bash
+npm install watermarkbuster-mcp
+```
+
+## Add the npx bridge to an MCP client
 
 Set these values in your MCP client:
 
@@ -18,7 +48,7 @@ Command: npx
 Arguments: -y watermarkbuster-mcp
 ```
 
-For clients that use an `mcpServers` JSON object, the matching form is:
+Clients that use an `mcpServers` JSON object commonly use this form:
 
 ```json
 {
@@ -31,39 +61,98 @@ For clients that use an `mcpServers` JSON object, the matching form is:
 }
 ```
 
-The MCP client starts the command. Running it in a normal terminal shows no user interface because it waits for MCP messages on standard input.
+## Connect directly to the remote server
+
+Clients that support remote Streamable HTTP MCP do not need this npm bridge. Connect them directly to:
+
+```text
+https://watermarkbuster.com/mcp
+```
+
+### Codex
+
+Add this to `~/.codex/config.toml`:
+
+```toml
+[mcp_servers.watermark_buster]
+url = "https://watermarkbuster.com/mcp"
+```
+
+Restart Codex, then run `codex mcp list` or use `/mcp` inside Codex.
 
-## Install first
+### Claude Code
 
 ```bash
-npm install --global watermarkbuster-mcp
+claude mcp add --transport http watermark-buster https://watermarkbuster.com/mcp
 ```
 
-Then set the MCP command to:
+Run `claude mcp list` or use `/mcp` inside Claude Code.
 
-```text
-watermarkbuster-mcp
+### Gemini CLI
+
+```bash
+gemini mcp add --transport http watermark-buster https://watermarkbuster.com/mcp
+```
+
+Run `gemini mcp list` to confirm the connection.
+
+### Cursor
+
+Add this to `.cursor/mcp.json` for one project or `~/.cursor/mcp.json` for all projects:
+
+```json
+{
+  "mcpServers": {
+    "watermark-buster": {
+      "url": "https://watermarkbuster.com/mcp"
+    }
+  }
+}
+```
+
+Open Cursor's Customize sidebar, select MCP, and confirm that the server is enabled.
+
+### Google Antigravity
+
+Add this to `~/.gemini/config/mcp_config.json` for all workspaces or `.agents/mcp_config.json` for one workspace:
+
+```json
+{
+  "mcpServers": {
+    "watermark-buster": {
+      "serverUrl": "https://watermarkbuster.com/mcp"
+    }
+  }
+}
 ```
 
+Save the file, then refresh Installed MCP Servers.
+
 ## Tools
 
 The bridge reads the current tool list from the hosted MCP server when it starts. The current tools are:
 
-- `inspect_text`
-- `clean_text`
-- `clean_file`
-- `get_capabilities`
+- `inspect_text` — report supported hidden Unicode without changing the text
+- `clean_text` — remove supported hidden Unicode and exotic spaces
+- `clean_file` — clean a supported file and return the cleaned copy
+- `get_capabilities` — read the current formats, limits, and behavior
+
+Example agent requests:
+
+- “Inspect this text for hidden Unicode.”
+- “Clean this file and return the cleaned copy.”
+- “Show the current Watermark Buster capabilities.”
 
 ## Data flow
 
 Tool input is sent to `https://watermarkbuster.com` for processing. The hosted service processes content for the call and does not archive it. Do not use this npm bridge if content must stay on your computer.
 
-For clients that support remote Streamable HTTP MCP, connect directly to `https://watermarkbuster.com/mcp` instead.
-
 ## Connection errors
 
 If the hosted service cannot be reached, the command writes `Watermark Buster MCP: <reason>` to standard error and exits with a failure status. Check that `https://watermarkbuster.com/mcp` is reachable, then let the MCP client start the command again.
 
+For more setup help, see [the full MCP guide](https://watermarkbuster.com/mcp).
+
 ## License
 
 MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "watermarkbuster-mcp",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Connect local MCP clients to the hosted Watermark Buster tools.",
   "type": "module",
   "bin": {