Twitter/X

X (Twitter) MCP Server for Cloudflare Workers

Available Tools

63 tools available in the Twitter/X MCP server. Each tool can be called by AI assistants to perform specific actions.

twitter_pin_list

Pin a list.

Args:

listId: The list's ID

Returns: Pin status.

{
  "type": "object",
  "required": [
    "listId"
  ],
  "properties": {
    "listId": {
      "type": "string",
      "description": "List ID"
    }
  }
}

twitter_unpin_list

Unpin a list.

Args:

listId: The list's ID

Returns: Pin status.

{
  "type": "object",
  "required": [
    "listId"
  ],
  "properties": {
    "listId": {
      "type": "string",
      "description": "List ID"
    }
  }
}

twitter_add_list_member

Add a user to a list.

Args:

listId: The list's ID
userId: The user's ID to add

Returns: Membership status.

{
  "type": "object",
  "required": [
    "listId",
    "userId"
  ],
  "properties": {
    "listId": {
      "type": "string",
      "description": "List ID"
    },
    "userId": {
      "type": "string",
      "description": "User ID to add"
    }
  }
}

twitter_remove_list_member

Remove a user from a list.

Args:

listId: The list's ID
userId: The user's ID to remove

Returns: Membership status.

{
  "type": "object",
  "required": [
    "listId",
    "userId"
  ],
  "properties": {
    "listId": {
      "type": "string",
      "description": "List ID"
    },
    "userId": {
      "type": "string",
      "description": "User ID to remove"
    }
  }
}

twitter_follow_list

Follow a list.

Args:

listId: The list's ID

Returns: Follow status.

{
  "type": "object",
  "required": [
    "listId"
  ],
  "properties": {
    "listId": {
      "type": "string",
      "description": "List ID"
    }
  }
}

twitter_get_liked_tweets

Get tweets liked by a user.

Args:

userId: The user's ID
maxResults: Number of results (5-100)
paginationToken: Pagination token
format: Response format

Returns: List of liked tweets.

{
  "type": "object",
  "required": [
    "userId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "userId": {
      "type": "string",
      "description": "User ID"
    },
    "maxResults": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 5
    },
    "paginationToken": {
      "type": "string"
    }
  }
}

twitter_like_tweet

Like a tweet.

Args:

tweetId: The ID of the tweet to like

Returns: Like status.

{
  "type": "object",
  "required": [
    "tweetId"
  ],
  "properties": {
    "tweetId": {
      "type": "string",
      "description": "Tweet ID to like"
    }
  }
}

twitter_unlike_tweet

Unlike a tweet.

Args:

tweetId: The ID of the tweet to unlike

Returns: Like status.

{
  "type": "object",
  "required": [
    "tweetId"
  ],
  "properties": {
    "tweetId": {
      "type": "string",
      "description": "Tweet ID to unlike"
    }
  }
}

twitter_get_liking_users

Get users who liked a tweet.

Args:

tweetId: The tweet's ID
maxResults: Number of results (1-100)
paginationToken: Pagination token
format: Response format

Returns: List of users who liked the tweet.

{
  "type": "object",
  "required": [
    "tweetId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "tweetId": {
      "type": "string",
      "description": "Tweet ID"
    },
    "maxResults": {
      "type": "integer",
      "default": 100,
      "maximum": 100,
      "minimum": 1
    },
    "paginationToken": {
      "type": "string"
    }
  }
}

twitter_retweet

Retweet a tweet.

Args:

tweetId: The ID of the tweet to retweet

Returns: Retweet status.

{
  "type": "object",
  "required": [
    "tweetId"
  ],
  "properties": {
    "tweetId": {
      "type": "string",
      "description": "Tweet ID to retweet"
    }
  }
}

twitter_undo_retweet

Undo a retweet.

Args:

tweetId: The ID of the tweet to unretweet

Returns: Retweet status.

{
  "type": "object",
  "required": [
    "tweetId"
  ],
  "properties": {
    "tweetId": {
      "type": "string",
      "description": "Tweet ID to unretweet"
    }
  }
}

