X (Twitter)
Monitor your X account for mentions, brand discussions, and industry trends. Phyllax uses the official Twitter API v2 to search for tweets mentioning you or your keywords.
Quick Setup
- Go to developer.x.com/en/portal/dashboard
- Create a project and app if you haven't already
- Under User authentication settings, enable OAuth 1.0a with Read and Write permissions
- Set App type to Native App
- Set Callback URL to
https://phyllax.com/callback - Go to your app → Keys and Tokens
- Under Consumer Keys, copy the API Key and API Key Secret
- Under Authentication Tokens → OAuth 1.0a, click Generate to get Access Token and Access Token Secret
- In Phyllax → Integrations → X (Twitter) → Connect → paste all four values
Required Credentials
| Field | Where to find it |
|---|---|
| API Key | developer.x.com → Your App → Keys and Tokens → Consumer Keys |
| API Key Secret | developer.x.com → Your App → Keys and Tokens → Consumer Keys |
| Access Token | developer.x.com → Your App → Keys and Tokens → OAuth 1.0a → Generate |
| Access Token Secret | developer.x.com → Your App → Keys and Tokens → OAuth 1.0a → Generate |
All four keys required
X's API uses OAuth 1.0a which requires all four credentials. Generate them all from the same app on the developer portal. Make sure OAuth 1.0a is enabled (not just OAuth 2.0).
What Phyllax Monitors
| Schedule | What it checks |
|---|---|
| Mentions & replies | Searches for tweets mentioning your account — replies, quote tweets, @mentions |
| Negative mentions | Searches for negative or complaint tweets about your account or brand |
| Keyword mentions | Searches for tweets mentioning a specific keyword or hashtag |
| Brand monitoring | Searches for tweets about your brand — summarizes sentiment |
| Industry news | Searches for trending discussions in your industry |
| Customer questions | Searches for questions directed at your account |
Available tools
Phyllax's X integration uses two core tools: search_tweets (search for any tweets by keyword, mention, or hashtag) and post_tweet (post a tweet on your behalf, with confirmation). All monitoring schedules use search to find relevant activity.
Notification Actions
When X finds something important, the notification card shows:
- Reply to comment — AI drafts a reply you can edit before posting via
post_tweet - View post — open the tweet on X
- Hide comment — mute the user
- View analytics — see engagement context
All action chips that involve writing (Reply, etc.) open the AI draft panel — AI generates a suggested response that you review and confirm before posting.
Limitations
- No DM access — Twitter API v2 restricts DM endpoints. Phyllax cannot read or send direct messages.
- No follower analytics — Follower counts and changes are not available via search.
- Rate limits — Twitter's Free tier allows 10 searches per month. The Basic tier ($100/month) provides 10,000 tweets/month. Check your tier at developer.x.com.
Troubleshooting
"401 Unauthorized" error
One or more of your four API keys is incorrect. Regenerate all four from developer.x.com → Your App → Keys and Tokens and update them in Phyllax.
"403 Forbidden — You are not permitted"
Your X developer account may be on the Free tier, which has very limited API access (10 searches/month). The Basic tier is required for regular monitoring.
Server exits immediately
Make sure you're using all four OAuth 1.0a credentials (not the OAuth 2.0 Bearer Token). The MCP server requires OAuth 1.0a to authenticate.