# xbird-mcp

Manage your social presence by posting tweets, threads, and media directly from your workspace. Access timelines, search for content, and monitor mentions to stay updated on trending topics. Engage w…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add checkra1neth/xbirdmcp

# Browse available tools
npx -y @smithery/cli@latest tool list checkra1neth/xbirdmcp

# Get full schema for a tool
npx -y @smithery/cli@latest tool get checkra1neth/xbirdmcp get_tweet

# Call a tool
npx -y @smithery/cli@latest tool call checkra1neth/xbirdmcp get_tweet '{}'
```

## Direct MCP Connection

Endpoint: `https://xbirdmcp--checkra1neth.run.tools`

## Tools (34)

- `get_tweet` — Get a tweet by ID
- `get_thread` — Get a tweet thread (conversation chain)
- `get_replies` — Get replies to a tweet
- `get_user` — Get a Twitter user profile by handle
- `get_user_about` — Get detailed about info for a user
- `get_current_user` — Get the authenticated user's profile
- `get_home_timeline` — Get the home timeline (latest tweets from followed accounts)
- `get_news` — Get trending news/topics on Twitter
- `get_lists` — Get owned Twitter lists
- `get_list_timeline` — Get tweets from a list
- `search_tweets` — Search for tweets
- `get_mentions` — Get mentions for a user
- `get_user_tweets` — Get tweets posted by a user
- `get_followers` — Get a user's followers
- `get_following` — Get users that a user follows
- `get_likes` — Get tweets liked by a user
- `get_bookmarks` — Get bookmarked tweets
- `get_list_memberships` — Get lists the authenticated user is a member of
- `post_tweet` — Post a new tweet
- `reply_to_tweet` — Reply to a tweet
- `post_thread` — Post a thread (multiple tweets in sequence)
- `like_tweet` — Like a tweet
- `unlike_tweet` — Unlike a tweet
- `retweet` — Retweet a tweet
- `unretweet` — Remove a retweet
- `bookmark_tweet` — Bookmark a tweet
- `unbookmark_tweet` — Remove a tweet bookmark
- `follow_user` — Follow a Twitter user
- `unfollow_user` — Unfollow a Twitter user
- `update_profile` — Update the authenticated user's Twitter profile bio/description via the onboarding flow
- `update_profile_image` — Update the authenticated user's profile image (avatar). Accepts an absolute file path to an image.
- `update_profile_banner` — Update the authenticated user's profile banner. Accepts an absolute file path to an image.
- `remove_profile_banner` — Remove the authenticated user's profile banner
- `upload_media` — Upload media (image/video) for use in tweets. Returns a mediaId to pass to post_tweet or reply_to_tweet.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get checkra1neth/xbirdmcp <tool-name>
```