Excellent Twitter API wrapper with thoughtfully designed tool interfaces. 35 tools is within optimal curation range (3-40). All tools use strongly typed parameters with clear semantics. Descriptions are concise and actionable. Schema design follows JSON Schema standards consistently. No generic request_body parameters. Tool naming is predictable and follows REST conventions. The server demonstrates domain expertise in Twitter operations with proper separation of concerns (read vs. write, profile vs. content). Minor issues: some tools could benefit from richer parameter descriptions and a few lack edge case guidance.
Bookmark a tweet
Follow a Twitter user
Get the full article/long-form post content from a tweet. Pass the tweet ID that contains the article (not the article URL ID).
Get bookmarked tweets
Get the authenticated user's profile
Get a user's followers
Get users that a user follows
Get the home timeline (latest tweets from followed accounts)
Minimal descriptions for read-only tools (get_* tools have very short, generic descriptions like 'Get X'). While technically adequate, they lack context about WHEN to use them or what distinguishes similar tools (e.g., get_user vs get_user_about).
Mixed parameter naming conventions: some tools use 'id', others use 'userId', others use 'handle'. While documented, this creates friction for LLM-based agents in terms of cognitive load and potential parameter mismatches.
No pagination guidance: pagination via cursor is available on many tools but descriptions don't explain cursor semantics, whether it's opaque, or how to detect end-of-results.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-03-24 | A | 80 | 2025-11-25 | v1 |
Get tweets liked by a user
Get lists the authenticated user is a member of
Get tweets from a list
Get owned Twitter lists
Get mentions for a user
Get trending news/topics on Twitter
Get replies to a tweet
Get a tweet thread (conversation chain)
Get a tweet by ID
Get a Twitter user profile by handle
Get detailed about info for a user
Get tweets posted by a user
Like a tweet
Post a thread (multiple tweets in sequence)
Post a new tweet
Remove the authenticated user's profile banner
Reply to a tweet
Retweet a tweet
Search for tweets
Remove a tweet bookmark
Unfollow a Twitter user
Unlike a tweet
Remove a retweet
Update the authenticated user's Twitter profile bio/description via the onboarding flow
Update the authenticated user's profile banner. Accepts an absolute file path to an image.
Update the authenticated user's profile image (avatar). Accepts an absolute file path to an image.
Upload media (image/video) for use in tweets. Returns a mediaId to pass to post_tweet or reply_to_tweet.
File path handling (update_profile_image, update_profile_banner, upload_media) requires 'absolute file path' but no guidance on file format requirements, size limits, or validation.