shippost-mcp

Twitter/X tools for AI agents — read timelines, post tweets, search, and engage

GitHub

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

ToolDescription
get_my_profileGet your Twitter profile
get_timelineRead your home timeline
get_mentionsGet tweets mentioning you
get_user_profileLook up any user's profile
get_tweetGet a specific tweet by ID
search_tweetsSearch recent tweets
post_tweetPost a tweet
reply_to_tweetReply to a tweet
like_tweetLike a tweet
retweetRetweet a tweet
follow_userFollow a user

Paid AI Tools (requires ShipPost API key)

ToolDescription
find_opportunitiesAI scans your timeline for the best tweets to reply to
draft_replyAI drafts a reply in your voice
draft_tweetAI drafts an original tweet
draft_threadAI drafts a full thread
analyze_accountAI analyzes any Twitter account
get_performanceAI-powered engagement analytics

Get your API key at shippost.ai

Configuration

Env VarRequiredDescription
TWITTER_ACCESS_TOKENYesOAuth 2.0 access token
TWITTER_REFRESH_TOKENRecommendedFor automatic token renewal
TWITTER_CLIENT_IDFor refreshYour Twitter app's client ID
SHIPPOST_API_KEYFor AI featuresGet at shippost.ai

License

MIT

Servidores relacionados