twitter

Tweets, users, timelines, and media

Server path: /twitter | Type: Application | PCID required: Yes

Tools

Tool	Description
twitter_delete_tweet	Delete a tweet
twitter_follow_user	Follow a user on Twitter
twitter_get_followers	Get followers of a user
twitter_get_following	Get users that a user is following
twitter_get_home_timeline	Get the authenticated user’s home timeline
twitter_get_mentions	Get tweets that mention the authenticated user
twitter_get_tweet	Retrieve a specific tweet by ID
twitter_get_user_by_id	Get user information by user ID
twitter_get_user_by_username	Get user information by username
twitter_get_user_timeline	Get tweets from a user’s timeline
twitter_like_tweet	Like a tweet
twitter_post_tweet	Post a new tweet to Twitter
twitter_retweet	Retweet a tweet
twitter_search_tweets	Search for tweets using Twitter search API
twitter_unfollow_user	Unfollow a user on Twitter
twitter_unlike_tweet	Unlike a tweet
twitter_unretweet	Remove a retweet
twitter_upload_media	Upload media (image/video) to Twitter for use in tweets

---

twitter_delete_tweet

Delete a tweet

Parameters:

Parameter	Type	Required	Default	Description
tweet_id	string	Yes	—	Tweet ID to delete

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "tweet_id": {
      "type": "string",
      "description": "Tweet ID to delete"
    }
  },
  "required": [
    "PCID",
    "tweet_id"
  ]
}

---

twitter_follow_user

Follow a user on Twitter

Parameters:

Parameter	Type	Required	Default	Description
target_user_id	string	Yes	—	User ID to follow

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "target_user_id": {
      "type": "string",
      "description": "User ID to follow"
    }
  },
  "required": [
    "PCID",
    "target_user_id"
  ]
}

---

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

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "user_id": {
      "type": "string",
      "description": "User ID whose followers to retrieve"
    },
    "max_results": {
      "type": "number",
      "default": 100,
      "description": "Maximum number of followers to return (1-1000)"
    },
    "pagination_token": {
      "type": "string",
      "description": "Token for pagination"
    },
    "user_fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "User fields to include in the response"
    }
  },
  "required": [
    "PCID",
    "user_id"
  ]
}

---

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

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "user_id": {
      "type": "string",
      "description": "User ID whose following list to retrieve"
    },
    "max_results": {
      "type": "number",
      "default": 100,
      "description": "Maximum number of users to return (1-1000)"
    },
    "pagination_token": {
      "type": "string",
      "description": "Token for pagination"
    },
    "user_fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "User fields to include in the response"
    }
  },
  "required": [
    "PCID",
    "user_id"
  ]
}

---

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

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "max_results": {
      "type": "number",
      "default": 10,
      "description": "Maximum number of tweets to return (5-100)"
    },
    "exclude": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "retweets",
          "replies"
        ]
      },
      "description": "Types of tweets to exclude"
    },
    "since_id": {
      "type": "string",
      "description": "Return tweets after this tweet ID"
    },
    "until_id": {
      "type": "string",
      "description": "Return tweets before this tweet ID"
    },
    "tweet_fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Tweet fields to include in the response"
    },
    "user_fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "User fields to include for tweet authors"
    }
  },
  "required": [
    "PCID"
  ]
}

---

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

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "max_results": {
      "type": "number",
      "default": 10,
      "description": "Maximum number of mentions to return (5-100)"
    },
    "since_id": {
      "type": "string",
      "description": "Return mentions after this tweet ID"
    },
    "until_id": {
      "type": "string",
      "description": "Return mentions before this tweet ID"
    },
    "start_time": {
      "type": "string",
      "description": "Start time for mentions (ISO 8601 format)"
    },
    "end_time": {
      "type": "string",
      "description": "End time for mentions (ISO 8601 format)"
    },
    "tweet_fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Tweet fields to include in the response"
    },
    "user_fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "User fields to include for tweet authors"
    }
  },
  "required": [
    "PCID"
  ]
}

---

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

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "tweet_id": {
      "type": "string",
      "description": "Tweet ID to retrieve"
    },
    "expansions": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "author_id",
          "referenced_tweets.id",
          "referenced_tweets.id.author_id",
          "entities.mentions.username",
          "attachments.poll_ids",
          "attachments.media_keys",
          "in_reply_to_user_id",
          "edit_history_tweet_ids",
          "geo.place_id"
        ]
      },
      "description": "Fields to expand in the response"
    },
    "tweet_fields": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "id",
          "text",
          "author_id",
          "created_at",
          "conversation_id",
          "in_reply_to_user_id",
          "referenced_tweets",
          "attachments",
          "public_metrics",
          "possibly_sensitive",
          "lang",
          "reply_settings",
          "source"
        ]
      },
      "description": "Tweet fields to include in the response"
    },
    "user_fields": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "id",
          "name",
          "username",
          "created_at",
          "description",
          "entities",
          "location",
          "pinned_tweet_id",
          "profile_image_url",
          "protected",
          "public_metrics",
          "url",
          "verified"
        ]
      },
      "description": "User fields to include for referenced users"
    }
  },
  "required": [
    "PCID",
    "tweet_id"
  ]
}

