twitterapi-io-mcp 1.0.18 → 1.0.20

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 (4) hide show
  1. package/README.md +24 -6
  2. package/data/docs.json +4416 -470
  3. package/index.js +24 -8
  4. package/package.json +2 -2
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # twitterapi-io-mcp
2
2
 
3
- > Offline TwitterAPI.io documentation for Claude and AI assistants via MCP. 59 endpoints, 19 guides, 21 blog posts. No API key needed.
3
+ > Offline TwitterAPI.io documentation for Claude and AI assistants via MCP. 56 endpoints (with full method/params/body), 32 guides, 24 blog posts. No API key needed.
4
4
 
5
5
  [![npm version](https://img.shields.io/npm/v/twitterapi-io-mcp.svg)](https://www.npmjs.com/package/twitterapi-io-mcp)
6
6
  [![npm downloads](https://img.shields.io/npm/dm/twitterapi-io-mcp.svg)](https://www.npmjs.com/package/twitterapi-io-mcp)
@@ -17,17 +17,27 @@ claude mcp add twitterapi-io -- npx -y twitterapi-io-mcp
17
17
 
18
18
  An MCP server that gives Claude, Cursor, VS Code Copilot, and other AI assistants **instant, offline access** to [TwitterAPI.io](https://twitterapi.io) documentation.
19
19
 
20
- - **59 API endpoints** with parameters, examples, and response schemas
21
- - **19 guide pages** covering pricing, authentication, rate limits, webhooks
22
- - **21 blog posts** with tutorials and use cases
20
+ - **56 API endpoints** with full HTTP method, body/query parameters, cURL examples, and response schemas
21
+ - **32 guide pages** covering pricing, authentication, rate limits, webhooks, streaming
22
+ - **24 blog posts** with tutorials and use cases
23
+ - **All v2 write endpoints** documented with `login_cookies`, `proxy`, and body params
24
+ - **4 deprecated v1 endpoints** marked with migration notices
23
25
  - **Zero API key required** — everything is bundled locally
24
26
 
25
27
  Unlike other Twitter MCP servers that proxy live API calls (and need your API key), this one ships a complete documentation snapshot. Your AI assistant reads it locally, instantly.
26
28
 
29
+ ### v1.0.19 Highlights
30
+ - Fresh rescrape from docs.twitterapi.io (Feb 2026)
31
+ - All 26 write endpoints have body parameters (login_cookies, tweet_text, proxy, etc.)
32
+ - All 27 GET endpoints have query parameters
33
+ - Scraper auto-extracts method/body/params — `npm run scrape` keeps data fresh
34
+
27
35
  > **Disclaimer**: Independent community project. Not affiliated with TwitterAPI.io.
28
36
 
29
37
  ## Installation
30
38
 
39
+ > Previously published as `twitterapi-docs-mcp`? Just change the package name — everything else stays the same.
40
+
31
41
  **Requires:** Node.js 18.18.0+
32
42
 
33
43
  ### Claude Code (recommended)
@@ -49,6 +59,7 @@ Add to your config file:
49
59
 
50
60
  - **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
51
61
  - **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
62
+ - **Linux**: `~/.config/Claude/claude_desktop_config.json`
52
63
 
53
64
  ```json
54
65
  {
@@ -165,7 +176,7 @@ Here are real prompts that work well with this MCP server:
165
176
  - *"How do I upload media and create a tweet?"* — triggers sequential `get_twitterapi_endpoint` calls
166
177
 
167
178
  <details>
168
- <summary><strong>All 59 endpoints by category</strong></summary>
179
+ <summary><strong>All 56 endpoints by category</strong></summary>
169
180
 
170
181
  | Category | Count | Endpoints |
171
182
  |----------|-------|-----------|
@@ -223,7 +234,7 @@ Restart your MCP client after adding the server config. Most clients (Claude Des
223
234
  │ Claude / │ ◄──────────────────► │ twitterapi-io-mcp│
224
235
  │ Cursor / │ │ │
225
236
  │ VS Code │ │ Bundled docs │
226
- └─────────────┘ │ (59 endpoints) │
237
+ └─────────────┘ │ (56 endpoints) │
227
238
  └──────────────────┘
228
239
  No network needed
229
240
  ```
@@ -256,9 +267,16 @@ npm start # Start server locally
256
267
  npm run scrape # Update docs snapshot from twitterapi.io
257
268
  ```
258
269
 
270
+ ## Not using MCP?
271
+
272
+ If your AI tool doesn't support MCP (like OpenClaw), use the **skill version** instead — a single markdown file with all 55 endpoints:
273
+
274
+ 👉 **[twitterapi-io-skill](https://github.com/dorukardahan/twitterapi-io-skill)** — works with OpenClaw, Claude, GPT, Gemini, and any LLM.
275
+
259
276
  ## Links
260
277
 
261
278
  - **npm**: [twitterapi-io-mcp](https://www.npmjs.com/package/twitterapi-io-mcp)
279
+ - **Skill version**: [dorukardahan/twitterapi-io-skill](https://github.com/dorukardahan/twitterapi-io-skill)
262
280
  - **GitHub**: [dorukardahan/twitterapi-io-mcp](https://github.com/dorukardahan/twitterapi-io-mcp)
263
281
  - **MCP Registry**: [registry.modelcontextprotocol.io](https://registry.modelcontextprotocol.io)
264
282
  - **TwitterAPI.io**: [twitterapi.io](https://twitterapi.io)