MCP server for Twitter/X API integration with read and write capabilities
18 tools with complete schemas and descriptions, but quality is uneven. Most tools have adequate naming (verb_noun pattern) and basic descriptions (avg ~80 chars), but lack depth on WHEN to use them and error recovery guidance. Parameter descriptions are present but often generic ('Tweet ID to X'). No output schemas documented. Error handling is minimal, tools return raw API responses without actionable recovery hints. Security: credentials injected server-side (good), but no permission gates or audit trail declarations. Composition is sound, tools are single-responsibility and chainable via ID fields.
Delete a tweet by ID
Get a Twitter article (long-form tweet) by tweet ID
Get trending topics on Twitter for a location
Get one or more tweets by ID, including view counts
Get quote tweets for a tweet
Get replies to a tweet
Get the full thread context for a tweet
Output schemas not documented. LLMs cannot plan downstream calls or extract required fields (e.g., tweet_id for chaining). Responses are opaque.
Descriptions lack WHEN/WHY context. 'Get one or more tweets by ID' does not explain when to use get_tweet vs search_tweets, or what fields are returned. Descriptions average ~55 chars for read tools; should be 100-200.
No error recovery guidance. Tools return raw API errors without actionable hints (e.g., 'User not found. Try search_users() first'). Agents cannot self-correct.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 54 | 2026-07-28+ | v2 |
Get Twitter user profile info by username
Get followers of a Twitter user
Get accounts that a Twitter user follows
Get tweets that mention a specific user
Get recent tweets from a user's timeline
Like a tweet by ID
Post a tweet with optional images. Supports reply and quote-tweet. If replying to a non-interacted tweet and OAuth returns 403, automatically falls back to cookie-based auth.
Retweet a tweet by ID
Search tweets by keyword or advanced query. Supports filtering by engagement and author metrics.
Search Twitter users by keyword
Remove a like from a tweet
Destructive tools (delete_tweet, post_tweet) lack confirmation/dry-run pattern. Agents can delete tweets without a safety gate.
No tool annotations (readOnlyHint, destructiveHint, idempotentHint). LLMs cannot infer which tools are safe to retry or have side effects.