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

Máy chủ liên quan

NotebookLM Web Importer

Nhập trang web và video YouTube vào NotebookLM chỉ với một cú nhấp. Được tin dùng bởi hơn 200.000 người dùng.

Cài đặt tiện ích Chrome