Twitterapi Mcp Server

{
  "type": "object",
  "required": [
    "woeid"
  ],
  "properties": {
    "count": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1,
      "description": "Max trends to return (default API behavior; may be silently capped by API)."
    },
    "woeid": {
      "type": "integer",
      "description": "Yahoo Where-On-Earth ID for the location. Common values: 1 = Worldwide, 23424977 = USA, 23424975 = UK, 23424856 = Japan. Use 1 for global trends if unsure."
    }
  }
}

{
  "type": "object",
  "required": [
    "tweetId"
  ],
  "properties": {
    "cursor": {
      "type": "string",
      "description": "Pagination cursor; omit for first page (~20 per page)."
    },
    "tweetId": {
      "type": "string",
      "description": "Numeric ID of the tweet to fetch quote-tweets for."
    },
    "sinceTime": {
      "type": "integer",
      "description": "Unix timestamp (seconds) lower bound."
    },
    "untilTime": {
      "type": "integer",
      "description": "Unix timestamp (seconds) upper bound."
    },
    "includeReplies": {
      "type": "boolean",
      "description": "Include reply-type quote-tweets in addition to top-level. Default false."
    }
  }
}

{
  "type": "object",
  "required": [
    "tweetId"
  ],
  "properties": {
    "cursor": {
      "type": "string",
      "description": "Pagination cursor; omit for first page (~20 replies per page)."
    },
    "tweetId": {
      "type": "string",
      "description": "Numeric ID of the tweet to fetch replies for."
    },
    "queryType": {
      "enum": [
        "Latest",
        "Top"
      ],
      "type": "string",
      "description": "'Latest' or 'Top' — sort order of replies. Default 'Latest'."
    }
  }
}

{
  "type": "object",
  "required": [
    "tweetId"
  ],
  "properties": {
    "cursor": {
      "type": "string",
      "description": "Pagination cursor; omit for first page (~100 per page)."
    },
    "tweetId": {
      "type": "string",
      "description": "Numeric ID of the tweet to fetch retweeters for."
    }
  }
}

{
  "type": "object",
  "required": [
    "tweet_ids"
  ],
  "properties": {
    "tweet_ids": {
      "type": "string",
      "description": "Comma-separated tweet IDs (e.g. '1234567890,9876543210'). Batch fetch up to 100 tweets in one call. Tweet IDs are numeric strings."
    }
  }
}

{
  "type": "object",
  "required": [
    "userName"
  ],
  "properties": {
    "userName": {
      "type": "string",
      "description": "Twitter/X screen name without @ — fetches the user's profile 'about' / bio page."
    }
  }
}

{
  "type": "object",
  "required": [
    "userName"
  ],
  "properties": {
    "cursor": {
      "type": "string",
      "description": "Pagination cursor from previous response's next_cursor. Omit for first page."
    },
    "pageSize": {
      "type": "integer",
      "maximum": 200,
      "minimum": 1,
      "description": "Followers per page (default 200, max 200). Each follower includes full profile metadata (name, bio, follower count, etc.)."
    },
    "userName": {
      "type": "string",
      "description": "Twitter/X screen name without @ — fetches followers of this user."
    }
  }
}

{
  "type": "object",
  "required": [
    "userName"
  ],
  "properties": {
    "cursor": {
      "type": "string",
      "description": "Pagination cursor; omit for first page."
    },
    "pageSize": {
      "type": "integer",
      "maximum": 200,
      "minimum": 1,
      "description": "Followings per page (default 200, max 200). Each includes full profile metadata."
    },
    "userName": {
      "type": "string",
      "description": "Twitter/X screen name without @ — fetches accounts this user follows."
    }
  }
}

{
  "type": "object",
  "required": [
    "userName"
  ],
  "properties": {
    "userName": {
      "type": "string",
      "description": "Twitter/X screen name (handle) WITHOUT the leading @ sign. Example: 'elonmusk', not '@elonmusk'."
    }
  }
}

{
  "type": "object",
  "properties": {
    "cursor": {
      "type": "string",
      "description": "Pagination cursor; omit for first page."
    },
    "userId": {
      "type": "string",
      "description": "Twitter/X numeric user ID (e.g. '44196397'). Provide EITHER userName OR userId. Prefer userId if known — handles can change."
    },
    "userName": {
      "type": "string",
      "description": "Twitter/X screen name without @ (e.g. 'elonmusk'). Provide EITHER userName OR userId."
    },
    "includeReplies": {
      "type": "boolean",
      "description": "Include the user's reply tweets in addition to top-level tweets. Default false — only top-level tweets."
    }
  }
}

{
  "type": "object",
  "required": [
    "userName"
  ],
  "properties": {
    "cursor": {
      "type": "string",
      "description": "Pagination cursor; omit for first page (~20 per page)."
    },
    "userName": {
      "type": "string",
      "description": "Twitter/X screen name without @ — fetches tweets that mention this user (@userName)."
    },
    "sinceTime": {
      "type": "integer",
      "description": "Unix timestamp (seconds) lower bound — only mentions after this time. Omit for no lower bound."
    },
    "untilTime": {
      "type": "integer",
      "description": "Unix timestamp (seconds) upper bound. Omit for no upper bound."
    }
  }
}