# twitter-api

## Quick Start

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

# Browse available tools
npx -y smithery tool list microchipgnu/twitter-api

# Get full schema for a tool
npx -y smithery tool get microchipgnu/twitter-api getUserInfo

# Call a tool
npx -y smithery tool call microchipgnu/twitter-api getUserInfo '{}'
```

## Direct MCP Connection

Endpoint: `https://twitter-api--microchipgnu.run.tools`

## Tools (15)

- `getUserInfo` — Get Twitter user information by username
- `getUserTweets` — Get recent tweets from a user
- `getUserFollowers` — Get followers of a Twitter user
- `getUserFollowing` — Get users that a Twitter user is following
- `searchUsers` — Search for Twitter users by keyword
- `getTweetsByIds` — Get tweets by their IDs
- `getTweetReplies` — Get replies to a specific tweet
- `advancedTweetSearch` — Perform advanced search for tweets with filters
- `getTweetQuotes` — Get quotes (retweets with comments) of a specific tweet
- `getTweetThread` — Get the entire conversation thread for a tweet
- `getUserMentions` — Get tweets mentioning a specific user
- `getTrends` — Get trending topics by location
- `checkFollowRelationship` — Check if one user follows another user
- `getListTweets` — Get tweets from a Twitter List
- `batchGetUsers` — Get multiple user profiles by user IDs (batch operation)

```bash
# Get full input/output schema for a tool
npx -y smithery tool get microchipgnu/twitter-api <tool-name>
```
