Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Twitter MCP search tweets about MCP servers"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP server for Twitter/X — search tweets, post, reply, and engage via AI agents.
Built by is.team — the AI-native project management platform.
Add to your MCP config (.mcp.json for Claude Code, or Claude Desktop settings):
{
"mcpServers": {
"twitter": {
"command": "npx",
"args": ["-y", "@isteam/twitter-mcp"],
"env": {
"TWITTER_API_KEY": "your-api-key",
"TWITTER_API_SECRET": "your-api-secret",
"TWITTER_ACCESS_TOKEN": "your-access-token",
"TWITTER_ACCESS_TOKEN_SECRET": "your-access-token-secret"
}
}
}
}Related MCP server: X(Twitter) V2 MCP Server
Tool | Description |
| Search tweets by keywords, hashtags, or phrases (max 100 results) |
| Get recent mentions of the authenticated user |
| Get a user's recent tweets by username |
Tool | Description |
| Post a new tweet (max 280 characters) |
| Reply to a tweet |
| Quote tweet with your commentary |
| Delete a tweet |
| Like a tweet |
| Retweet a tweet |
| Follow a user by username |
Tool | Description |
| Get authenticated user info (followers, following, tweet count) |
| Get a specific tweet with author info and metrics |
| Look up a user by username |
| Update your profile (name, bio, url, location) |
Variable | Required | Description |
| Yes | Twitter API key (consumer key) |
| Yes | Twitter API secret (consumer secret) |
| Yes | OAuth 1.0a access token |
| Yes | OAuth 1.0a access token secret |
Go to the Twitter Developer Portal
Create a project and app
Set up OAuth 1.0a with read and write permissions
Generate your access token and secret from the "Keys and tokens" tab
Copy all four values into your MCP config
Twitter API v2 enforces per-endpoint rate limits in 15-minute windows:
Endpoint | Limit | Notes |
| 300 / 15 min | ~20/min |
| 450 / 15 min | Requires Basic tier |
| 300 / 15 min | |
| 300 / 15 min | |
| 300 / 15 min | |
| 450 / 15 min |
Idempotency note: Twitter API does not deduplicate identical tweets — posting the same text twice creates two tweets. If your agent retries on timeout, it may create duplicates. Use get_user_tweets to verify before retrying a post.
Backoff: When rate-limited, the API returns 429 Too Many Requests with a x-rate-limit-reset header (Unix timestamp). Wait until that time before retrying.
Monitor your brand:
"Search for tweets mentioning 'is.team' in the last 24 hours and show engagement metrics"
Engage with your audience:
"Check my recent mentions and reply to any questions with helpful answers"
Post an update:
"Tweet: Just shipped our new AI-powered project management feature! Check it out at is.team"
is.team is an AI-native project management platform where AI agents and humans collaborate as real teammates. AI agents join boards, create tasks, chat, and get work done — just like any other team member.
Part of the is.team open-source MCP ecosystem:
@isteam/mcp — Project management
@isteam/google-ads-mcp — Google Ads
@isteam/twitter-mcp — Twitter/X
@isteam/bluesky-mcp — Bluesky
@isteam/linkedin-mcp — LinkedIn
MIT
Delete a tweet by ID
Inputs: tweet_id (required).
Follow a user by username
Inputs: username (required).
Get info about the authenticated Twitter/X account
Inputs: no named parameters.
Get recent mentions of the authenticated account
Inputs: max_results.
Get details of a specific tweet by ID (author, metrics, text)
Inputs: tweet_id (required).
Look up a Twitter user profile by username
Inputs: username (required).
Get recent tweets from a specific user by username
Inputs: username (required), max_results.
Like a tweet by ID
Inputs: tweet_id (required).
Post a new tweet (max 280 chars)
Inputs: text (required).
Quote tweet — add your commentary on top of another tweet
Inputs: text (required), tweet_id (required).
Reply to a specific tweet by its ID
Inputs: text (required), tweet_id (required).
Retweet a tweet by ID
Inputs: tweet_id (required).
Search recent tweets. Supports operators: "exact phrase", from:user, -exclude, has:links, is:reply, lang:en. Requires Basic tier.
Inputs: query (required), max_results, next_token.
Update Twitter profile — name, bio/description, url, location (v1.1 API)
Inputs: name, description, url, location.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 14 tools
Each tool has a clearly distinct purpose: posting, replying, quoting, retweeting, liking, searching, etc. There is no overlap or ambiguity between tool functionalities.
All tools follow a consistent verb_noun pattern (e.g., delete_tweet, follow_user, get_tweet, like_tweet, post_tweet). The pattern is uniform and predictable.
14 tools is well-scoped for a Twitter client. It covers all essential interactions (posting, interacting, reading, searching) without being excessive or insufficient.
The set covers the major Twitter operations (tweet, reply, quote, retweet, like, follow, search, profile update). Minor gaps like unfollow/unlike are absent but do not severely hinder basic workflows.
Hosted MCP server from TwitterAPI.io that gives AI agents read-only access to Twitter/X data. 12 tools: tweet search with X operators, user profiles, a user's latest tweets, followers and followings, replies, quotes, retweeters, mentions and trends. Connect at https://mcp.twitterapi.io/mcp with a TwitterAPI.io API key or account sign-in; usage is paid per result returned.
Hosted X (Twitter) MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
X Ads (Twitter Ads) MCP server: run X campaigns, ad groups, ads and reports from AI.
Official MCP server for twitterapis.com. Twitter/X search, users, DMs, Grok, monitoring and writes.