---

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

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "user_id": {
      "type": "string",
      "description": "Twitter user ID"
    },
    "user_fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "User fields to include in the response"
    },
    "expansions": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Fields to expand in the response"
    }
  },
  "required": [
    "PCID",
    "user_id"
  ]
}

---

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

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "username": {
      "type": "string",
      "description": "Twitter username (without @)"
    },
    "user_fields": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "id",
          "name",
          "username",
          "created_at",
          "description",
          "entities",
          "location",
          "pinned_tweet_id",
          "profile_image_url",
          "protected",
          "public_metrics",
          "url",
          "verified"
        ]
      },
      "description": "User fields to include in the response"
    },
    "expansions": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "pinned_tweet_id"
        ]
      },
      "description": "Fields to expand in the response"
    }
  },
  "required": [
    "PCID",
    "username"
  ]
}

---

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

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "user_id": {
      "type": "string",
      "description": "User ID whose timeline to retrieve"
    },
    "max_results": {
      "type": "number",
      "default": 10,
      "description": "Maximum number of tweets to return (5-100)"
    },
    "exclude": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "retweets",
          "replies"
        ]
      },
      "description": "Types of tweets to exclude"
    },
    "since_id": {
      "type": "string",
      "description": "Return tweets posted after this tweet ID"
    },
    "until_id": {
      "type": "string",
      "description": "Return tweets posted before this tweet ID"
    },
    "start_time": {
      "type": "string",
      "description": "Start time for tweets (ISO 8601 format)"
    },
    "end_time": {
      "type": "string",
      "description": "End time for tweets (ISO 8601 format)"
    },
    "tweet_fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Tweet fields to include in the response"
    }
  },
  "required": [
    "PCID",
    "user_id"
  ]
}

---

twitter_like_tweet

Like a tweet

Parameters:

Parameter	Type	Required	Default	Description
tweet_id	string	Yes	—	Tweet ID to like

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "tweet_id": {
      "type": "string",
      "description": "Tweet ID to like"
    }
  },
  "required": [
    "PCID",
    "tweet_id"
  ]
}

---

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)

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "text": {
      "type": "string",
      "description": "Tweet text content (max 280 characters)"
    },
    "media_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of media IDs to attach to the tweet"
    },
    "reply_to_tweet_id": {
      "type": "string",
      "description": "Tweet ID to reply to (for reply tweets)"
    },
    "quote_tweet_id": {
      "type": "string",
      "description": "Tweet ID to quote (for quote tweets)"
    }
  },
  "required": [
    "PCID",
    "text"
  ]
}

---

twitter_retweet

Retweet a tweet

Parameters:

Parameter	Type	Required	Default	Description
tweet_id	string	Yes	—	Tweet ID to retweet

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "tweet_id": {
      "type": "string",
      "description": "Tweet ID to retweet"
    }
  },
  "required": [
    "PCID",
    "tweet_id"
  ]
}

---

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

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "query": {
      "type": "string",
      "description": "Search query (supports Twitter search operators like from:, to:, #hashtag, etc.)"
    },
    "max_results": {
      "type": "number",
      "default": 10,
      "description": "Maximum number of tweets to return (10-100)"
    },
    "sort_order": {
      "type": "string",
      "enum": [
        "recency",
        "relevancy"
      ],
      "default": "recency",
      "description": "Sort order for results"
    },
    "start_time": {
      "type": "string",
      "description": "Start time for search (ISO 8601 format)"
    },
    "end_time": {
      "type": "string",
      "description": "End time for search (ISO 8601 format)"
    },
    "since_id": {
      "type": "string",
      "description": "Return tweets posted after this tweet ID"
    },
    "until_id": {
      "type": "string",
      "description": "Return tweets posted before this tweet ID"
    },
    "tweet_fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Tweet fields to include in the response"
    },
    "user_fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "User fields to include for tweet authors"
    }
  },
  "required": [
    "PCID",
    "query"
  ]
}

---

twitter_unfollow_user

Unfollow a user on Twitter

Parameters:

Parameter	Type	Required	Default	Description
target_user_id	string	Yes	—	User ID to unfollow

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "target_user_id": {
      "type": "string",
      "description": "User ID to unfollow"
    }
  },
  "required": [
    "PCID",
    "target_user_id"
  ]
}

---

twitter_unlike_tweet

Unlike a tweet

Parameters:

Parameter	Type	Required	Default	Description
tweet_id	string	Yes	—	Tweet ID to unlike

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "tweet_id": {
      "type": "string",
      "description": "Tweet ID to unlike"
    }
  },
  "required": [
    "PCID",
    "tweet_id"
  ]
}

---

twitter_unretweet

Remove a retweet

Parameters:

Parameter	Type	Required	Default	Description
tweet_id	string	Yes	—	Tweet ID to unretweet

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "tweet_id": {
      "type": "string",
      "description": "Tweet ID to unretweet"
    }
  },
  "required": [
    "PCID",
    "tweet_id"
  ]
}

---

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)

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "media_url": {
      "type": "string",
      "description": "URL of the media file to upload"
    },
    "media_category": {
      "type": "string",
      "enum": [
        "tweet_image",
        "tweet_video",
        "tweet_gif"
      ],
      "default": "tweet_image",
      "description": "Category of media being uploaded"
    },
    "alt_text": {
      "type": "string",
      "description": "Alt text for accessibility (recommended for images)"
    }
  },
  "required": [
    "PCID",
    "media_url"
  ]
}