X (Twitter) (verified)

X (Twitter) (verified)

Post, search, and interact with X (formerly Twitter) — tweets, users, lists, bookmarks, likes, follows, DMs, spaces, communities, and Community Notes.

Quick Start

# Connect this server (installs CLI if needed)
npx -y smithery mcp add twitter

# Browse available tools
npx -y smithery tool list twitter

# Get full schema for a tool
npx -y smithery tool get twitter chat.conversations.list

# Call a tool
npx -y smithery tool call twitter chat.conversations.list '{}'

Direct MCP Connection

Endpoint: https://twitter.run.tools

Tools (98)

• chat.conversations.list — List chat conversations for authenticated user
• chat.conversations.get — Get chat conversation by ID
• chat.conversations.messages.create — Send message in chat conversation
• chat.conversations.read.create — Mark chat conversation as read
• chat.conversations.typing.create — Send typing indicator in chat conversation
• chat.media.get — Download media from chat conversation
• communities.search.list — Search communities by keyword
• communities.get — Get community details by ID
• dm_conversations.create — Create new DM conversation with participants
• dm_conversations.with.dm_events.list — List DM events with specific participant
• dm_conversations.with.messages.create — Send DM to participant by user ID
• dm_conversations.messages.create — Send DM in existing conversation by ID
• dm_conversations.dm_events.list — List DM events in conversation by ID
• dm_events.list — List all DM events for authenticated user
• dm_events.get — Get DM event details by ID
• dm_events.delete — Delete DM event by ID
• evaluate_note.create — Submit evaluation for a Community Note
• insights.28hr.list — Get post engagement insights for last 28 hours
• insights.historical.list — Get historical post engagement insights
• lists.create — Create new list
• lists.get — Get list details by ID
• lists.update — Update list name or description
• lists.delete — Delete list by ID
• lists.members.list — List members of a list
• lists.members.create — Add member to list
• lists.members.delete — Remove member from list
• lists.tweets.list — Get posts from a list timeline
• media.list — Get media details by media keys
• media.analytics.list — Get media engagement analytics
• media.metadata.create — Set alt text or metadata on uploaded media
• media.subtitles.create — Add subtitles to media
• media.subtitles.delete — Remove subtitles from media
• media.get — Get media details by single media key
• news.search.list — Search news stories by keyword
• news.get — Get news story details by ID
• notes.create — Create Community Note on a post
• notes.search.notes_written.list — Search Community Notes written by user
• notes.search.posts_eligible_for_notes.list — Search posts eligible for Community Notes
• notes.delete — Delete Community Note by ID
• spaces.list — Get spaces by IDs
• spaces.by.creator_ids.list — Get spaces created by specific users
• spaces.search.list — Search spaces by keyword
• spaces.get — Get space details by ID
• spaces.buyers.list — List users who purchased space tickets
• spaces.tweets.list — Get posts shared in a space
• tweets.list — Get posts by IDs
• tweets.create — Create or edit a post
• tweets.analytics.list — Get post engagement analytics
• tweets.search.recent.list — Search recent posts by query (last 7 days)
• tweets.get — Get post details by ID
• tweets.delete — Delete post by ID
• tweets.liking_users.list — List users who liked a post
• tweets.quote_tweets.list — List quote posts of a post
• tweets.retweeted_by.get — List users who reposted a post
• tweets.retweets.list — List reposts of a post
• tweets.hidden.update — Hide or unhide reply to your post
• users.list — Get users by IDs
• users.by.list — Get users by usernames
• users.by.username.get — Get user profile by username
• users.me.list — Get authenticated user profile
• users.personalized_trends.list — Get personalized trending topics
• users.reposts_of_me.list — List reposts of authenticated user's posts
• users.search.list — Search users by keyword
• users.get — Get user profile by ID
• users.affiliates.list — List affiliated accounts of a user
• users.blocking.list — List users blocked by authenticated user
• users.bookmarks.list — List bookmarked posts
• users.bookmarks.create — Bookmark a post
• users.bookmarks.folders.list — List bookmark folders
• users.bookmarks.folders.get — List bookmarks in specific folder
• users.bookmarks.delete — Remove post from bookmarks
• users.dm.block.create — Block DMs from a user
• users.dm.unblock.create — Unblock DMs from a user
• users.followed_lists.list — List lists followed by user
• users.followed_lists.create — Follow a list
• users.followed_lists.delete — Unfollow a list
• users.followers.list — List followers of a user
• users.following.list — List accounts a user follows
• users.following.create — Follow a user
• users.liked_tweets.list — List posts liked by a user
• users.likes.create — Like a post
• users.likes.delete — Unlike a post
• users.list_memberships.list — List lists a user is member of
• users.mentions.list — List posts mentioning a user
• users.muting.list — List muted users
• users.muting.create — Mute a user
• users.owned_lists.list — List lists owned by a user
• users.pinned_lists.list — List pinned lists
• users.pinned_lists.create — Pin a list
• users.pinned_lists.delete — Unpin a list
• users.public_keys.list — Get user encryption public keys
• users.public_keys.create — Add encryption public key
• users.retweets.create — Repost a post
• users.retweets.delete — Undo repost
• users.timelines.reverse_chronological.list — Get home timeline in reverse chronological order
• users.tweets.list — List posts by a user
• users.following.delete — Unfollow a user
• users.muting.delete — Unmute a user

# Get full input/output schema for a tool
npx -y smithery tool get twitter