diff --git a/package-lock.json b/package-lock.json
index 5e5f33f..ef63985 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -3432,7 +3432,7 @@
     },
     "packages/mcp": {
       "name": "@affitor/mcp",
-      "version": "0.2.2",
+      "version": "0.2.3",
       "license": "MIT",
       "dependencies": {
         "@affitor/recipes": "^0.1.0",
diff --git a/packages/mcp/CHANGELOG.md b/packages/mcp/CHANGELOG.md
index 116b93e..f4a5312 100644
--- a/packages/mcp/CHANGELOG.md
+++ b/packages/mcp/CHANGELOG.md
@@ -1,5 +1,9 @@
 # Changelog — @affitor/mcp
 
+## 0.2.3 (registry 0.2.4)
+- Tool and input descriptions rewritten: each tool says when to use it and what it returns; each input says what it means, where the value comes from, an example and what leaving it out does. No change to tools, schemas or behaviour.
+- A full refund leaves `refundAmountCents` out; sending 0 is refused for newer sales.
+
 ## Registry 0.2.3 (server.json only; the npm package stays 0.2.2)
 - The registry entry `com.affitor/mcp` adds the hosted server as a remote: `https://mcp.affitor.com/mcp` (streamable HTTP, sign in with your Affitor account, read-only). Description and website point at the MCP docs.
 
diff --git a/packages/mcp/package.json b/packages/mcp/package.json
index ee3c100..119d144 100644
--- a/packages/mcp/package.json
+++ b/packages/mcp/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@affitor/mcp",
   "mcpName": "com.affitor/mcp",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "Model Context Protocol (MCP) stdio server for Affitor. Lets AI agents (Claude Desktop, Cursor and more) call Affitor affiliate-tracking tools.",
   "type": "module",
   "main": "./dist/index.js",
diff --git a/packages/mcp/server.json b/packages/mcp/server.json
index b9a61e4..40f5664 100644
--- a/packages/mcp/server.json
+++ b/packages/mcp/server.json
@@ -9,12 +9,12 @@
     "source": "github",
     "subfolder": "packages/mcp"
   },
-  "version": "0.2.3",
+  "version": "0.2.4",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@affitor/mcp",
-      "version": "0.2.2",
+      "version": "0.2.3",
       "transport": {
         "type": "stdio"
       },