MCP 服务器

Twitter MCP

MCP server for Twitter/X enabling AI agents to search, post, reply, and engage with tweets.

README

@isteam/twitter-mcp

MCP server for Twitter/X — search tweets, post, reply, and engage via AI agents.

Built by is.team — the AI-native project management platform.

Quick Start

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"
      }
    }
  }
}

Tools (15)

Search & Discovery

Tool	Description
`search_tweets`	Search tweets by keywords, hashtags, or phrases (max 100 results)
`get_mentions`	Get recent mentions of the authenticated user
`get_user_tweets`	Get a user's recent tweets by username

Engagement

Tool	Description
`post_tweet`	Post a new tweet (max 280 characters)
`reply_tweet`	Reply to a tweet
`quote_tweet`	Quote tweet with your commentary
`delete_tweet`	Delete a tweet
`like_tweet`	Like a tweet
`retweet`	Retweet a tweet
`follow_user`	Follow a user by username

User & Profile

Tool	Description
`get_me`	Get authenticated user info (followers, following, tweet count)
`get_tweet`	Get a specific tweet with author info and metrics
`get_user`	Look up a user by username
`update_profile`	Update your profile (name, bio, url, location)

Environment Variables

Variable	Required	Description
`TWITTER_API_KEY`	Yes	Twitter API key (consumer key)
`TWITTER_API_SECRET`	Yes	Twitter API secret (consumer secret)
`TWITTER_ACCESS_TOKEN`	Yes	OAuth 1.0a access token
`TWITTER_ACCESS_TOKEN_SECRET`	Yes	OAuth 1.0a access token secret

Getting your credentials

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

Rate Limits & Agent Safety

Twitter API v2 enforces per-endpoint rate limits in 15-minute windows:

Endpoint	Limit	Notes
`POST /2/tweets` (post, reply, quote)	300 / 15 min	~20/min
`GET /2/tweets/search/recent`	450 / 15 min	Requires Basic tier
`POST /2/users/:id/likes`	300 / 15 min
`POST /2/users/:id/retweets`	300 / 15 min
`POST /2/users/:id/following`	300 / 15 min
`GET /2/users/:id/mentions`	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.

Usage Examples

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"

About 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: