twitterapi-io-mcp 1.3.1 → 1.4.0

package/README.md

@@ -1,6 +1,6 @@
 # twitterapi-io-mcp
 
-> Offline TwitterAPI.io documentation for Claude and AI assistants via MCP. 58 endpoints (with full method/params/body), 32 guides, 24 blog posts. No API key needed.
+> Offline TwitterAPI.io documentation for Claude and AI assistants via MCP. 65 endpoints (with full method/params/body), 32 guides, 24 blog posts. No API key needed.
 
 [![npm version](https://img.shields.io/npm/v/twitterapi-io-mcp.svg)](https://www.npmjs.com/package/twitterapi-io-mcp)
 [![npm downloads](https://img.shields.io/npm/dm/twitterapi-io-mcp.svg)](https://www.npmjs.com/package/twitterapi-io-mcp)
@@ -17,7 +17,7 @@ claude mcp add twitterapi-io -- npx -y twitterapi-io-mcp
 
 An MCP server that gives Claude, Cursor, VS Code Copilot, and other AI assistants **instant, offline access** to [TwitterAPI.io](https://twitterapi.io) documentation.
 
-- **58 API endpoints** with full HTTP method, body/query parameters, cURL examples, and response schemas
+- **65 API endpoints** with full HTTP method, body/query parameters, cURL examples, and response schemas
 - **32 guide pages** covering pricing, authentication, rate limits, webhooks, streaming
 - **24 blog posts** with tutorials and use cases
 - **All v2 write endpoints** documented with `login_cookies`, `proxy`, and body params
@@ -178,7 +178,7 @@ Here are real prompts that work well with this MCP server:
 - *"How do I upload media and create a tweet?"* — triggers sequential `get_twitterapi_endpoint` calls
 
 <details>
-<summary><strong>All 58 endpoints by category</strong></summary>
+<summary><strong>All 65 endpoints by category</strong></summary>
 
 | Category | Count | Endpoints |
 |----------|-------|-----------|
@@ -238,7 +238,7 @@ Restart your MCP client after adding the server config. Most clients (Claude Des
 │   Claude /   │ ◄──────────────────► │ twitterapi-io-mcp│
 │  Cursor /    │                      │                  │
 │  VS Code     │                      │  Bundled docs    │
-└─────────────┘                      │  (58 endpoints)  │
+└─────────────┘                      │  (65 endpoints)  │
                                      └──────────────────┘
                                        No network needed
 ```
@@ -273,7 +273,7 @@ npm run scrape  # Update docs snapshot from twitterapi.io
 
 ## Not using MCP?
 
-If your AI tool doesn't support MCP (like OpenClaw), use the **skill version** instead — a single markdown file with all 58 endpoints:
+If your AI tool doesn't support MCP (like OpenClaw), use the **skill version** instead — a single markdown file with all 65 endpoints:
 
 👉 **[twitterapi-io-skill](https://github.com/dorukardahan/twitterapi-io-skill)** — works with OpenClaw, Claude, GPT, Gemini, and any LLM.
 

package/data/docs.json

@@ -2253,7 +2253,33 @@
       "code_snippets": [
         "curl --request POST \\\n  --url 'https://api.twitterapi.io/twitter/delete_community_v2' \\\n  --header 'X-API-Key: <api-key>' \\\n  --header 'Content-Type: application/json'"
       ],
-      "raw_text": "Delete a community.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_cookie: The login cookie of the user.You can get the login_cookie 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"
+      "raw_text": "Delete a community.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_cookie: The login cookie of the user.You can get the login_cookie 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": [
+        {
+          "name": "login_cookies",
+          "type": "string",
+          "required": true,
+          "description": "Base64 encoded login cookies from /twitter/user_login_v2"
+        },
+        {
+          "name": "community_id",
+          "type": "string",
+          "required": true,
+          "description": "The community ID to delete"
+        },
+        {
+          "name": "community_name",
+          "type": "string",
+          "required": true,
+          "description": "The community name"
+        },
+        {
+          "name": "proxy",
+          "type": "string",
+          "required": true,
+          "description": "Residential proxy URL"
+        }
+      ]
     },
     "join_community_v2": {
       "name": "join_community_v2",
@@ -2682,7 +2708,35 @@
       "code_snippets": [
         "curl --request POST \\\n  --url 'https://api.twitterapi.io/oapi/tweet_filter/update_rule' \\\n  --header 'X-API-Key: <api-key>' \\\n  --header 'Content-Type: application/json'"
       ],
-      "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"
+      "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": [
+        {
+          "name": "rule_id",
+          "type": "string",
+          "required": true
+        },
+        {
+          "name": "tag",
+          "type": "string",
+          "required": true
+        },
+        {
+          "name": "value",
+          "type": "string",
+          "required": true
+        },
+        {
+          "name": "interval_seconds",
+          "type": "number",
+          "required": true
+        },
+        {
+          "name": "is_effect",
+          "type": "integer",
+          "required": false,
+          "description": "0=inactive, 1=active"
+        }
+      ]
     },
     "delete_webhook_rule": {
       "name": "delete_webhook_rule",
@@ -2724,7 +2778,14 @@
       "code_snippets": [
         "curl --request DELETE \\\n  --url 'https://api.twitterapi.io/oapi/tweet_filter/delete_rule' \\\n  --header 'X-API-Key: <api-key>' \\\n  --header 'Content-Type: application/json'"
       ],
-      "raw_text": "Delete a tweet filter rule. You must set all parameters. rule_id: ID of the rule to delete.Must be set"
+      "raw_text": "Delete a tweet filter rule. You must set all parameters. rule_id: ID of the rule to delete.Must be set",
+      "parameters": [
+        {
+          "name": "rule_id",
+          "type": "string",
+          "required": false
+        }
+      ]
     },
     "get_community_by_id": {
       "name": "get_community_by_id",
@@ -3587,6 +3648,277 @@
         "curl --request GET \\\n  --url 'https://api.twitterapi.io/twitter/list/tweets?listId=LIST_ID&cursor=CURSOR' \\\n  --header 'X-API-Key: <api-key>'"
       ],
       "raw_text": "Get tweets by list id. Each page returns exactly 20 tweets. Use cursor for pagination. listId: list id sinceTime: unix timestamp untilTime: unix timestamp includeReplies: include replies cursor: pagination cursor"
+    },
+    "user_login_v3": {
+      "name": "user_login_v3",
+      "url": "https://docs.twitterapi.io/api-reference/endpoint/user_login_v3",
+      "scraped_at": "2026-03-20T20:06:00.000Z",
+      "title": "V3 Login API",
+      "description": "V3 Login API - Log in using your email, username, password, and 2FA code. This is an asynchronous login method. After calling this API, the system will process your login request in the background.",
+      "method": "POST",
+      "path": "/twitter/user_login_v3",
+      "parameters": [],
+      "requestBody": {
+        "contentType": "application/json",
+        "schema": {
+          "type": "object",
+          "properties": {
+            "user_name": {
+              "type": "string",
+              "description": "Twitter username. Must be set.",
+              "required": true
+            },
+            "email": {
+              "type": "string",
+              "description": "Email address associated with the account. Must be set if cookie is empty.",
+              "required": false
+            },
+            "password": {
+              "type": "string",
+              "description": "The password of the user. Must be set if cookie is empty.",
+              "required": false
+            },
+            "totp_code": {
+              "type": "string",
+              "description": "The TOTP secret key for 2FA authentication. It is a 10-character string.",
+              "required": false
+            },
+            "cookie": {
+              "type": "string",
+              "description": "Optional. Pre-existing cookie string to resume a previous session.",
+              "required": false
+            },
+            "proxy": {
+              "type": "string",
+              "description": "The proxy to use. Must use high-quality residential proxies.",
+              "required": true
+            }
+          },
+          "required": [
+            "user_name",
+            "proxy"
+          ]
+        }
+      },
+      "curl": "curl -s -X POST \"https://api.twitterapi.io/twitter/user_login_v3\" -H \"X-API-Key: $TWITTERAPI_IO_KEY\" -H \"Content-Type: application/json\" -d '{\"user_name\": \"USERNAME\", \"email\": \"EMAIL\", \"password\": \"PASSWORD\", \"proxy\": \"http://user:pass@host:port\"}'"
+    },
+    "send_tweet_v3": {
+      "name": "send_tweet_v3",
+      "url": "https://docs.twitterapi.io/api-reference/endpoint/send_tweet_v3",
+      "scraped_at": "2026-03-20T20:06:00.000Z",
+      "title": "V3 Send Tweet API",
+      "description": "V3 Send Tweet API - Send a tweet using your username. This is an asynchronous method that queues your tweet for posting. You must have logged in via user_login_v3 first.",
+      "method": "POST",
+      "path": "/twitter/send_tweet_v3",
+      "parameters": [],
+      "requestBody": {
+        "contentType": "application/json",
+        "schema": {
+          "type": "object",
+          "properties": {
+            "user_name": {
+              "type": "string",
+              "description": "Twitter username. Must be set.",
+              "required": true
+            },
+            "text": {
+              "type": "string",
+              "description": "The text content of the tweet. Must be set.",
+              "required": true
+            },
+            "media_data_base64": {
+              "type": "string",
+              "description": "Optional. Base64 encoded media data.",
+              "required": false
+            },
+            "media_type": {
+              "type": "string",
+              "description": "Optional. MIME type: image/jpeg, image/png, image/gif, video/mp4",
+              "required": false
+            },
+            "community_id": {
+              "type": "string",
+              "description": "Optional. Community ID to post to.",
+              "required": false
+            }
+          },
+          "required": [
+            "user_name",
+            "text"
+          ]
+        }
+      },
+      "curl": "curl -s -X POST \"https://api.twitterapi.io/twitter/send_tweet_v3\" -H \"X-API-Key: $TWITTERAPI_IO_KEY\" -H \"Content-Type: application/json\" -d '{\"user_name\": \"USERNAME\", \"text\": \"Hello world!\"}'"
+    },
+    "like_tweet_v3": {
+      "name": "like_tweet_v3",
+      "url": "https://docs.twitterapi.io/api-reference/endpoint/like_tweet_v3",
+      "scraped_at": "2026-03-20T20:06:00.000Z",
+      "title": "V3 Like Tweet API",
+      "description": "V3 Like Tweet API - Like a tweet using your username. You must have logged in via user_login_v3 first. Trial operation price: $0.002 per call.",
+      "method": "POST",
+      "path": "/twitter/like_tweet_v3",
+      "parameters": [],
+      "requestBody": {
+        "contentType": "application/json",
+        "schema": {
+          "type": "object",
+          "properties": {
+            "user_name": {
+              "type": "string",
+              "description": "Twitter username. Must be set.",
+              "required": true
+            },
+            "tweet_id": {
+              "type": "string",
+              "description": "The ID of the tweet to like. Must be set.",
+              "required": true
+            }
+          },
+          "required": [
+            "user_name",
+            "tweet_id"
+          ]
+        }
+      },
+      "curl": "curl -s -X POST \"https://api.twitterapi.io/twitter/like_tweet_v3\" -H \"X-API-Key: $TWITTERAPI_IO_KEY\" -H \"Content-Type: application/json\" -d '{\"user_name\": \"USERNAME\", \"tweet_id\": \"TWEET_ID\"}'"
+    },
+    "retweet_v3": {
+      "name": "retweet_v3",
+      "url": "https://docs.twitterapi.io/api-reference/endpoint/retweet_v3",
+      "scraped_at": "2026-03-20T20:06:00.000Z",
+      "title": "V3 Retweet API",
+      "description": "V3 Retweet API - Retweet a tweet using your username. You must have logged in via user_login_v3 first. Trial operation price: $0.002 per call.",
+      "method": "POST",
+      "path": "/twitter/retweet_v3",
+      "parameters": [],
+      "requestBody": {
+        "contentType": "application/json",
+        "schema": {
+          "type": "object",
+          "properties": {
+            "user_name": {
+              "type": "string",
+              "description": "Twitter username. Must be set.",
+              "required": true
+            },
+            "tweet_id": {
+              "type": "string",
+              "description": "The ID of the tweet to retweet. Must be set.",
+              "required": true
+            }
+          },
+          "required": [
+            "user_name",
+            "tweet_id"
+          ]
+        }
+      },
+      "curl": "curl -s -X POST \"https://api.twitterapi.io/twitter/retweet_v3\" -H \"X-API-Key: $TWITTERAPI_IO_KEY\" -H \"Content-Type: application/json\" -d '{\"user_name\": \"USERNAME\", \"tweet_id\": \"TWEET_ID\"}'"
+    },
+    "update_profile_v3": {
+      "name": "update_profile_v3",
+      "url": "https://docs.twitterapi.io/api-reference/endpoint/update_profile_v3",
+      "scraped_at": "2026-03-20T20:06:00.000Z",
+      "title": "V3 Update Profile API",
+      "description": "V3 Update Profile API - Update your X profile information. Only non-empty fields will be updated. You must have logged in via user_login_v3 first.",
+      "method": "PUT",
+      "path": "/twitter/update_profile_v3",
+      "parameters": [],
+      "requestBody": {
+        "contentType": "application/json",
+        "schema": {
+          "type": "object",
+          "properties": {
+            "user_name": {
+              "type": "string",
+              "description": "Twitter username. Must be set.",
+              "required": true
+            },
+            "name": {
+              "type": "string",
+              "description": "Optional. Display name.",
+              "required": false
+            },
+            "bio": {
+              "type": "string",
+              "description": "Optional. Profile bio/description.",
+              "required": false
+            },
+            "location": {
+              "type": "string",
+              "description": "Optional. Location.",
+              "required": false
+            },
+            "website": {
+              "type": "string",
+              "description": "Optional. Website URL.",
+              "required": false
+            },
+            "avatar": {
+              "type": "string",
+              "description": "Optional. Avatar image (base64 or URL).",
+              "required": false
+            },
+            "banner": {
+              "type": "string",
+              "description": "Optional. Banner image (base64 or URL).",
+              "required": false
+            }
+          },
+          "required": [
+            "user_name"
+          ]
+        }
+      },
+      "curl": "curl -s -X PUT \"https://api.twitterapi.io/twitter/update_profile_v3\" -H \"X-API-Key: $TWITTERAPI_IO_KEY\" -H \"Content-Type: application/json\" -d '{\"user_name\": \"USERNAME\", \"name\": \"Display Name\", \"bio\": \"Bio text\"}'"
+    },
+    "delete_my_x_account_v3": {
+      "name": "delete_my_x_account_v3",
+      "url": "https://docs.twitterapi.io/api-reference/endpoint/delete_my_x_account_v3",
+      "scraped_at": "2026-03-20T20:06:00.000Z",
+      "title": "V3 Delete Account API",
+      "description": "Remove your X account cookie from the system. This will delete the account data that was logged in via user_login_v3.",
+      "method": "DELETE",
+      "path": "/twitter/delete_my_x_account_v3",
+      "parameters": [],
+      "requestBody": {
+        "contentType": "application/json",
+        "schema": {
+          "type": "object",
+          "properties": {
+            "user_name": {
+              "type": "string",
+              "description": "Twitter username. Must be set.",
+              "required": true
+            }
+          },
+          "required": [
+            "user_name"
+          ]
+        }
+      },
+      "curl": "curl -s -X DELETE \"https://api.twitterapi.io/twitter/delete_my_x_account_v3\" -H \"X-API-Key: $TWITTERAPI_IO_KEY\" -H \"Content-Type: application/json\" -d '{\"user_name\": \"USERNAME\"}'"
+    },
+    "get_my_x_account_detail_v3": {
+      "name": "get_my_x_account_detail_v3",
+      "url": "https://docs.twitterapi.io/api-reference/endpoint/get_my_x_account_detail_v3",
+      "scraped_at": "2026-03-20T20:06:00.000Z",
+      "title": "V3 Get Account Detail API",
+      "description": "V3 Get Account Detail API - Get the details of your X account that was logged in via user_login_v3. Once status is Active, then you can use the account to post tweets, etc.",
+      "method": "GET",
+      "path": "/twitter/get_my_x_account_detail_v3",
+      "parameters": [
+        {
+          "name": "user_name",
+          "in": "query",
+          "type": "string",
+          "format": "string",
+          "required": true,
+          "description": "Twitter username. Must be set. The user must have been logged in via user_login_v3."
+        }
+      ],
+      "curl": "curl -s \"https://api.twitterapi.io/twitter/get_my_x_account_detail_v3?user_name=USERNAME\" -H \"X-API-Key: $TWITTERAPI_IO_KEY\""
     }
   },
   "pages": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "twitterapi-io-mcp",
-  "version": "1.3.1",
+  "version": "1.4.0",
   "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",