twitter_get_retweeters

Get users who retweeted a tweet.

Args:

tweetId: The tweet's ID
maxResults: Number of results (1-100)
paginationToken: Pagination token
format: Response format

Returns: List of users who retweeted.

{
  "type": "object",
  "required": [
    "tweetId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "tweetId": {
      "type": "string",
      "description": "Tweet ID"
    },
    "maxResults": {
      "type": "integer",
      "default": 100,
      "maximum": 100,
      "minimum": 1
    },
    "paginationToken": {
      "type": "string"
    }
  }
}

twitter_bookmark_tweet

Bookmark a tweet.

Args:

tweetId: The ID of the tweet to bookmark

Returns: Bookmark status.

{
  "type": "object",
  "required": [
    "tweetId"
  ],
  "properties": {
    "tweetId": {
      "type": "string",
      "description": "Tweet ID to bookmark"
    }
  }
}

twitter_remove_bookmark

Remove a bookmark from a tweet.

Args:

tweetId: The ID of the tweet to unbookmark

Returns: Bookmark status.

{
  "type": "object",
  "required": [
    "tweetId"
  ],
  "properties": {
    "tweetId": {
      "type": "string",
      "description": "Tweet ID to unbookmark"
    }
  }
}

twitter_get_bookmarks

Get the authenticated user's bookmarked tweets.

Args:

maxResults: Number of results (1-100)
paginationToken: Pagination token
format: Response format

Returns: List of bookmarked tweets.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "maxResults": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1
    },
    "paginationToken": {
      "type": "string"
    }
  }
}

twitter_get_list

Get a list by ID.

Args:

listId: The list's ID
format: Response format

Returns: List details.

{
  "type": "object",
  "required": [
    "listId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "listId": {
      "type": "string",
      "description": "List ID"
    }
  }
}

twitter_get_owned_lists

Get lists owned by a user.

Args:

userId: The user's ID
maxResults: Number of results (1-100)
paginationToken: Pagination token
format: Response format

Returns: User's owned lists.

{
  "type": "object",
  "required": [
    "userId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "userId": {
      "type": "string",
      "description": "User ID"
    },
    "maxResults": {
      "type": "integer",
      "default": 100,
      "maximum": 100,
      "minimum": 1
    },
    "paginationToken": {
      "type": "string"
    }
  }
}

twitter_get_list_memberships

Get lists a user is a member of.

Args:

userId: The user's ID
maxResults: Number of results (1-100)
paginationToken: Pagination token
format: Response format

Returns: Lists the user is a member of.

{
  "type": "object",
  "required": [
    "userId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "userId": {
      "type": "string",
      "description": "User ID"
    },
    "maxResults": {
      "type": "integer",
      "default": 100,
      "maximum": 100,
      "minimum": 1
    },
    "paginationToken": {
      "type": "string"
    }
  }
}

twitter_get_list_followers

Get users following a list.

Args:

listId: The list's ID
maxResults: Number of results (1-100)
paginationToken: Pagination token
format: Response format

Returns: List followers.

{
  "type": "object",
  "required": [
    "listId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "listId": {
      "type": "string",
      "description": "List ID"
    },
    "maxResults": {
      "type": "integer",
      "default": 100,
      "maximum": 100,
      "minimum": 1
    },
    "paginationToken": {
      "type": "string"
    }
  }
}

twitter_get_list_members

Get members of a list.

Args:

listId: The list's ID
maxResults: Number of results (1-100)
paginationToken: Pagination token
format: Response format

Returns: List members.

{
  "type": "object",
  "required": [
    "listId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "listId": {
      "type": "string",
      "description": "List ID"
    },
    "maxResults": {
      "type": "integer",
      "default": 100,
      "maximum": 100,
      "minimum": 1
    },
    "paginationToken": {
      "type": "string"
    }
  }
}

twitter_get_list_tweets

Get tweets from a list's timeline.

Args:

listId: The list's ID
maxResults: Number of results (1-100)
paginationToken: Pagination token
format: Response format

Returns: Tweets from the list.

