io.github.RyanKramer/shippost-mcp

Official

by RyanKramer · Python

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

Twitter/X integration for AI agents to read timelines, post, search, and engage.

README.md2 KBView on 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:

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

bash

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

Install

Configuration

Environment variables

TWITTER_ACCESS_TOKENrequiredsecret

Your Twitter OAuth 2.0 access token

TWITTER_REFRESH_TOKENsecret

Twitter refresh token for automatic renewal

TWITTER_CLIENT_ID

Your Twitter app client ID (needed for token refresh)

SHIPPOST_API_KEYsecret

ShipPost API key for AI-powered features (get at https://shippost.ai)

claude_desktop_config.json

{
  "mcpServers": {
    "shippost-mcp": {
      "command": "uvx",
      "args": [
        "shippost-mcp"
      ],
      "env": {
        "TWITTER_ACCESS_TOKEN": "<YOUR_TWITTER_ACCESS_TOKEN>",
        "TWITTER_REFRESH_TOKEN": "<YOUR_TWITTER_REFRESH_TOKEN>",
        "TWITTER_CLIENT_ID": "<YOUR_TWITTER_CLIENT_ID>",
        "SHIPPOST_API_KEY": "<YOUR_SHIPPOST_API_KEY>"
      }
    }
  }
}