shippost-mcp

ShipPost MCP — Twitter/X tools for AI agents

Give any AI agent (Claude Code, Cursor, Windsurf, etc.) the ability to read, write, and engage on Twitter/X.

Quick Start

Claude Code

Add to your ~/.claude/settings.json:

{
  "mcpServers": {
    "twitter": {
      "command": "shippost-mcp",
      "env": {
        "TWITTER_ACCESS_TOKEN": "your-access-token",
        "TWITTER_REFRESH_TOKEN": "your-refresh-token",
        "TWITTER_CLIENT_ID": "your-client-id"
      }
    }
  }
}

Install from PyPI

pip install shippost-mcp

Free Tools

Tool	Description
get_my_profile	Get your Twitter profile
get_timeline	Read your home timeline
get_mentions	Get tweets mentioning you
get_user_profile	Look up any user's profile
get_tweet	Get a specific tweet by ID
search_tweets	Search recent tweets
post_tweet	Post a tweet
reply_to_tweet	Reply to a tweet
like_tweet	Like a tweet
retweet	Retweet a tweet
follow_user	Follow a user

Paid AI Tools (requires ShipPost API key)

Tool	Description
find_opportunities	AI scans your timeline for the best tweets to reply to
draft_reply	AI drafts a reply in your voice
draft_tweet	AI drafts an original tweet
draft_thread	AI drafts a full thread
analyze_account	AI analyzes any Twitter account
get_performance	AI-powered engagement analytics

Get your API key at shippost.ai

Configuration

Env Var	Required	Description
TWITTER_ACCESS_TOKEN	Yes	OAuth 2.0 access token
TWITTER_REFRESH_TOKEN	Recommended	For automatic token renewal
TWITTER_CLIENT_ID	For refresh	Your Twitter app's client ID
SHIPPOST_API_KEY	For AI features	Get at shippost.ai

License

MIT