{
  "type": "object",
  "required": [
    "listId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "listId": {
      "type": "string",
      "description": "List ID"
    },
    "maxResults": {
      "type": "integer",
      "default": 100,
      "maximum": 100,
      "minimum": 1
    },
    "paginationToken": {
      "type": "string"
    }
  }
}

twitter_create_list

Create a new list.

Args:

name: List name (required)
description: List description (optional)
private: Whether the list is private (optional)

Returns: Created list.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "List name"
    },
    "private": {
      "type": "boolean",
      "description": "Private list"
    },
    "description": {
      "type": "string",
      "description": "List description"
    }
  }
}

twitter_update_list

Update a list's metadata.

Args:

listId: The list's ID
name: New list name (optional)
description: New list description (optional)
private: New privacy setting (optional)

Returns: Updated list.

{
  "type": "object",
  "required": [
    "listId"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "List name"
    },
    "listId": {
      "type": "string",
      "description": "List ID"
    },
    "private": {
      "type": "boolean",
      "description": "Private list"
    },
    "description": {
      "type": "string",
      "description": "List description"
    }
  }
}

twitter_delete_list

Delete a list.

Args:

listId: The list's ID

Returns: Deletion confirmation.

{
  "type": "object",
  "required": [
    "listId"
  ],
  "properties": {
    "listId": {
      "type": "string",
      "description": "List ID"
    }
  }
}

twitter_unfollow_list

Unfollow a list.

Args:

listId: The list's ID

Returns: Follow status.

{
  "type": "object",
  "required": [
    "listId"
  ],
  "properties": {
    "listId": {
      "type": "string",
      "description": "List ID"
    }
  }
}

twitter_get_dm_events

Get the authenticated user's recent DM events (all conversations).

Args:

maxResults: Number of results (1-100)
paginationToken: Pagination token
format: Response format

Returns: List of DM events.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "maxResults": {
      "type": "integer",
      "default": 100,
      "maximum": 100,
      "minimum": 1
    },
    "paginationToken": {
      "type": "string"
    }
  }
}

twitter_get_dm_conversation

Get messages from a specific DM conversation.

Args:

conversationId: The conversation ID
maxResults: Number of results (1-100)
paginationToken: Pagination token
format: Response format

Returns: Messages from the conversation.

{
  "type": "object",
  "required": [
    "conversationId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "maxResults": {
      "type": "integer",
      "default": 100,
      "maximum": 100,
      "minimum": 1
    },
    "conversationId": {
      "type": "string",
      "description": "Conversation ID"
    },
    "paginationToken": {
      "type": "string"
    }
  }
}

twitter_get_dm_conversation_with_user

Get DM conversation with a specific user.

Args:

participantId: The other user's ID
maxResults: Number of results (1-100)
paginationToken: Pagination token
format: Response format

Returns: Messages from the 1-on-1 conversation.

{
  "type": "object",
  "required": [
    "participantId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "maxResults": {
      "type": "integer",
      "default": 100,
      "maximum": 100,
      "minimum": 1
    },
    "participantId": {
      "type": "string",
      "description": "Other user\\'s ID"
    },
    "paginationToken": {
      "type": "string"
    }
  }
}

twitter_send_dm

Send a direct message to an existing conversation.

Args:

conversationId: The conversation ID
text: Message text

Returns: The sent message.

{
  "type": "object",
  "required": [
    "conversationId",
    "text"
  ],
  "properties": {
    "text": {
      "type": "string",
      "description": "Message text"
    },
    "conversationId": {
      "type": "string",
      "description": "Conversation ID"
    }
  }
}

twitter_send_dm_to_user

Send a direct message to a user (creates new conversation if needed).

Args:

participantId: The recipient user's ID
text: Message text

Returns: The sent message.

{
  "type": "object",
  "required": [
    "participantId",
    "text"
  ],
  "properties": {
    "text": {
      "type": "string",
      "description": "Message text"
    },
    "participantId": {
      "type": "string",
      "description": "Recipient user ID"
    }
  }
}

twitter_create_group_dm

Create a new group DM conversation and send an initial message.

