# Twitter (verified)

Twitter, Inc. was an American social media company based in San Francisco, California, which operated and was named for named for its flagship social media network prior to its rebrand as X.

## Quick Start

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

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

# Get full schema for a tool
npx -y @smithery/cli@latest tool get twitter TWITTER_ADD_A_LIST_MEMBER

# Call a tool
npx -y @smithery/cli@latest tool call twitter TWITTER_ADD_A_LIST_MEMBER '{}'
```

## Direct MCP Connection

Endpoint: `https://twitter.run.tools`

## Tools (75)

- `TWITTER_ADD_A_LIST_MEMBER` — Adds a user to a specified Twitter List; the list must be owned by the authenticated user.
- `TWITTER_ADD_POST_TO_BOOKMARKS` — Adds a specified, existing, and accessible Tweet to a user's bookmarks, with success indicated by the 'bookmarked' fiel…
- `TWITTER_BOOKMARKS_BY_USER` — Retrieves Tweets bookmarked by the authenticated user, where the provided User ID must match the authenticated user's I…
- `TWITTER_CREATE_A_NEW_DM_CONVERSATION` — Creates a new group Direct Message (DM) conversation on Twitter with specified participant IDs and an initial message, …
- `TWITTER_CREATE_COMPLIANCE_JOB_REQUEST` — Creates a new compliance job to check the status of Tweet or user IDs; upload IDs as a plain text file (one ID per line…
- `TWITTER_CREATE_LIST` — Creates a new, empty List on X (formerly Twitter), for which the provided name must be unique for the authenticated use…
- `TWITTER_CREATION_OF_A_POST` — Creates a Tweet on Twitter; `text` is required unless `card_uri`, `media_media_ids`, `poll_options`, or `quote_tweet_id…
- `TWITTER_DELETE_DM` — Permanently deletes a specific Twitter Direct Message (DM) event using its `event_id` if the authenticated user sent it…
- `TWITTER_DELETE_LIST` — Permanently deletes a specified Twitter List using its ID, which must be owned by the authenticated user; this action i…
- `TWITTER_FETCH_LIST_MEMBERS_BY_ID` — Fetches members of a specific Twitter List, identified by its unique ID.
- `TWITTER_FETCH_SPACE_TICKET_BUYERS_LIST` — Retrieves a list of users who purchased tickets for a specific, valid, and ticketed Twitter Space.
- `TWITTER_FOLLOW_A_LIST` — Allows the authenticated user (`id`) to follow a specific Twitter List (`list_id`) they are permitted to access, subscr…
- `TWITTER_FOLLOWERS_BY_USER_ID` — Retrieves a list of users who follow a specified public Twitter user ID.
- `TWITTER_FOLLOWING_BY_USER_ID` — Retrieves users followed by a specific Twitter user, allowing pagination and customization of returned user and tweet d…
- `TWITTER_FOLLOW_USER` — Allows an authenticated user (path `id`) to follow another user (`target_user_id`), which results in a pending request …
- `TWITTER_FULL_ARCHIVE_SEARCH` — Searches the full archive of public Tweets from March 2006 onwards; use 'start_time' and 'end_time' together for a defi…
- `TWITTER_FULL_ARCHIVE_SEARCH_COUNTS` — Returns a count of Tweets from the full archive that match a specified query, aggregated by day, hour, or minute; `star…
- `TWITTER_GET_A_USER_S_LIST_MEMBERSHIPS` — Retrieves all Twitter Lists a specified user is a member of, including public Lists and private Lists the authenticated…
- `TWITTER_GET_A_USER_S_OWNED_LISTS` — Call this action to retrieve Lists created (owned) by a specific Twitter user, not Lists they follow or are subscribed …
- `TWITTER_GET_A_USER_S_PINNED_LISTS` — Retrieves the Lists a specific, existing Twitter user has pinned to their profile to highlight them.
- `TWITTER_GET_BLOCKED_USERS` — Retrieves user objects for accounts blocked by the specified user ID; this is a read-only view of a user's block list.
- `TWITTER_GET_DM_EVENTS_BY_ID` — Fetches a specific Direct Message (DM) event by its unique ID, allowing optional expansion of related data like users o…
- `TWITTER_GET_DM_EVENTS_FOR_A_DM_CONVERSATION` — Fetches Direct Message (DM) events for a one-on-one conversation with a specified participant ID, ordered chronological…
- `TWITTER_GET_LIST_FOLLOWERS` — Fetches a list of users who follow a specific Twitter List, identified by its ID; ensure the authenticated user has acc…
- `TWITTER_GET_MEDIA_UPLOAD_STATUS` — Get the status of a media upload for X/Twitter. Use this to check the processing status of uploaded media, especially f…
- `TWITTER_GET_MUTED_USERS` — Returns user objects muted by the X user identified by the `id` path parameter.
- `TWITTER_GET_POST_RETWEETERS_ACTION` — Retrieves users who publicly retweeted a specified public Post ID, excluding Quote Tweets and retweets from private acc…
- `TWITTER_GET_RECENT_DM_EVENTS` — Returns recent Direct Message events for the authenticated user, such as new messages or changes in conversation partic…
- `TWITTER_GET_USER_S_FOLLOWED_LISTS` — Returns metadata (not Tweets) for lists a specific Twitter user follows, optionally including expanded owner details.
- `TWITTER_HIDE_REPLIES` — Hides or unhides an existing reply Tweet.
- `TWITTER_LIST_LOOKUP_BY_LIST_ID` — Returns metadata for a specific Twitter List, identified by its ID; does not return list members but can expand the own…
- `TWITTER_LIST_POST_LIKERS` — Retrieves users who have liked the Post (Tweet) identified by the provided ID.
- `TWITTER_LIST_POSTS_TIMELINE_BY_LIST_ID` — Fetches the most recent Tweets posted by members of a specified Twitter List.
- `TWITTER_MUTE_USER_BY_USER_ID` — Mutes a target user on behalf of an authenticated user, preventing the target's Tweets and Retweets from appearing in t…
- `TWITTER_PIN_A_LIST` — Pins a specified List to the authenticated user's profile, provided the List exists, the user has access rights, and th…
- `TWITTER_POST_DELETE_BY_POST_ID` — Irreversibly deletes a specific Tweet by its ID; the Tweet may persist in third-party caches after deletion.
- `TWITTER_POST_LOOKUP_BY_POST_ID` — Fetches comprehensive details for a single Tweet by its unique ID, provided the Tweet exists and is accessible.
- `TWITTER_POST_LOOKUP_BY_POST_IDS` — Retrieves detailed information for one or more Posts (Tweets) identified by their unique IDs, allowing selection of spe…
- `TWITTER_POSTS_LABEL_STREAM` — Establishes a persistent stream of real-time events for when Tweet labels are applied or removed, offering insights int…
- `TWITTER_POST_USAGE` — Fetches Tweet usage statistics for a Project (e.g., consumption, caps, daily breakdowns for Project & Client Apps) to m…
- `TWITTER_RECENT_SEARCH` — Searches Tweets from the last 7 days matching a query (using X's search syntax), ideal for real-time analysis, trend mo…
- `TWITTER_RECENT_SEARCH_COUNTS` — Retrieves the count of Tweets matching a specified search query within the last 7 days, aggregated by 'minute', 'hour',…
- `TWITTER_REMOVE_A_BOOKMARKED_POST` — Removes a Tweet, specified by `tweet_id`, from the authenticated user's bookmarks; the Tweet must have been previously …
- `TWITTER_REMOVE_A_LIST_MEMBER` — Removes a user from a Twitter List; the response `is_member` field will be `false` if removal was successful or the use…
- `TWITTER_RETRIEVE_COMPLIANCE_JOB_BY_ID` — Retrieves status, download/upload URLs, and other details for an existing Twitter compliance job specified by its uniqu…
- `TWITTER_RETRIEVE_COMPLIANCE_JOBS` — Returns a list of recent compliance jobs, filtered by type (tweets or users) and optionally by status.
- `TWITTER_RETRIEVE_DM_CONVERSATION_EVENTS` — Retrieves Direct Message (DM) events for a specific conversation ID on Twitter, useful for analyzing messages and parti…
- `TWITTER_RETRIEVE_POSTS_FROM_A_SPACE` — Retrieves Tweets from a specified Twitter Space ID; the Space must be accessible and results are batched (not streamed).
- `TWITTER_RETRIEVE_POSTS_THAT_QUOTE_A_POST` — Retrieves Tweets that quote a specified Tweet, requiring a valid Tweet ID.

---
*Response truncated. Use `npx -y @smithery/cli@latest` for complete data.*