twitterapi-io-mcp 1.5.1 → 1.5.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/CHANGELOG.md +562 -0
  2. package/data/docs.json +6 -6
  3. package/package.json +2 -1
package/CHANGELOG.md ADDED
@@ -0,0 +1,562 @@
1
+ ## [1.5.7](https://github.com/dorukardahan/twitterapi-io-mcp/compare/v1.5.6...v1.5.7) (2026-04-19)
2
+
3
+
4
+ ### Bug Fixes
5
+
6
+ * use npm@11 instead of hardcoded npm@11.6.0 in publish.yml ([effa047](https://github.com/dorukardahan/twitterapi-io-mcp/commit/effa047ad21ff2f661d32bba68f79595de081256))
7
+
8
+ ## [1.5.6](https://github.com/dorukardahan/twitterapi-io-mcp/compare/v1.5.5...v1.5.6) (2026-04-14)
9
+
10
+
11
+ ### Bug Fixes
12
+
13
+ * **ci:** remove npm audit from prepublishOnly (transitive CVEs block publish) ([cd9945d](https://github.com/dorukardahan/twitterapi-io-mcp/commit/cd9945d09a7e9c5ac398de031e1bf3d639980f3e))
14
+
15
+ ## [1.5.5](https://github.com/dorukardahan/twitterapi-io-mcp/compare/v1.5.4...v1.5.5) (2026-04-14)
16
+
17
+
18
+ ### Bug Fixes
19
+
20
+ * **ci:** remove broken npm upgrade step on Node 22.22.2 toolcache ([fdc39f9](https://github.com/dorukardahan/twitterapi-io-mcp/commit/fdc39f954719b1bfa636f37e5ba421c0715cea41))
21
+
22
+ ## [1.5.4](https://github.com/dorukardahan/twitterapi-io-mcp/compare/v1.5.3...v1.5.4) (2026-04-14)
23
+
24
+
25
+ ### Bug Fixes
26
+
27
+ * **ci:** use npm@latest instead of npm@11 to avoid MODULE_NOT_FOUND promise-retry ([1ce75ce](https://github.com/dorukardahan/twitterapi-io-mcp/commit/1ce75cefcbaf7a30fe4baa25872654f989bf6732))
28
+
29
+ ## [1.5.3](https://github.com/dorukardahan/twitterapi-io-mcp/compare/v1.5.2...v1.5.3) (2026-04-14)
30
+
31
+
32
+ ### Bug Fixes
33
+
34
+ * recommend since_time/until_time over since/until in advanced_search ([3ec2d5a](https://github.com/dorukardahan/twitterapi-io-mcp/commit/3ec2d5a268f8d54711d1ae8550ff2669ca40592c))
35
+
36
+ ## [1.5.2](https://github.com/dorukardahan/twitterapi-io-mcp/compare/v1.5.1...v1.5.2) (2026-04-13)
37
+
38
+
39
+ ### Bug Fixes
40
+
41
+ * tighten release hygiene ([96c5826](https://github.com/dorukardahan/twitterapi-io-mcp/commit/96c5826c937fa77cb1a42c6f2d76c4e65e33f505))
42
+
43
+ ## 1.5.2
44
+
45
+ - fix: add audit to prepublishOnly and include CHANGELOG.md in package files
46
+ - fix: relax CI npm upgrade from pinned npm@11.6.0 to npm@11
47
+
48
+ ## [1.5.1](https://github.com/dorukardahan/twitterapi-io-mcp/compare/v1.5.0...v1.5.1) (2026-04-11)
49
+
50
+
51
+ ### Bug Fixes
52
+
53
+ * add missing body/parameters docs for 9 endpoints ([a38ab91](https://github.com/dorukardahan/twitterapi-io-mcp/commit/a38ab9133e8f282d82573cd87b8b4b8b4903210e))
54
+
55
+ # [1.5.0](https://github.com/dorukardahan/twitterapi-io-mcp/compare/v1.4.1...v1.5.0) (2026-04-10)
56
+
57
+
58
+ ### Features
59
+
60
+ * add 9 active openapi endpoints ([7cd9646](https://github.com/dorukardahan/twitterapi-io-mcp/commit/7cd964644e05fe0fd4ea1c3d01ef7de951ce98c0))
61
+
62
+ ## [1.4.1](https://github.com/dorukardahan/twitterapi-io-mcp/compare/v1.4.0...v1.4.1) (2026-03-21)
63
+
64
+
65
+ ### Bug Fixes
66
+
67
+ * remove offline V3 endpoints ([1741ede](https://github.com/dorukardahan/twitterapi-io-mcp/commit/1741edea7dca70f6538eb4fe850a3b5b014443b2))
68
+
69
+ # [1.4.0](https://github.com/dorukardahan/twitterapi-io-mcp/compare/v1.3.2...v1.4.0) (2026-03-20)
70
+
71
+
72
+ ### Features
73
+
74
+ * remove 7 offline endpoints from docs.json (58 total) ([215dea6](https://github.com/dorukardahan/twitterapi-io-mcp/commit/215dea6e78eb143e90903ace90cc09fd19e15c69))
75
+
76
+ ## [1.3.2](https://github.com/dorukardahan/twitterapi-io-mcp/compare/v1.3.1...v1.3.2) (2026-03-17)
77
+
78
+
79
+ ### Bug Fixes
80
+
81
+ * add missing params for delete_community, update_rule, delete_rule in docs.json ([9988259](https://github.com/dorukardahan/twitterapi-io-mcp/commit/9988259565558fb7cb9925f7f7b107d7ad55f526))
82
+
83
+ ## [1.3.1](https://github.com/dorukardahan/twitterapi-io-mcp/compare/v1.3.0...v1.3.1) (2026-03-17)
84
+
85
+
86
+ ### Bug Fixes
87
+
88
+ * correct avatar/banner to multipart/form-data upload, add update_profile params and bug note ([4284789](https://github.com/dorukardahan/twitterapi-io-mcp/commit/4284789b87348ea9079594c113d9d706e5ac2fb2))
89
+
90
+ # [1.3.0](https://github.com/dorukardahan/twitterapi-io-mcp/compare/v1.2.0...v1.3.0) (2026-03-17)
91
+
92
+
93
+ ### Features
94
+
95
+ * add 4 missing endpoints to docs.json, update README count to 58 ([6b0b9a9](https://github.com/dorukardahan/twitterapi-io-mcp/commit/6b0b9a909f4b07f9321cdc40b71e59f202f6a318))
96
+
97
+ # [1.2.0](https://github.com/dorukardahan/twitterapi-io-mcp/compare/v1.1.8...v1.2.0) (2026-03-16)
98
+
99
+
100
+ ### Features
101
+
102
+ * rewrite scraper to OpenAPI-first approach (v3.0) ([19a7992](https://github.com/dorukardahan/twitterapi-io-mcp/commit/19a7992c8602a67557dae7cd000470bc3f2b6c8f))
103
+
104
+ ## [1.1.8](https://github.com/dorukardahan/twitterapi-io-mcp/compare/v1.1.7...v1.1.8) (2026-03-15)
105
+
106
+
107
+ ### Bug Fixes
108
+
109
+ * correct package version to 1.1.7 and update npm README ([0a6e2e6](https://github.com/dorukardahan/twitterapi-io-mcp/commit/0a6e2e644a2def3a451afe470e863c57a298b090))
110
+
111
+ # 1.0.0 (2026-03-15)
112
+
113
+
114
+ ### Bug Fixes
115
+
116
+ * add CI/CD notes to CLAUDE.md for token expiry awareness ([d945b99](https://github.com/dorukardahan/twitterapi-io-mcp/commit/d945b99250bad0dd65b003b3850741a3ec0ebb38))
117
+ * add npm upgrade step for automation token compatibility ([6b8e926](https://github.com/dorukardahan/twitterapi-io-mcp/commit/6b8e92602ce1d23c233522523acf9610f8e29809))
118
+ * run MCP registry publish after npm publish to avoid 404 race condition ([85cb9ee](https://github.com/dorukardahan/twitterapi-io-mcp/commit/85cb9ee00deeb85f47eaaf8fa63c8c4bcf8e62cd))
119
+ * unified release pipeline — semantic-release handles npm + registry + GitHub release ([da9e0e1](https://github.com/dorukardahan/twitterapi-io-mcp/commit/da9e0e15f133f4189a87915065e0c1687bb2f7da))
120
+ * update dependencies to resolve security vulnerabilities ([0280f4a](https://github.com/dorukardahan/twitterapi-io-mcp/commit/0280f4a96dc420f7683c14a7e4aa0fac2ccbb7ae))
121
+ * update npm package README with correct endpoint table and version info ([f4eb7ea](https://github.com/dorukardahan/twitterapi-io-mcp/commit/f4eb7ea683cfceab4088dc2bb4a8bd742014a412))
122
+ * update server.json version to 1.1.0 for MCP registry publish ([372fdab](https://github.com/dorukardahan/twitterapi-io-mcp/commit/372fdabda7974b93fd28bbfee56e33e3b7104ed2))
123
+ * use NPM_TOKEN for npm publish instead of OIDC (2FA-protected account) ([3e9573f](https://github.com/dorukardahan/twitterapi-io-mcp/commit/3e9573f06401f70122b3e187b82148f680f96921))
124
+
125
+
126
+ ### Features
127
+
128
+ * add semantic-release for automated versioning and publishing ([5c07067](https://github.com/dorukardahan/twitterapi-io-mcp/commit/5c07067649ffff3c362d7f39ffe0bdb57d7431bd))
129
+ * add Twitter platform advisory for search operator degradation (v1.0.23) ([0c99ab2](https://github.com/dorukardahan/twitterapi-io-mcp/commit/0c99ab209a195f1f4d5b31d5426f8935c65f4ba2))
130
+ * sync endpoints with live API docs — add 2 new, remove 7 deprecated ([838d453](https://github.com/dorukardahan/twitterapi-io-mcp/commit/838d4533044e032170a06a8cc112bd61839f45e8))
131
+
132
+ # 1.0.0 (2026-03-15)
133
+
134
+
135
+ ### Bug Fixes
136
+
137
+ * add CI/CD notes to CLAUDE.md for token expiry awareness ([d945b99](https://github.com/dorukardahan/twitterapi-io-mcp/commit/d945b99250bad0dd65b003b3850741a3ec0ebb38))
138
+ * add npm upgrade step for automation token compatibility ([6b8e926](https://github.com/dorukardahan/twitterapi-io-mcp/commit/6b8e92602ce1d23c233522523acf9610f8e29809))
139
+ * run MCP registry publish after npm publish to avoid 404 race condition ([85cb9ee](https://github.com/dorukardahan/twitterapi-io-mcp/commit/85cb9ee00deeb85f47eaaf8fa63c8c4bcf8e62cd))
140
+ * unified release pipeline — semantic-release handles npm + registry + GitHub release ([da9e0e1](https://github.com/dorukardahan/twitterapi-io-mcp/commit/da9e0e15f133f4189a87915065e0c1687bb2f7da))
141
+ * update dependencies to resolve security vulnerabilities ([0280f4a](https://github.com/dorukardahan/twitterapi-io-mcp/commit/0280f4a96dc420f7683c14a7e4aa0fac2ccbb7ae))
142
+ * update server.json version to 1.1.0 for MCP registry publish ([372fdab](https://github.com/dorukardahan/twitterapi-io-mcp/commit/372fdabda7974b93fd28bbfee56e33e3b7104ed2))
143
+ * use NPM_TOKEN for npm publish instead of OIDC (2FA-protected account) ([3e9573f](https://github.com/dorukardahan/twitterapi-io-mcp/commit/3e9573f06401f70122b3e187b82148f680f96921))
144
+
145
+
146
+ ### Features
147
+
148
+ * add semantic-release for automated versioning and publishing ([5c07067](https://github.com/dorukardahan/twitterapi-io-mcp/commit/5c07067649ffff3c362d7f39ffe0bdb57d7431bd))
149
+ * add Twitter platform advisory for search operator degradation (v1.0.23) ([0c99ab2](https://github.com/dorukardahan/twitterapi-io-mcp/commit/0c99ab209a195f1f4d5b31d5426f8935c65f4ba2))
150
+ * sync endpoints with live API docs — add 2 new, remove 7 deprecated ([838d453](https://github.com/dorukardahan/twitterapi-io-mcp/commit/838d4533044e032170a06a8cc112bd61839f45e8))
151
+
152
+ # 1.0.0 (2026-03-15)
153
+
154
+
155
+ ### Bug Fixes
156
+
157
+ * add CI/CD notes to CLAUDE.md for token expiry awareness ([d945b99](https://github.com/dorukardahan/twitterapi-io-mcp/commit/d945b99250bad0dd65b003b3850741a3ec0ebb38))
158
+ * add npm upgrade step for automation token compatibility ([6b8e926](https://github.com/dorukardahan/twitterapi-io-mcp/commit/6b8e92602ce1d23c233522523acf9610f8e29809))
159
+ * run MCP registry publish after npm publish to avoid 404 race condition ([85cb9ee](https://github.com/dorukardahan/twitterapi-io-mcp/commit/85cb9ee00deeb85f47eaaf8fa63c8c4bcf8e62cd))
160
+ * unified release pipeline — semantic-release handles npm + registry + GitHub release ([da9e0e1](https://github.com/dorukardahan/twitterapi-io-mcp/commit/da9e0e15f133f4189a87915065e0c1687bb2f7da))
161
+ * update dependencies to resolve security vulnerabilities ([0280f4a](https://github.com/dorukardahan/twitterapi-io-mcp/commit/0280f4a96dc420f7683c14a7e4aa0fac2ccbb7ae))
162
+ * update server.json version to 1.1.0 for MCP registry publish ([372fdab](https://github.com/dorukardahan/twitterapi-io-mcp/commit/372fdabda7974b93fd28bbfee56e33e3b7104ed2))
163
+ * use NPM_TOKEN for npm publish instead of OIDC (2FA-protected account) ([3e9573f](https://github.com/dorukardahan/twitterapi-io-mcp/commit/3e9573f06401f70122b3e187b82148f680f96921))
164
+
165
+
166
+ ### Features
167
+
168
+ * add semantic-release for automated versioning and publishing ([5c07067](https://github.com/dorukardahan/twitterapi-io-mcp/commit/5c07067649ffff3c362d7f39ffe0bdb57d7431bd))
169
+ * add Twitter platform advisory for search operator degradation (v1.0.23) ([0c99ab2](https://github.com/dorukardahan/twitterapi-io-mcp/commit/0c99ab209a195f1f4d5b31d5426f8935c65f4ba2))
170
+ * sync endpoints with live API docs — add 2 new, remove 7 deprecated ([838d453](https://github.com/dorukardahan/twitterapi-io-mcp/commit/838d4533044e032170a06a8cc112bd61839f45e8))
171
+
172
+ ## [1.1.6](https://github.com/dorukardahan/twitterapi-io-mcp/compare/v1.1.5...v1.1.6) (2026-03-14)
173
+
174
+
175
+ ### Bug Fixes
176
+
177
+ * run MCP registry publish after npm publish to avoid 404 race condition ([d043d29](https://github.com/dorukardahan/twitterapi-io-mcp/commit/d043d29097dd72147a3fce573ba3540d7d1d1a51))
178
+
179
+ ## [1.1.5](https://github.com/dorukardahan/twitterapi-io-mcp/compare/v1.1.4...v1.1.5) (2026-03-14)
180
+
181
+
182
+ ### Bug Fixes
183
+
184
+ * add CI/CD notes to CLAUDE.md for token expiry awareness ([8ddc15d](https://github.com/dorukardahan/twitterapi-io-mcp/commit/8ddc15d62386203460d3b57bb87de3ee7831f3cf))
185
+
186
+ ## [1.1.4](https://github.com/dorukardahan/twitterapi-io-mcp/compare/v1.1.3...v1.1.4) (2026-03-14)
187
+
188
+
189
+ ### Bug Fixes
190
+
191
+ * add npm upgrade step for automation token compatibility ([12b3eed](https://github.com/dorukardahan/twitterapi-io-mcp/commit/12b3eede2e4ad39601ffb870a022278e2f8870ea))
192
+
193
+ ## [1.1.3](https://github.com/dorukardahan/twitterapi-io-mcp/compare/v1.1.2...v1.1.3) (2026-03-14)
194
+
195
+
196
+ ### Bug Fixes
197
+
198
+ * use NPM_TOKEN for npm publish instead of OIDC (2FA-protected account) ([89c549b](https://github.com/dorukardahan/twitterapi-io-mcp/commit/89c549bb40939a87548a7c1bb3d41efef0f7e7d6))
199
+
200
+ ## [1.1.2](https://github.com/dorukardahan/twitterapi-io-mcp/compare/v1.1.1...v1.1.2) (2026-03-14)
201
+
202
+
203
+ ### Bug Fixes
204
+
205
+ * unified release pipeline — semantic-release handles npm + registry + GitHub release ([5f272c7](https://github.com/dorukardahan/twitterapi-io-mcp/commit/5f272c7a4896e65fbee7abe578460d1f59862648))
206
+
207
+ ## [1.1.1](https://github.com/dorukardahan/twitterapi-io-mcp/compare/v1.1.0...v1.1.1) (2026-03-14)
208
+
209
+
210
+ ### Bug Fixes
211
+
212
+ * update server.json version to 1.1.0 for MCP registry publish ([60008cc](https://github.com/dorukardahan/twitterapi-io-mcp/commit/60008cc994565b1c7a985d8ec6d6e2afea644c9a))
213
+
214
+ # [1.1.0](https://github.com/dorukardahan/twitterapi-io-mcp/compare/v1.0.22...v1.1.0) (2026-03-14)
215
+
216
+
217
+ ### Bug Fixes
218
+
219
+ * handle 409 Conflict in MCP Registry publish (idempotent re-releases) ([476b270](https://github.com/dorukardahan/twitterapi-io-mcp/commit/476b270ce89e0256b1cc67cbdec5666556b198ec))
220
+ * update dependencies to resolve security vulnerabilities ([d61013e](https://github.com/dorukardahan/twitterapi-io-mcp/commit/d61013ea4845f0441a0f902059eed839d3bca3dd))
221
+
222
+
223
+ ### Features
224
+
225
+ * add semantic-release for automated versioning and publishing ([f9aa0d4](https://github.com/dorukardahan/twitterapi-io-mcp/commit/f9aa0d4c5b4eccc0bf1b29cf96754baad1617dc5))
226
+ * add Twitter platform advisory for search operator degradation (v1.0.23) ([7c2b784](https://github.com/dorukardahan/twitterapi-io-mcp/commit/7c2b784071f10d700fe2823a05f34ec0d6da79a1))
227
+ * sync endpoints with live API docs — add 2 new, remove 7 deprecated ([b9d0d37](https://github.com/dorukardahan/twitterapi-io-mcp/commit/b9d0d370a9290e723317e09b10b43f4bbb7f3980))
228
+
229
+ # Changelog
230
+
231
+ All notable changes to this project will be documented in this file.
232
+
233
+ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
234
+ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
235
+
236
+ ## [1.0.24] - 2026-03-14
237
+
238
+ ### Added
239
+ - `list_timeline` - Get List Tweet TimeLine
240
+ - `get_user_timeline` - Get User TimeLine
241
+
242
+ ### Removed
243
+ - 6 deprecated V1 endpoints: `create_tweet`, `like_tweet`, `retweet_tweet`, `login_by_email_or_username`, `login_by_2fa`, `upload_tweet_image`
244
+ - `get_dm_history_by_user_id` removed from live docs
245
+
246
+ ### Changed
247
+ - Total endpoints: 59 → 54
248
+
249
+ ### Fixed
250
+ - Security: updated hono 4.11.9 → 4.12.8 (5 CVEs), @hono/node-server → 1.19.11, ajv → 8.18.0, express-rate-limit → 8.3.1
251
+
252
+ ### Infrastructure
253
+ - Added semantic-release for automated versioning, changelog, and GitHub releases
254
+ - Added `.releaserc.json` configuration
255
+ - Added `.github/workflows/release.yml` — triggers on push to main
256
+
257
+ ## [1.0.23] - 2026-03-08
258
+
259
+ ### Added
260
+ - Platform advisory document: `docs/platform-advisory-2026-03.md`
261
+ - Twitter disabled `since:` / `until:` search operators (~Mar 5, 2026)
262
+ - Search pagination broken (returns same page repeatedly)
263
+ - Documented working workaround: `since_time:UNIX` / `until_time:UNIX` format
264
+ - Documented `within_time:Nh` relative time filter
265
+ - Webhook URL not auto-restored after API key rotation warning
266
+ - Timeline of events (Mar 3-8, 2026)
267
+
268
+ ## [1.0.22] - 2026-02-21
269
+
270
+ ### Added
271
+ - 7 new endpoints (52 → 59 total):
272
+ - `get_space_detail` — Twitter Spaces detail
273
+ - `get_tweet_replies_v2` — Tweet replies V2 with sort options (Relevance/Latest/Likes)
274
+ - `get_user_about` — User profile about section
275
+ - `get_user_to_monitor_tweet` — List monitored users
276
+ - `update_avatar_v2` — Update profile avatar
277
+ - `update_banner_v2` — Update profile banner
278
+ - `update_profile_v2` — Update profile info
279
+
280
+ ### Changed
281
+ - Fresh rescrape from docs.twitterapi.io (Feb 21, 2026)
282
+ - All 59 endpoints now match official llms.txt index
283
+
284
+ ## [1.0.19] - 2026-02-09
285
+
286
+ ### Fixed
287
+ - All 56 endpoints now have explicit HTTP method field (was missing for most)
288
+ - Search tool crash on object-format parameters (`normalizeParams()`)
289
+ - Parameter display in `get_twitterapi_endpoint` for both array and object formats
290
+ - Scraper post-processing: method, body params, and query params now auto-extracted from curl/raw_text
291
+
292
+ ### Added
293
+ - Body parameters for all 26 write endpoints (POST/PATCH/DELETE)
294
+ - Query parameters for 27 GET endpoints
295
+ - Deprecation notices for 4 legacy v1 endpoints (create_tweet, like_tweet, login_by_2fa, login_by_email_or_username)
296
+ - `get_trends` endpoint parameters (woeid, count)
297
+ - Post-processing step in scraper for automatic method/body/params extraction
298
+
299
+ ### Changed
300
+ - Fresh rescrape of all 56 endpoints, 32 pages, 24 blog posts from docs.twitterapi.io
301
+ - `upload_media_v2` correctly documented as multipart/form-data (not JSON)
302
+
303
+ ## [1.0.18] - 2026-02-02
304
+
305
+ ### Fixed
306
+ - Legacy wrapper CI publish step now includes NPM_TOKEN fallback for token-based authentication
307
+
308
+ ### Added
309
+ - Comprehensive 5-client migration guide in legacy wrapper README (Claude Code, Claude Desktop, Cursor, VS Code, Windsurf)
310
+ - Deprecated legacy wrapper entry in `server.json` packages array
311
+ - Linux config path for Claude Desktop in legacy wrapper README
312
+ - "Previously published as twitterapi-docs-mcp" note in root README
313
+
314
+ ### Changed
315
+ - **README full rewrite**: New structure matching top MCP server best practices
316
+ - Added installation blocks for Cursor, VS Code, and Windsurf (was only Claude Code + Claude Desktop)
317
+ - Added "Best for" column to Available Tools table
318
+ - Added "What can you ask?" section with real prompt examples and expected tool triggers
319
+ - Wrapped 59-endpoint category table in collapsible `<details>` to reduce scroll
320
+ - Added Troubleshooting / FAQ section (npx issues, Node version, missing tools)
321
+ - Merged "Technical Details" into "How it works" section
322
+ - Removed excessive horizontal rules (12 down to 0)
323
+ - Humanized "Why I built this" section with more personality
324
+ - Added Docker installation option
325
+
326
+ ### Added
327
+ - Smithery badge and GitHub stars badge
328
+ - `llms.txt` file for LLM discoverability (not included in npm package)
329
+ - 7 new npm keywords: `mcp-server`, `claude-desktop`, `tweet-search`, `social-media-api`, `twitter-data`, `cursor-mcp`, `windsurf-mcp`
330
+
331
+ ### Removed
332
+ - Node.js badge from README header (info moved to "How it works" table)
333
+ - MCP Registry badge (replaced with Smithery badge)
334
+
335
+ ---
336
+
337
+ ## [1.0.17] - 2026-02-02
338
+
339
+ ### Fixed
340
+ - **Critical**: `getEndpointMethod()` now checks `endpoint.type` field in addition to `endpoint.method` - fixes PATCH/DELETE methods being misreported as GET for `update_avatar_v2`, `update_banner_v2`, `update_profile_v2`
341
+ - **Critical**: `get_twitterapi_auth` tool handler had undefined variable references (`header`, `baseUrl`, `dashboardUrl`) causing runtime errors - now correctly references `auth.header`, `auth.baseUrl`, `auth.dashboardUrl`
342
+ - Added `method` field to v1.0.15 endpoints that only had `type` field
343
+
344
+ ### Added
345
+ - Support team guidance for `user_login_v2`: `totp_secret` must be a 16-character string (not numbers) for reliable cookie generation
346
+ - Troubleshooting note for `create_tweet_v2`: 400 errors commonly caused by faulty cookies from incorrect `totp_secret`
347
+ - Missing cURL examples for `update_avatar_v2`, `update_banner_v2`, `update_profile_v2`, `get_tweet_replies_v2`, `get_user_to_monitor_tweet`
348
+
349
+ ### Changed
350
+ - `formatEndpointMarkdown()` also updated to check `endpoint.type` for correct method display
351
+
352
+ ---
353
+
354
+ ## [1.0.16] - 2026-01-26
355
+
356
+ ### Improved
357
+ - Complete README restructure for better readability
358
+ - Added TL;DR and quick install command at top
359
+ - Added "For AI Assistants" section with tool usage guide
360
+ - Added architecture diagram
361
+ - Fixed GitHub homepage URL (was pointing to deprecated package)
362
+
363
+ ### SEO
364
+ - Added GitHub topics: `offline-docs`, `twitter-api`, `api-reference`
365
+ - Added npm keywords: `twitter-api`, `x-api`, `claude-mcp`, `twitter-docs`
366
+
367
+ ---
368
+
369
+ ## [1.0.15] - 2026-01-26
370
+
371
+ ### Added
372
+ - 5 new endpoints: `update_avatar_v2`, `update_banner_v2`, `update_profile_v2`, `get_tweet_replies_v2`, `get_user_to_monitor_tweet`
373
+ - Deprecation notices for legacy endpoints (visible in endpoint data)
374
+
375
+ ### Changed
376
+ - Total endpoints: 54 → 59
377
+ - Legacy endpoints (`login_by_2fa`, `login_by_email_or_username`, `create_tweet`, `like_tweet`, `retweet_tweet`, `upload_tweet_image`) now include deprecation notices pointing to v2 alternatives
378
+
379
+ ---
380
+
381
+ ## [1.0.14] - 2026-01-26
382
+
383
+ ### Security
384
+ - Upgraded `@modelcontextprotocol/sdk` from 1.24.3 to 1.25.3 (fixes ReDoS vulnerability GHSA-8r9q-7v3j-jr4g)
385
+ - Upgraded `qs` from 6.14.0 to 6.14.1 (fixes arrayLimit bypass DoS GHSA-6rw7-vpxm-498p)
386
+
387
+ ---
388
+
389
+ ## [1.0.10] - 2025-12-26
390
+
391
+ ### Added
392
+ - Auth metadata attached to `get_twitterapi_endpoint` outputs (`auth.header`, `auth.base_url`, etc.)
393
+ - Context7/README quick recipes for changelog, tweets lookup, auth, URL fallback, and search refine
394
+
395
+ ### Changed
396
+ - Expanded disambiguation + retry guidance for `search_twitterapi_docs`
397
+ - Clarified canonical `get_twitterapi_guide` usage for “Changelogs”
398
+
399
+ ---
400
+
401
+ ## [1.0.9] - 2025-12-14
402
+
403
+ ### Added
404
+ - New canonical npm package: `twitterapi-io-mcp`
405
+ - Legacy wrapper package: `packages/twitterapi-docs-mcp/` (keeps `twitterapi-docs-mcp` working)
406
+ - Optional `NPM_TOKEN` bootstrap path in publish workflow for first-time publish of `twitterapi-io-mcp`
407
+
408
+ ### Changed
409
+ - MCP Registry manifest now points to `twitterapi-io-mcp` (`server.json`)
410
+ - README + contributor docs updated to recommend `twitterapi-io-mcp`
411
+ - Publish workflow now uses Node 22 + `npm@11.6.0` for stable OIDC trusted publishing
412
+
413
+ ---
414
+
415
+ ## [1.0.8] - 2025-12-13
416
+
417
+ ### Added
418
+ - Blog key support in `get_twitterapi_url` (e.g., `blog_pricing_2025`)
419
+ - URL conveniences in `get_twitterapi_url`: accepts `http://` and `www.twitterapi.io` and normalizes to HTTPS
420
+ - Manual trigger (`workflow_dispatch`) for the npm publish workflow
421
+
422
+ ### Changed
423
+ - npm publish workflow now uses provenance attestation (`npm publish --provenance`)
424
+
425
+ ---
426
+
427
+ ## [1.0.7] - 2025-12-13
428
+
429
+ ### Added
430
+ - SEO-focused keywords for discoverability (`twitterapi.io`, `twitterapi-io-mcp`)
431
+
432
+ ### Changed
433
+ - GitHub repo renamed to `dorukardahan/twitterapi-io-mcp` (old URLs redirect)
434
+ - Updated repository links across docs and metadata
435
+ - `context7.json` now targets `https://context7.com/dorukardahan/twitterapi-io-mcp`
436
+ - MCP Registry identifier updated to `io.github.dorukardahan/twitterapi-io-mcp`
437
+
438
+ ---
439
+
440
+ ## [1.0.6] - 2025-12-13
441
+
442
+ ### Added
443
+ - Internal link crawling in `scrape-all.cjs` to capture non-sitemap pages (e.g., `terms`, `acceptable_use`, `dashboard`)
444
+ - URL conveniences in `get_twitterapi_url`: accepts page keys (e.g., `qps_limits`) and bare paths (e.g., `pricing`)
445
+ - Offline aliases for common docs redirects (`https://docs.twitterapi.io/`, `/api-reference`)
446
+
447
+ ### Changed
448
+ - Improved HTML extraction in the scraper to handle nested tags more reliably
449
+ - Updated bundled snapshot (`data/docs.json`) to include more site pages and blog posts
450
+
451
+ ### Fixed
452
+ - Scraper now fails fast on HTTP 4xx/5xx instead of saving error pages
453
+
454
+ ---
455
+
456
+ ## [1.0.5] - 2025-12-13
457
+
458
+ ### Added
459
+ - `context7.json` for Context7 library ownership claim
460
+ - `get_twitterapi_url` tool to fetch any `twitterapi.io` / `docs.twitterapi.io` URL (snapshot-first, optional live fetch)
461
+ - Expanded snapshot coverage via `sitemap.xml` + blog index crawl (site pages + more blog posts)
462
+ - Additional resource aliases (`twitterapi://endpoints/list`, `twitterapi://status/freshness`)
463
+ - MCP protocol integration test to prevent `outputSchema` regressions
464
+
465
+ ### Fixed
466
+ - MCP SDK compatibility: tools now return `structuredContent` when `outputSchema` is declared
467
+ - Scraper redirect handling for relative `Location` headers
468
+
469
+ ### Changed
470
+ - `get_twitterapi_guide` now validates against dynamic page keys from `data/docs.json`
471
+
472
+ ---
473
+
474
+ ## [1.0.4] - 2025-12-05
475
+
476
+ ### Added
477
+ - Dockerfile for container deployments (Glama.ai, Docker Hub)
478
+ - `.dockerignore` for optimized Docker builds
479
+ - MCP `completions` capability for mcp-proxy compatibility
480
+ - `build` script in package.json for CI/CD compatibility
481
+
482
+ ### Fixed
483
+ - Glama.ai deployment compatibility (completions handler, build script)
484
+
485
+ ---
486
+
487
+ ## [1.0.3] - 2025-12-05
488
+
489
+ ### Added
490
+ - `mcpName` field in package.json for MCP Registry compatibility
491
+ - MCP Registry support (`io.github.dorukardahan/twitterapi-docs-mcp`)
492
+
493
+ ---
494
+
495
+ ## [1.0.2] - 2025-12-05
496
+
497
+ ### Added
498
+ - GitHub Actions workflow for automated npm publishing
499
+ - npm Trusted Publishing (OIDC) - token-free secure publishing
500
+ - Provenance attestation for supply chain security
501
+
502
+ ### Changed
503
+ - Upgraded workflow to Node.js 24 (npm 11.6.0+ required for OIDC)
504
+ - Fixed test command for CI compatibility
505
+ - Cleaned up version strings in startup logs
506
+
507
+ ---
508
+
509
+ ## [1.0.0] - 2025-12-05
510
+
511
+ ### Added
512
+
513
+ First public release. Previously developed internally as v3.3.0.
514
+
515
+ #### Tools (6 total)
516
+ - `search_twitterapi_docs` - Full-text search across all documentation with configurable `max_results` (1-10)
517
+ - `get_twitterapi_endpoint` - Get detailed info for a specific API endpoint
518
+ - `list_twitterapi_endpoints` - List all endpoints with optional category filter
519
+ - `get_twitterapi_guide` - Get guide pages (pricing, qps_limits, tweet_filter_rules, changelog, introduction, authentication, readme)
520
+ - `get_twitterapi_pricing` - Quick access to pricing information
521
+ - `get_twitterapi_auth` - Quick access to authentication guide
522
+
523
+ #### Resources (9 total)
524
+ - `twitterapi://guides/pricing` - Pricing guide
525
+ - `twitterapi://guides/qps-limits` - QPS limits guide
526
+ - `twitterapi://guides/filter-rules` - Tweet filter rules guide
527
+ - `twitterapi://guides/changelog` - API changelog
528
+ - `twitterapi://guides/introduction` - Introduction guide
529
+ - `twitterapi://guides/authentication` - Authentication guide
530
+ - `twitterapi://guides/readme` - README guide
531
+ - `twitterapi://endpoints/list` - Full endpoint listing
532
+ - `twitterapi://status/freshness` - Data freshness status
533
+
534
+ #### Features
535
+ - Advanced tokenization with camelCase/PascalCase support
536
+ - N-gram fuzzy matching for search
537
+ - Hybrid caching (memory + disk) with 24-hour TTL
538
+ - SLO latency tracking (<50ms target)
539
+ - Data freshness monitoring
540
+ - Structured logging with metrics
541
+ - Input validation with helpful error messages
542
+ - 48 unit tests
543
+
544
+ #### Documentation Coverage
545
+ - 52 API endpoints
546
+ - 8 guide pages
547
+ - 5 blog articles
548
+ - Offline-first design (no network required)
549
+
550
+ ### Technical Details
551
+ - Pure ES Modules (no build step required)
552
+ - Node.js 18.18.0+ required
553
+ - Single dependency: @modelcontextprotocol/sdk
554
+
555
+ ---
556
+
557
+ ## Pre-1.0 Development History
558
+
559
+ Internal development versions (v1.0.0 - v3.3.0) included iterative improvements:
560
+
561
+ - **Phase 1**: Basic tools, search functionality, caching
562
+ - **Phase 2**: MCP Resources, advanced search, SLO tracking, data freshness monitoring
package/data/docs.json CHANGED
@@ -1286,8 +1286,8 @@
1286
1286
  "name": "tweet_advanced_search",
1287
1287
  "url": "https://docs.twitterapi.io/api-reference/endpoint/tweet_advanced_search",
1288
1288
  "scraped_at": "2026-03-16T02:37:54.444Z",
1289
- "title": "Advanced search for tweets.Each page returns up to 20 replies(Sometimes less than 20,because we will filter out ads or other not tweets). Use cursor for pagination.",
1290
- "description": "Advanced search for tweets.Each page returns up to 20 replies(Sometimes less than 20,because we will filter out ads or other not tweets). Use cursor for pagination.",
1289
+ "title": "Advanced search for tweets. Each page returns up to 20 replies (sometimes less, ads filtered). Use cursor for pagination. IMPORTANT for date filtering: use since_time:UNIX_TIMESTAMP and until_time:UNIX_TIMESTAMP instead of since:DATE/until:DATE (date format is currently degraded on Twitter). Convert your dates to Unix timestamps for correct results.",
1290
+ "description": "Advanced search for tweets. Each page returns up to 20 replies (sometimes less, ads filtered). Use cursor for pagination. IMPORTANT for date filtering: use since_time:UNIX_TIMESTAMP and until_time:UNIX_TIMESTAMP instead of since:DATE/until:DATE (date format is currently degraded on Twitter). Convert your dates to Unix timestamps for correct results.",
1291
1291
  "method": "GET",
1292
1292
  "path": "/twitter/tweet/advanced_search",
1293
1293
  "parameters": [
@@ -1297,7 +1297,7 @@
1297
1297
  "type": "string",
1298
1298
  "format": "string",
1299
1299
  "required": true,
1300
- "description": "The query to search for.eg. \"AI\" OR \"Twitter\" from:elonmusk since:2021-12-31_23:59:59_UTC . Get more examples from https://github.com/igorbrigadir/twitter-advanced-search "
1300
+ "description": "The query to search for. eg. \"AI\" OR \"Twitter\" from:elonmusk since_time:1640995200 until_time:1641081600 . IMPORTANT: Use since_time/until_time with Unix timestamps instead of since/until date format (since/until is currently degraded on Twitter). Get more examples from https://github.com/igorbrigadir/twitter-advanced-search"
1301
1301
  },
1302
1302
  {
1303
1303
  "name": "queryType",
@@ -1336,11 +1336,11 @@
1336
1336
  "description": "Cursor for fetching the next page of results"
1337
1337
  }
1338
1338
  },
1339
- "curl_example": "curl --request GET \\\n --url 'https://api.twitterapi.io/twitter/tweet/advanced_search?query=QUERY&queryType=QUERYTYPE&cursor=CURSOR' \\\n --header 'X-API-Key: <api-key>'",
1339
+ "curl_example": "curl --request GET \\\n --url 'https://api.twitterapi.io/twitter/tweet/advanced_search?query=from%3Aelonmusk%20since_time%3A1640995200%20until_time%3A1641081600&queryType=Latest' \\\n --header 'X-API-Key: <api-key>'",
1340
1340
  "code_snippets": [
1341
- "curl --request GET \\\n --url 'https://api.twitterapi.io/twitter/tweet/advanced_search?query=QUERY&queryType=QUERYTYPE&cursor=CURSOR' \\\n --header 'X-API-Key: <api-key>'"
1341
+ "curl --request GET \\\n --url 'https://api.twitterapi.io/twitter/tweet/advanced_search?query=from%3Aelonmusk%20since_time%3A1640995200%20until_time%3A1641081600&queryType=Latest' \\\n --header 'X-API-Key: <api-key>'"
1342
1342
  ],
1343
- "raw_text": "Advanced search for tweets.Each page returns up to 20 replies(Sometimes less than 20,because we will filter out ads or other not tweets). Use cursor for pagination. query: The query to search for.eg. \"AI\" OR \"Twitter\" from:elonmusk since:2021-12-31_23:59:59_UTC . Get more examples from https://github.com/igorbrigadir/twitter-advanced-search queryType: The query type to search for.eg. \"Latest\" OR \"Top\" cursor: The cursor to paginate through the results. First page is \"\"."
1343
+ "raw_text": "Advanced search for tweets. Each page returns up to 20 replies (sometimes less, ads filtered). Use cursor for pagination. IMPORTANT for date filtering: use since_time:UNIX_TIMESTAMP and until_time:UNIX_TIMESTAMP instead of since:DATE/until:DATE (date format is currently degraded on Twitter). Convert your dates to Unix timestamps for correct results. query: The query to search for. eg. \"AI\" OR \"Twitter\" from:elonmusk since_time:1640995200 until_time:1641081600 . IMPORTANT: Use since_time/until_time with Unix timestamps instead of since/until date format (since/until is currently degraded on Twitter). Get more examples from https://github.com/igorbrigadir/twitter-advanced-search queryType: \"Latest\" or \"Top\" cursor: pagination cursor, first page is empty string."
1344
1344
  },
1345
1345
  "list_timeline": {
1346
1346
  "name": "list_timeline",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "twitterapi-io-mcp",
3
- "version": "1.5.1",
3
+ "version": "1.5.7",
4
4
  "mcpName": "io.github.dorukardahan/twitterapi-io-mcp",
5
5
  "description": "TwitterAPI.io MCP server providing offline access to docs (endpoints, pages, blogs) for Claude and other AI assistants",
6
6
  "main": "index.js",
@@ -60,6 +60,7 @@
60
60
  "index.js",
61
61
  "data/docs.json",
62
62
  "README.md",
63
+ "CHANGELOG.md",
63
64
  "LICENSE"
64
65
  ],
65
66
  "dependencies": {