Args:

participantIds: Array of user IDs to include in the group
text: Initial message text

Returns: The created conversation and message IDs.

{
  "type": "object",
  "required": [
    "participantIds",
    "text"
  ],
  "properties": {
    "text": {
      "type": "string",
      "description": "Initial message text"
    },
    "participantIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "User IDs to include"
    }
  }
}

twitter_block_user

Block a user.

Args:

targetUserId: The ID of the user to block

Returns: Block status.

{
  "type": "object",
  "required": [
    "targetUserId"
  ],
  "properties": {
    "targetUserId": {
      "type": "string",
      "description": "User ID to block"
    }
  }
}

twitter_unblock_user

Unblock a user.

Args:

targetUserId: The ID of the user to unblock

Returns: Block status.

{
  "type": "object",
  "required": [
    "targetUserId"
  ],
  "properties": {
    "targetUserId": {
      "type": "string",
      "description": "User ID to unblock"
    }
  }
}

twitter_get_blocked_users

Get the authenticated user's blocked users.

Args:

maxResults: Number of results (1-1000)
paginationToken: Pagination token
format: Response format

Returns: List of blocked users.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "maxResults": {
      "type": "integer",
      "default": 100,
      "maximum": 1000,
      "minimum": 1
    },
    "paginationToken": {
      "type": "string"
    }
  }
}

twitter_mute_user

Mute a user.

Args:

targetUserId: The ID of the user to mute

Returns: Mute status.

{
  "type": "object",
  "required": [
    "targetUserId"
  ],
  "properties": {
    "targetUserId": {
      "type": "string",
      "description": "User ID to mute"
    }
  }
}

twitter_unmute_user

Unmute a user.

Args:

targetUserId: The ID of the user to unmute

Returns: Mute status.

{
  "type": "object",
  "required": [
    "targetUserId"
  ],
  "properties": {
    "targetUserId": {
      "type": "string",
      "description": "User ID to unmute"
    }
  }
}

twitter_get_muted_users

Get the authenticated user's muted users.

Args:

maxResults: Number of results (1-1000)
paginationToken: Pagination token
format: Response format

Returns: List of muted users.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "maxResults": {
      "type": "integer",
      "default": 100,
      "maximum": 1000,
      "minimum": 1
    },
    "paginationToken": {
      "type": "string"
    }
  }
}

twitter_get_space

Get a Space by ID.

Args:

spaceId: The Space's ID
format: Response format

Returns: Space details.

{
  "type": "object",
  "required": [
    "spaceId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "spaceId": {
      "type": "string",
      "description": "Space ID"
    }
  }
}

twitter_get_spaces

Get multiple Spaces by IDs.

Args:

spaceIds: Array of Space IDs (up to 100)
format: Response format

Returns: Array of Spaces.

{
  "type": "object",
  "required": [
    "spaceIds"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "spaceIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of Space IDs"
    }
  }
}

twitter_get_spaces_by_creator_ids

Get Spaces created by specific users.

Args:

userIds: Array of creator user IDs (up to 100)
format: Response format

Returns: Spaces created by the specified users.

{
  "type": "object",
  "required": [
    "userIds"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "userIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of creator user IDs"
    }
  }
}

twitter_search_spaces

Search for Spaces by query.

Args:

query: Search query
state: Filter by Space state (live, scheduled, all)
format: Response format

Returns: Matching Spaces.

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "Search query"
    },
    "state": {
      "enum": [
        "live",
        "scheduled",
        "all"
      ],
      "type": "string",
      "default": "all",
      "description": "Space state filter"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

twitter_get_space_buyers

Get users who purchased tickets to a Space.

Args:

spaceId: The Space's ID
format: Response format

Returns: List of users who bought tickets.

{
  "type": "object",
  "required": [
    "spaceId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "spaceId": {
      "type": "string",
      "description": "Space ID"
    }
  }
}

twitter_get_space_tweets

Get tweets shared in a Space.

Args:

spaceId: The Space's ID
format: Response format

Returns: Tweets shared in the Space.

