twitterapi-io-mcp 1.5.8 → 1.5.10

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+## [1.5.10](https://github.com/dorukardahan/twitterapi-io-mcp/compare/v1.5.9...v1.5.10) (2026-04-27)
+
+
+### Bug Fixes
+
+* sync body parameter placement with live OpenAPI ([8f45a44](https://github.com/dorukardahan/twitterapi-io-mcp/commit/8f45a44905e094b21e51f01b64f9e1ce1a538e07))
+
+## [1.5.9](https://github.com/dorukardahan/twitterapi-io-mcp/compare/v1.5.8...v1.5.9) (2026-04-25)
+
+
+### Bug Fixes
+
+* sync live OpenAPI write params ([4a9f8b4](https://github.com/dorukardahan/twitterapi-io-mcp/commit/4a9f8b4ef02c69e964634d780dae52a77a656a27))
+
 ## [1.5.8](https://github.com/dorukardahan/twitterapi-io-mcp/compare/v1.5.7...v1.5.8) (2026-04-21)
 
 
@@ -9,7 +23,9 @@
 
 ### Bug Fixes
 
-* align community v2 auth fields with live OpenAPI (`login_cookies`), mark upload_media_v2 as multipart/form-data, and refresh lockfile via `npm audit fix --package-lock-only`
+* sync `create_tweet_v2`, `send_dm_to_user`, and `upload_image` request params with the live OpenAPI
+* sync body/query placement for `delete_rule`, `update_rule`, `delete_community_v2`, `update_avatar_v2`, `update_banner_v2`, `update_profile_v2`, and `upload_media_v2`
+* add `npm audit --audit-level=high` back to `prepublishOnly` and pin transitive `npm` to 11.13.0 via `overrides`
 
 ## [1.5.7](https://github.com/dorukardahan/twitterapi-io-mcp/compare/v1.5.6...v1.5.7) (2026-04-19)
 

package/data/docs.json

@@ -1577,7 +1577,17 @@
         "media_ids": {
           "type": "array",
           "required": false,
-          "description": "The ids of the media to post.Optional.You can get the media_ids from /twitter/upload_image_v2 (to be developed)"
+          "description": "List of media IDs (strings) to attach. Optional. Obtain each from /twitter/upload_media_v2."
+        },
+        "quote_tweet_id": {
+          "type": "string",
+          "required": false,
+          "description": "ID of a tweet to quote. Optional. Alternative to attachment_url."
+        },
+        "schedule_for": {
+          "type": "string",
+          "required": false,
+          "description": "Schedule the tweet to be sent at a future time. Optional. Format: ISO-8601 with milliseconds, e.g. 2026-01-20T10:00:00.000Z"
         },
         "proxy": {
           "type": "string",
@@ -1619,7 +1629,17 @@
         "media_ids": {
           "type": "array",
           "required": false,
-          "description": "The ids of the media to post.Optional.You can get the media_ids from /twitter/upload_image_v2 (to be developed)"
+          "description": "List of media IDs (strings) to attach. Optional. Obtain each from /twitter/upload_media_v2."
+        },
+        "quote_tweet_id": {
+          "type": "string",
+          "required": false,
+          "description": "ID of a tweet to quote. Optional. Alternative to attachment_url."
+        },
+        "schedule_for": {
+          "type": "string",
+          "required": false,
+          "description": "Schedule the tweet to be sent at a future time. Optional. Format: ISO-8601 with milliseconds, e.g. 2026-01-20T10:00:00.000Z"
         },
         "proxy": {
           "type": "string",
@@ -1645,7 +1665,89 @@
       "code_snippets": [
         "curl --request POST \\\n  --url 'https://api.twitterapi.io/twitter/create_tweet_v2' \\\n  --header 'X-API-Key: <api-key>' \\\n  --header 'Content-Type: application/json'"
       ],
-      "raw_text": "Create a tweet.You must set the login_cookie.You can get the login_cookie from /twitter/user_login_v2.Trial operation price: $0.003 per call.  login_cookies: The login cookies of the user.You can get the login_cookie from /twitter/user_login_v2.Must be set tweet_text: The text of the tweet.Must be set reply_to_tweet_id: The id of the tweet to reply to.Optional attachment_url: The url of quote tweet.Optional.eg.https://x.com/sama/status/1947640330318156074 community_id: The id of the community to post to.Optional is_note_tweet: If this option is set to True, tweets longer than 280 characters can be posted (Twitter Premium only). media_ids: The ids of the media to post.Optional.You can get the media_ids from /twitter/upload_image_v2 (to be developed) proxy: The proxy to use.Please use high-quality residential proxies and avoid free proxies.Required.Example: http://username:password@ip:port . You can get proxy from: https://www.webshare.io/?referral_code=4e0q1n00a504"
+      "raw_text": "Create a tweet.You must set the login_cookie.You can get the login_cookie from /twitter/user_login_v2.Trial operation price: $0.003 per call.  login_cookies: The login cookies of the user.You can get the login_cookie from /twitter/user_login_v2.Must be set tweet_text: The text of the tweet.Must be set reply_to_tweet_id: The id of the tweet to reply to.Optional attachment_url: The url of quote tweet.Optional.eg.https://x.com/sama/status/1947640330318156074 community_id: The id of the community to post to.Optional is_note_tweet: If this option is set to True, tweets longer than 280 characters can be posted (Twitter Premium only). media_ids: The ids of the media to post.Optional.You can get the media_ids from /twitter/upload_image_v2 (to be developed) proxy: The proxy to use.Please use high-quality residential proxies and avoid free proxies.Required.Example: http://username:password@ip:port . You can get proxy from: https://www.webshare.io/?referral_code=4e0q1n00a504",
+      "parameters": [
+        {
+          "name": "login_cookies",
+          "in": "body",
+          "type": "string",
+          "format": null,
+          "required": true,
+          "description": "The login cookies of the user.You can get the login_cookie from /twitter/user_login_v2.Must be set"
+        },
+        {
+          "name": "tweet_text",
+          "in": "body",
+          "type": "string",
+          "format": null,
+          "required": true,
+          "description": "The text of the tweet.Must be set"
+        },
+        {
+          "name": "reply_to_tweet_id",
+          "in": "body",
+          "type": "string",
+          "format": null,
+          "required": false,
+          "description": "The id of the tweet to reply to.Optional"
+        },
+        {
+          "name": "attachment_url",
+          "in": "body",
+          "type": "string",
+          "format": null,
+          "required": false,
+          "description": "The url of quote tweet.Optional.eg.https://x.com/sama/status/1947640330318156074"
+        },
+        {
+          "name": "community_id",
+          "in": "body",
+          "type": "string",
+          "format": null,
+          "required": false,
+          "description": "The id of the community to post to.Optional"
+        },
+        {
+          "name": "is_note_tweet",
+          "in": "body",
+          "type": "boolean",
+          "format": null,
+          "required": false,
+          "description": "If this option is set to True, tweets longer than 280 characters can be posted (Twitter Premium only)."
+        },
+        {
+          "name": "media_ids",
+          "in": "body",
+          "type": "array",
+          "format": null,
+          "required": false,
+          "description": "List of media IDs (strings) to attach. Optional. Obtain each from /twitter/upload_media_v2."
+        },
+        {
+          "name": "quote_tweet_id",
+          "in": "body",
+          "type": "string",
+          "format": null,
+          "required": false,
+          "description": "ID of a tweet to quote. Optional. Alternative to attachment_url."
+        },
+        {
+          "name": "schedule_for",
+          "in": "body",
+          "type": "string",
+          "format": null,
+          "required": false,
+          "description": "Schedule the tweet to be sent at a future time. Optional. Format: ISO-8601 with milliseconds, e.g. 2026-01-20T10:00:00.000Z"
+        },
+        {
+          "name": "proxy",
+          "in": "body",
+          "type": "string",
+          "format": null,
+          "required": true,
+          "description": "The proxy to use.Please use high-quality residential proxies and avoid free proxies.Required.Example: http://username:password@ip:port . You can get proxy from: https://www.webshare.io/?referral_code=4e0q1n00a504"
+        }
+      ]
     },
     "upload_media_v2": {
       "name": "upload_media_v2",
@@ -1721,24 +1823,28 @@
       "contentType": "multipart/form-data",
       "parameters": [
         {
+          "in": "body",
           "name": "file",
           "type": "binary",
           "required": true,
           "description": "The media file to upload (image/video). Use multipart/form-data."
         },
         {
+          "in": "body",
           "name": "login_cookies",
           "type": "string",
           "required": true,
           "description": "The login cookies from /twitter/user_login_v2"
         },
         {
+          "in": "body",
           "name": "proxy",
           "type": "string",
           "required": true,
           "description": "Residential proxy URL. Example: http://username:password@ip:port"
         },
         {
+          "in": "body",
           "name": "is_long_video",
           "type": "boolean",
           "required": false,
@@ -2118,10 +2224,10 @@
           "required": true,
           "description": "The text of the direct message.Must be set"
         },
-        "media_ids": {
-          "type": "array",
+        "media_id": {
+          "type": "string",
           "required": false,
-          "description": "The ids of the media to post.Optional.You can get the media_ids from /twitter/upload_image_v2 (to be developed)"
+          "description": "ID of a single media asset to attach. Optional. Obtain from /twitter/upload_media_v2."
         },
         "proxy": {
           "type": "string",
@@ -2150,10 +2256,10 @@
           "required": true,
           "description": "The text of the direct message.Must be set"
         },
-        "media_ids": {
-          "type": "array",
+        "media_id": {
+          "type": "string",
           "required": false,
-          "description": "The ids of the media to post.Optional.You can get the media_ids from /twitter/upload_image_v2 (to be developed)"
+          "description": "ID of a single media asset to attach. Optional. Obtain from /twitter/upload_media_v2."
         },
         "proxy": {
           "type": "string",
@@ -2184,7 +2290,57 @@
       "code_snippets": [
         "curl --request POST \\\n  --url 'https://api.twitterapi.io/twitter/send_dm_to_user' \\\n  --header 'X-API-Key: <api-key>' \\\n  --header 'Content-Type: application/json'"
       ],
-      "raw_text": "Send a direct message to a user.You must set the login_cookie..You can get the login_cookie from /twitter/user_login_v2.You can only send DMs to those who have enabled DMs. Sometimes it may fail, so be prepared to retry.Trial operation price: $0.003 per call.  login_cookies: The login cookie of the user.You can get the login_cookies from /twitter/user_login_v2.Must be set user_id: The id of the user to send the direct message to.Must be set text: The text of the direct message.Must be set media_ids: The ids of the media to post.Optional.You can get the media_ids from /twitter/upload_image_v2 (to be developed) proxy: The proxy to use.Please use high-quality residential proxies and avoid free proxies.Required.Example: http://username:password@ip:port . You can get proxy from: https://www.webshare.io/?referral_code=4e0q1n00a504 reply_to_message_id: The id of the message to reply to.Optional"
+      "raw_text": "Send a direct message to a user.You must set the login_cookie..You can get the login_cookie from /twitter/user_login_v2.You can only send DMs to those who have enabled DMs. Sometimes it may fail, so be prepared to retry.Trial operation price: $0.003 per call.  login_cookies: The login cookie of the user.You can get the login_cookies from /twitter/user_login_v2.Must be set user_id: The id of the user to send the direct message to.Must be set text: The text of the direct message.Must be set media_ids: The ids of the media to post.Optional.You can get the media_ids from /twitter/upload_image_v2 (to be developed) proxy: The proxy to use.Please use high-quality residential proxies and avoid free proxies.Required.Example: http://username:password@ip:port . You can get proxy from: https://www.webshare.io/?referral_code=4e0q1n00a504 reply_to_message_id: The id of the message to reply to.Optional",
+      "parameters": [
+        {
+          "name": "login_cookies",
+          "in": "body",
+          "type": "string",
+          "format": null,
+          "required": true,
+          "description": "The login cookie of the user.You can get the login_cookies from /twitter/user_login_v2.Must be set"
+        },
+        {
+          "name": "user_id",
+          "in": "body",
+          "type": "string",
+          "format": null,
+          "required": true,
+          "description": "The id of the user to send the direct message to.Must be set"
+        },
+        {
+          "name": "text",
+          "in": "body",
+          "type": "string",
+          "format": null,
+          "required": true,
+          "description": "The text of the direct message.Must be set"
+        },
+        {
+          "name": "media_id",
+          "in": "body",
+          "type": "string",
+          "format": null,
+          "required": false,
+          "description": "ID of a single media asset to attach. Optional. Obtain from /twitter/upload_media_v2."
+        },
+        {
+          "name": "proxy",
+          "in": "body",
+          "type": "string",
+          "format": null,
+          "required": true,
+          "description": "The proxy to use.Please use high-quality residential proxies and avoid free proxies.Required.Example: http://username:password@ip:port . You can get proxy from: https://www.webshare.io/?referral_code=4e0q1n00a504"
+        },
+        {
+          "name": "reply_to_message_id",
+          "in": "body",
+          "type": "string",
+          "format": null,
+          "required": false,
+          "description": "The id of the message to reply to.Optional"
+        }
+      ]
     },
     "create_community_v2": {
       "name": "create_community_v2",
@@ -2327,24 +2483,28 @@
       "raw_text": "Delete a community.You must set the login_cookies.You can get the login_cookies from /twitter/user_login_v2.Trial operation price: $0.003 per call.  login_cookies: The login cookie of the user.You can get the login_cookies from /twitter/user_login_v2.Must be set community_id: The id of the community to join.Must be set community_name: The name of the community to delete.Must be set proxy: The proxy to use.Please use high-quality residential proxies and avoid free proxies.Required.Example: http://username:password@ip:port . You can get proxy from: https://www.webshare.io/?referral_code=4e0q1n00a504",
       "parameters": [
         {
+          "in": "body",
           "name": "login_cookies",
           "type": "string",
           "required": true,
           "description": "Base64 encoded login cookies from /twitter/user_login_v2"
         },
         {
+          "in": "body",
           "name": "community_id",
           "type": "string",
           "required": true,
           "description": "The community ID to delete"
         },
         {
+          "in": "body",
           "name": "community_name",
           "type": "string",
           "required": true,
           "description": "The community name"
         },
         {
+          "in": "body",
           "name": "proxy",
           "type": "string",
           "required": true,
@@ -2784,26 +2944,31 @@
       "raw_text": "Update a tweet filter rule. You must set all parameters. rule_id: ID of the rule to update.Must be set tag: Custom tag to identify the rule.Must be set.Max length is 255 value: Rule to filter tweets.eg \"from:elonmusk OR from:kaitoeasyapi\".Must be set.Max length is 255 interval_seconds: Interval to check tweets.Must be set.Min value is 0.1.Max value is 86400 () is_effect: Whether the rule is effective.Must be set.1 means effective, 0 means not effective.Default value is 0",
       "parameters": [
         {
+          "in": "body",
           "name": "rule_id",
           "type": "string",
           "required": true
         },
         {
+          "in": "body",
           "name": "tag",
           "type": "string",
           "required": true
         },
         {
+          "in": "body",
           "name": "value",
           "type": "string",
           "required": true
         },
         {
+          "in": "body",
           "name": "interval_seconds",
           "type": "number",
           "required": true
         },
         {
+          "in": "body",
           "name": "is_effect",
           "type": "integer",
           "required": false,
@@ -2854,6 +3019,7 @@
       "raw_text": "Delete a tweet filter rule. You must set all parameters. rule_id: ID of the rule to delete.Must be set",
       "parameters": [
         {
+          "in": "body",
           "name": "rule_id",
           "type": "string",
           "required": false
@@ -3267,18 +3433,21 @@
       "contentType": "multipart/form-data",
       "parameters": [
         {
+          "in": "body",
           "name": "file",
           "type": "binary",
           "required": true,
           "description": "The avatar image file to upload. Recommended size: 400x400 pixels. Maximum file size: 700KB. Supported formats: JPG, PNG"
         },
         {
+          "in": "body",
           "name": "login_cookies",
           "type": "string",
           "required": true,
           "description": "Base64 encoded login cookies from /twitter/user_login_v2"
         },
         {
+          "in": "body",
           "name": "proxy",
           "type": "string",
           "required": true,
@@ -3312,18 +3481,21 @@
       "contentType": "multipart/form-data",
       "parameters": [
         {
+          "in": "body",
           "name": "file",
           "type": "binary",
           "required": true,
           "description": "The banner image file to upload. Recommended size: 1500x500 pixels. Maximum file size: 2MB. Supported formats: JPG, PNG"
         },
         {
+          "in": "body",
           "name": "login_cookies",
           "type": "string",
           "required": true,
           "description": "Base64 encoded login cookies from /twitter/user_login_v2"
         },
         {
+          "in": "body",
           "name": "proxy",
           "type": "string",
           "required": true,
@@ -3420,36 +3592,42 @@
       "raw_text": "Update your Twitter profile information. You must set the login_cookie. You can get the login_cookie from /twitter/user_login_v2. Trial operation price: $0.003 per call. login_cookies: Base64 encoded login cookies of the user. You can get the login_cookie from /twitter/user_login_v2. Required proxy: The proxy to use. Please use high-quality residential proxies and avoid free proxies. Required. Example: http://username:password@ip:port name: Display name (maximum 50 characters) description: Bio/description (maximum 160 characters) location: Location (maximum 30 characters) url: Website URL",
       "parameters": [
         {
+          "in": "body",
           "name": "login_cookies",
           "type": "string",
           "required": true,
           "description": "Base64 encoded login cookies from /twitter/user_login_v2"
         },
         {
+          "in": "body",
           "name": "proxy",
           "type": "string",
           "required": true,
           "description": "Residential proxy URL"
         },
         {
+          "in": "body",
           "name": "name",
           "type": "string",
           "required": false,
           "description": "Display name (maximum 50 characters)"
         },
         {
+          "in": "body",
           "name": "description",
           "type": "string",
           "required": false,
           "description": "Bio/description (maximum 160 characters)"
         },
         {
+          "in": "body",
           "name": "location",
           "type": "string",
           "required": false,
           "description": "Location (maximum 30 characters)"
         },
         {
+          "in": "body",
           "name": "url",
           "type": "string",
           "required": false,
@@ -4120,7 +4298,7 @@
           "name": "auth_session",
           "in": "body",
           "type": "string",
-          "format": "string",
+          "format": null,
           "required": true,
           "description": "The session of the login. It's returned by /twitter/login_by_2fa"
         },
@@ -4128,15 +4306,15 @@
           "name": "image_url",
           "in": "body",
           "type": "string",
-          "format": "string",
-          "required": false,
+          "format": null,
+          "required": true,
           "description": "The url of the image to upload"
         },
         {
           "name": "proxy",
           "in": "body",
           "type": "string",
-          "format": "string",
+          "format": null,
           "required": true,
           "description": "The proxy to use.Please use high-quality residential proxies and avoid free proxies.Required.Example: http://username:password@ip:port"
         }
@@ -4147,7 +4325,41 @@
       "code_snippets": [
         "curl --request POST \\\n  --url 'https://api.twitterapi.io/twitter/upload_image' \\\n  --header 'X-API-Key: <api-key>' \\\n  --header 'Content-Type: application/json'"
       ],
-      "raw_text": "upload image to twitter.Need to login first. Trial operation price: $0.001 per call. auth_session: The session of the login. It's returned by /twitter/login_by_2fa image_url: The url of the image to upload proxy: The proxy to use.Please use high-quality residential proxies and avoid free proxies.Required.Example: http://username:password@ip:port"
+      "raw_text": "upload image to twitter.Need to login first. Trial operation price: $0.001 per call. auth_session: The session of the login. It's returned by /twitter/login_by_2fa image_url: The url of the image to upload proxy: The proxy to use.Please use high-quality residential proxies and avoid free proxies.Required.Example: http://username:password@ip:port",
+      "body": {
+        "auth_session": {
+          "type": "string",
+          "required": true,
+          "description": "The session of the login. It's returned by /twitter/login_by_2fa"
+        },
+        "image_url": {
+          "type": "string",
+          "required": true,
+          "description": "The url of the image to upload"
+        },
+        "proxy": {
+          "type": "string",
+          "required": true,
+          "description": "The proxy to use.Please use high-quality residential proxies and avoid free proxies.Required.Example: http://username:password@ip:port"
+        }
+      },
+      "body_parameters": {
+        "auth_session": {
+          "type": "string",
+          "required": true,
+          "description": "The session of the login. It's returned by /twitter/login_by_2fa"
+        },
+        "image_url": {
+          "type": "string",
+          "required": true,
+          "description": "The url of the image to upload"
+        },
+        "proxy": {
+          "type": "string",
+          "required": true,
+          "description": "The proxy to use.Please use high-quality residential proxies and avoid free proxies.Required.Example: http://username:password@ip:port"
+        }
+      }
     },
     "create_tweet": {
       "name": "create_tweet",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "twitterapi-io-mcp",
-  "version": "1.5.8",
+  "version": "1.5.10",
   "mcpName": "io.github.dorukardahan/twitterapi-io-mcp",
   "description": "TwitterAPI.io MCP server providing offline access to docs (endpoints, pages, blogs) for Claude and other AI assistants",
   "main": "index.js",
@@ -14,7 +14,7 @@
     "build": "echo 'No build step required - pure ES Module'",
     "scrape": "node scrape-all.cjs",
     "generate:docs": "node generate-context7-docs.cjs",
-    "prepublishOnly": "npm test"
+    "prepublishOnly": "npm audit --audit-level=high && npm test"
   },
   "keywords": [
     "mcp",
@@ -71,5 +71,8 @@
     "@semantic-release/exec": "^7.1.0",
     "@semantic-release/git": "^10.0.1",
     "semantic-release": "^25.0.3"
+  },
+  "overrides": {
+    "npm": "11.13.0"
   }
 }