/twitter | Type: Application | PCID required: Yes
Tweets, users, timelines, and media
Tools
| Tool | Description |
|---|---|
twitter_post_tweet | Post a new tweet to Twitter |
twitter_get_tweet | Retrieve a specific tweet by ID |
twitter_delete_tweet | Delete a tweet |
twitter_get_user_timeline | Get tweets from a user’s timeline |
twitter_search_tweets | Search for tweets using Twitter search API |
twitter_get_user_by_username | Get user information by username |
twitter_get_user_by_id | Get user information by user ID |
twitter_follow_user | Follow a user on Twitter |
twitter_unfollow_user | Unfollow a user on Twitter |
twitter_get_followers | Get followers of a user |
twitter_get_following | Get users that a user is following |
twitter_like_tweet | Like a tweet |
twitter_unlike_tweet | Unlike a tweet |
twitter_retweet | Retweet a tweet |
twitter_unretweet | Remove a retweet |
twitter_upload_media | Upload media (image/video) to Twitter for use in tweets |
twitter_get_mentions | Get tweets that mention the authenticated user |
twitter_get_home_timeline | Get the authenticated user’s home timeline |
twitter_post_tweet
Post a new tweet to Twitter Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
text | string | Yes | — | Tweet text content (max 280 characters) |
media_ids | string[] | No | — | Array of media IDs to attach to the tweet |
reply_to_tweet_id | string | No | — | Tweet ID to reply to (for reply tweets) |
quote_tweet_id | string | No | — | Tweet ID to quote (for quote tweets) |
twitter_get_tweet
Retrieve a specific tweet by ID Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
tweet_id | string | Yes | — | Tweet ID to retrieve |
expansions | string[] | No | — | Fields to expand in the response |
tweet_fields | string[] | No | — | Tweet fields to include in the response |
user_fields | string[] | No | — | User fields to include for referenced users |
twitter_delete_tweet
Delete a tweet Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
tweet_id | string | Yes | — | Tweet ID to delete |
twitter_get_user_timeline
Get tweets from a user’s timeline Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
user_id | string | Yes | — | User ID whose timeline to retrieve |
max_results | number | No | 10 | Maximum number of tweets to return (5-100) |
exclude | string[] | No | — | Types of tweets to exclude |
since_id | string | No | — | Return tweets posted after this tweet ID |
until_id | string | No | — | Return tweets posted before this tweet ID |
start_time | string | No | — | Start time for tweets (ISO 8601 format) |
end_time | string | No | — | End time for tweets (ISO 8601 format) |
tweet_fields | string[] | No | — | Tweet fields to include in the response |
twitter_search_tweets
Search for tweets using Twitter search API Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
query | string | Yes | — | Search query (supports Twitter search operators like from:, to:, #hashtag, etc.) |
max_results | number | No | 10 | Maximum number of tweets to return (10-100) |
sort_order | string | No | "recency" | Sort order for results |
start_time | string | No | — | Start time for search (ISO 8601 format) |
end_time | string | No | — | End time for search (ISO 8601 format) |
since_id | string | No | — | Return tweets posted after this tweet ID |
until_id | string | No | — | Return tweets posted before this tweet ID |
tweet_fields | string[] | No | — | Tweet fields to include in the response |
user_fields | string[] | No | — | User fields to include for tweet authors |
twitter_get_user_by_username
Get user information by username Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
username | string | Yes | — | Twitter username (without @) |
user_fields | string[] | No | — | User fields to include in the response |
expansions | string[] | No | — | Fields to expand in the response |
twitter_get_user_by_id
Get user information by user ID Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
user_id | string | Yes | — | Twitter user ID |
user_fields | string[] | No | — | User fields to include in the response |
expansions | string[] | No | — | Fields to expand in the response |
twitter_follow_user
Follow a user on Twitter Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
target_user_id | string | Yes | — | User ID to follow |
twitter_unfollow_user
Unfollow a user on Twitter Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
target_user_id | string | Yes | — | User ID to unfollow |
twitter_get_followers
Get followers of a user Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
user_id | string | Yes | — | User ID whose followers to retrieve |
max_results | number | No | 100 | Maximum number of followers to return (1-1000) |
pagination_token | string | No | — | Token for pagination |
user_fields | string[] | No | — | User fields to include in the response |
twitter_get_following
Get users that a user is following Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
user_id | string | Yes | — | User ID whose following list to retrieve |
max_results | number | No | 100 | Maximum number of users to return (1-1000) |
pagination_token | string | No | — | Token for pagination |
user_fields | string[] | No | — | User fields to include in the response |
twitter_like_tweet
Like a tweet Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
tweet_id | string | Yes | — | Tweet ID to like |
twitter_unlike_tweet
Unlike a tweet Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
tweet_id | string | Yes | — | Tweet ID to unlike |
twitter_retweet
Retweet a tweet Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
tweet_id | string | Yes | — | Tweet ID to retweet |
twitter_unretweet
Remove a retweet Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
tweet_id | string | Yes | — | Tweet ID to unretweet |
twitter_upload_media
Upload media (image/video) to Twitter for use in tweets Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
media_url | string | Yes | — | URL of the media file to upload |
media_category | string | No | "tweet_image" | Category of media being uploaded |
alt_text | string | No | — | Alt text for accessibility (recommended for images) |
twitter_get_mentions
Get tweets that mention the authenticated user Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
max_results | number | No | 10 | Maximum number of mentions to return (5-100) |
since_id | string | No | — | Return mentions after this tweet ID |
until_id | string | No | — | Return mentions before this tweet ID |
start_time | string | No | — | Start time for mentions (ISO 8601 format) |
end_time | string | No | — | End time for mentions (ISO 8601 format) |
tweet_fields | string[] | No | — | Tweet fields to include in the response |
user_fields | string[] | No | — | User fields to include for tweet authors |
twitter_get_home_timeline
Get the authenticated user’s home timeline Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
max_results | number | No | 10 | Maximum number of tweets to return (5-100) |
exclude | string[] | No | — | Types of tweets to exclude |
since_id | string | No | — | Return tweets after this tweet ID |
until_id | string | No | — | Return tweets before this tweet ID |
tweet_fields | string[] | No | — | Tweet fields to include in the response |
user_fields | string[] | No | — | User fields to include for tweet authors |

