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.
- package/README.md +24 -6
- package/data/docs.json +4416 -470
- package/index.js +24 -8
- 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.
|
|
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
|
[](https://www.npmjs.com/package/twitterapi-io-mcp)
|
|
6
6
|
[](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
|
-
- **
|
|
21
|
-
- **
|
|
22
|
-
- **
|
|
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
|
|
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
|
-
└─────────────┘ │ (
|
|
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)
|