@twitterapis/mcp 0.11.0 → 0.11.1

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changelog
 
+## 0.11.1 (2026-09-13)
+
+### Fixed
+- `twitter_update_profile`: an empty string CLEARS a field. The tool description said
+  the opposite, and 0.11.0 shipped that to npm. It was true of the API when written
+  and stopped being true when the handler was fixed the same day.
+
+### Notes
+- A PATCH, not a minor: the catalog is unchanged at 107 tools, 65 reads and 42 writes.
+  Only description text moves, which `scripts/prepublish-version-class.mjs` confirms.
+- The claim is now verified the only way that works on this endpoint: by sending a
+  value that CHANGES and reading the profile back. The previous check used a
+  byte-for-byte no-op, which is the one test that cannot fail, since the profile looks
+  identical whether the write applied or was silently dropped.
+- Why it matters that this was wrong rather than merely vague: the old text told a
+  model that `description: ""` was a harmless no-op. After the handler fix, that exact
+  call blanks the field. A description that is confidently wrong about a destructive
+  operation is worse than one that says nothing.
+- Separately, writes to this endpoint are sometimes accepted upstream and sometimes
+  refused, and only some refusals are classified honestly. That is a defect under
+  repair on the API side, not part of this tool's contract, so it is deliberately not
+  written into the description.
+
 ## 0.11.0 (2026-09-13)
 
 ### Added

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@twitterapis/mcp",
   "mcpName": "io.github.TwitterAPIs/twitterapis-mcp",
-  "version": "0.11.0",
+  "version": "0.11.1",
   "description": "Official MCP server for twitterapis.com, the Twitter/X API (search, users, followers, tweets, threads, lists, likes, bookmarks, DMs) plus write actions (post/like/retweet/follow) as native tools for Claude, Cursor, and any MCP client.",
   "repository": {
     "type": "git",

package/src/tools.js

@@ -1168,16 +1168,16 @@ export const TOOLS = [
     write: true,
     jsonBody: true,
     description:
-      "Change the display name, bio, location or link on your authenticated account's own X profile. This is a PARTIAL update: send only the fields you want to change and everything you omit keeps its current value, so passing just a name will NOT wipe the bio. An empty string does NOT clear a field: the API trims it and treats it exactly like an omitted field, so there is currently no way to blank a bio or a location through this tool. At least one of name, description, location or url is required, and a request whose only values are empty strings is refused with that same 400. It writes a real profile and takes effect immediately with no undo, so read the current values with twitter_user_info first if you may need to restore them. Requires an authenticated session behind your key. Returns ok and updated_fields, which echoes the field names you SENT rather than a diff against the previous profile.",
+      "Change the display name, bio, location or link on your authenticated account's own X profile. This is a PARTIAL update: send only the fields you want to change and everything you omit keeps its current value, so passing just a name will NOT wipe the bio. An empty string CLEARS that field, which is different from omitting it: \"\" blanks the value, an absent key leaves it alone. At least one of name, description, location or url is required, and a request whose only value is an empty string is a valid clear rather than an empty request. It writes a real profile and takes effect immediately with no undo, so read the current values with twitter_user_info first if you may need to restore them. Requires an authenticated session behind your key. Returns ok and updated_fields, which echoes the field names you SENT rather than a diff against the previous profile.",
     shape: {
       name: z.string().optional().describe(
         "Optional. New display name, up to 50 characters. Omit to leave it unchanged.",
       ),
       description: z.string().optional().describe(
-        "Optional. New bio. An empty string does NOT clear it: the API trims empty values and treats them as absent, so the current bio is left alone either way.",
+        "Optional. New bio. Send an EMPTY STRING to clear it; OMIT the field to leave it alone. Those are different.",
       ),
       location: z.string().optional().describe(
-        "Optional. New location text. Same rule: an empty string is treated as absent and leaves the current value alone.",
+        "Optional. New location text. Same rule: an empty string clears it, omitting the field leaves it alone.",
       ),
       url: z.string().optional().describe(
         "Optional. New profile link.",