{
  "type": "object",
  "required": [
    "spaceId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "spaceId": {
      "type": "string",
      "description": "Space ID"
    }
  }
}

twitter_create_tweet

Create a new tweet/post.

Args:

text: The text content of the tweet (required)
replyToTweetId: Tweet ID to reply to (optional)
quoteTweetId: Tweet ID to quote (optional)
mediaIds: Array of media IDs to attach (optional)
pollOptions: Array of poll options (2-4 options, optional)
pollDurationMinutes: Poll duration in minutes (5-10080, optional)

Returns: The created tweet with ID and text.

{
  "type": "object",
  "required": [
    "text"
  ],
  "properties": {
    "text": {
      "type": "string",
      "description": "Tweet text content"
    },
    "mediaIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of media IDs to attach"
    },
    "quoteTweetId": {
      "type": "string",
      "description": "Tweet ID to quote"
    },
    "replyToTweetId": {
      "type": "string",
      "description": "Tweet ID to reply to"
    }
  }
}

twitter_delete_tweet

Delete a tweet by ID.

Args:

tweetId: The ID of the tweet to delete (required)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "tweetId"
  ],
  "properties": {
    "tweetId": {
      "type": "string",
      "description": "Tweet ID to delete"
    }
  }
}

twitter_get_tweet

Get a single tweet by ID.

Args:

tweetId: The ID of the tweet (required)
format: Response format ('json' or 'markdown')

Returns: The tweet with all available fields.

{
  "type": "object",
  "required": [
    "tweetId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "tweetId": {
      "type": "string",
      "description": "Tweet ID"
    }
  }
}

twitter_get_tweets

Get multiple tweets by their IDs.

Args:

tweetIds: Array of tweet IDs (up to 100)
format: Response format

Returns: Array of tweets.

{
  "type": "object",
  "required": [
    "tweetIds"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "tweetIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of tweet IDs"
    }
  }
}

twitter_search_tweets

Search for recent tweets matching a query.

Args:

query: Search query (supports Twitter search operators)
maxResults: Number of results to return (10-100)
nextToken: Pagination token for next page
startTime: ISO 8601 start time filter
endTime: ISO 8601 end time filter
format: Response format

Returns: Paginated list of matching tweets.

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "Search query"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "endTime": {
      "type": "string",
      "description": "End time (ISO 8601)"
    },
    "nextToken": {
      "type": "string",
      "description": "Pagination token"
    },
    "startTime": {
      "type": "string",
      "description": "Start time (ISO 8601)"
    },
    "maxResults": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 10
    }
  }
}

twitter_get_user_tweets

Get tweets posted by a specific user.

Args:

userId: The user's ID (required)
maxResults: Number of results (5-100)
paginationToken: Pagination token
format: Response format

Returns: User's tweets.

{
  "type": "object",
  "required": [
    "userId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "userId": {
      "type": "string",
      "description": "User ID"
    },
    "maxResults": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 5
    },
    "paginationToken": {
      "type": "string"
    }
  }
}

twitter_get_user_mentions

Get tweets that mention a specific user.

Args:

userId: The user's ID (required)
maxResults: Number of results (5-100)
paginationToken: Pagination token
format: Response format

Returns: Tweets mentioning the user.

{
  "type": "object",
  "required": [
    "userId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "userId": {
      "type": "string",
      "description": "User ID"
    },
    "maxResults": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 5
    },
    "paginationToken": {
      "type": "string"
    }
  }
}

twitter_get_home_timeline

Get the authenticated user's home timeline (reverse chronological).

Args:

maxResults: Number of results (1-100)
paginationToken: Pagination token
format: Response format

Returns: Home timeline tweets.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "maxResults": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 1
    },
    "paginationToken": {
      "type": "string"
    }
  }
}

twitter_get_tweet_counts

Get counts of tweets matching a query over time.

Args:

query: Search query
granularity: Time bucket size (minute, hour, day)
startTime: ISO 8601 start time
endTime: ISO 8601 end time

Returns: Tweet counts by time bucket.

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "Search query"
    },
    "endTime": {
      "type": "string"
    },
    "startTime": {
      "type": "string"
    },
    "granularity": {
      "enum": [
        "minute",
        "hour",
        "day"
      ],
      "type": "string",
      "default": "hour"
    }
  }
}

twitter_get_quote_tweets

Get tweets that quote a specific tweet.

Args:

tweetId: The quoted tweet's ID
maxResults: Number of results (10-100)
paginationToken: Pagination token
format: Response format

Returns: Quote tweets.

{
  "type": "object",
  "required": [
    "tweetId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "tweetId": {
      "type": "string",
      "description": "Tweet ID"
    },
    "maxResults": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 10
    },
    "paginationToken": {
      "type": "string"
    }
  }
}

twitter_hide_reply

Hide or unhide a reply to one of your tweets.

Args:

tweetId: The reply tweet ID
hidden: Whether to hide (true) or unhide (false)

Returns: Updated hidden status.

{
  "type": "object",
  "required": [
    "tweetId",
    "hidden"
  ],
  "properties": {
    "hidden": {
      "type": "boolean",
      "description": "Hide (true) or unhide (false)"
    },
    "tweetId": {
      "type": "string",
      "description": "Reply tweet ID"
    }
  }
}

twitter_get_user

Get a user by their ID.

Args:

userId: The user's ID (required)
format: Response format ('json' or 'markdown')

Returns: User profile information.

{
  "type": "object",
  "required": [
    "userId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "userId": {
      "type": "string",
      "description": "User ID"
    }
  }
}

twitter_get_user_by_username

Get a user by their username (handle).

Args:

username: The username without @ (required)
format: Response format

Returns: User profile information.

{
  "type": "object",
  "required": [
    "username"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "username": {
      "type": "string",
      "description": "Username without @"
    }
  }
}

twitter_get_users

Get multiple users by their IDs.

Args:

userIds: Array of user IDs (up to 100)
format: Response format

Returns: Array of user profiles.

{
  "type": "object",
  "required": [
    "userIds"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "userIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of user IDs"
    }
  }
}

twitter_get_users_by_usernames

Get multiple users by their usernames.

Args:

usernames: Array of usernames without @ (up to 100)
format: Response format

Returns: Array of user profiles.

{
  "type": "object",
  "required": [
    "usernames"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "usernames": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of usernames"
    }
  }
}

twitter_get_me

Get the authenticated user's profile.

Args:

format: Response format

Returns: Authenticated user's profile information.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

twitter_get_followers

Get a user's followers.

Args:

userId: The user's ID
maxResults: Number of results (1-1000)
paginationToken: Pagination token
format: Response format

Returns: List of followers.

{
  "type": "object",
  "required": [
    "userId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "userId": {
      "type": "string",
      "description": "User ID"
    },
    "maxResults": {
      "type": "integer",
      "default": 100,
      "maximum": 1000,
      "minimum": 1
    },
    "paginationToken": {
      "type": "string"
    }
  }
}

twitter_get_following

Get users that a user is following.

Args:

userId: The user's ID
maxResults: Number of results (1-1000)
paginationToken: Pagination token
format: Response format

Returns: List of users being followed.

{
  "type": "object",
  "required": [
    "userId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "userId": {
      "type": "string",
      "description": "User ID"
    },
    "maxResults": {
      "type": "integer",
      "default": 100,
      "maximum": 1000,
      "minimum": 1
    },
    "paginationToken": {
      "type": "string"
    }
  }
}

twitter_follow_user

Follow a user.

Args:

targetUserId: The ID of the user to follow

Returns: Follow status (following, pending).

{
  "type": "object",
  "required": [
    "targetUserId"
  ],
  "properties": {
    "targetUserId": {
      "type": "string",
      "description": "User ID to follow"
    }
  }
}

twitter_unfollow_user

Unfollow a user.

Args:

targetUserId: The ID of the user to unfollow

Returns: Updated follow status.

{
  "type": "object",
  "required": [
    "targetUserId"
  ],
  "properties": {
    "targetUserId": {
      "type": "string",
      "description": "User ID to unfollow"
    }
  }
}