
Shippost Mcp
Gives Claude direct access to Twitter/X through OAuth 2.0, exposing the standard operations you'd expect: reading timelines and mentions, posting tweets and replies, searching, liking, retweeting, and following. The free tier covers all basic Twitter API interactions. There's also a paid ShipPost AI layer that adds higher-level capabilities like scanning your timeline for engagement opportunities, drafting replies in your voice, and analyzing accounts. Useful when you want Claude to monitor Twitter conversations, engage with relevant tweets, or handle routine social media tasks without leaving your editor. Supports Claude Code, Cursor, and similar MCP-compatible environments.
- tools
- 17
- auth
- Secret needed
- transport
- STDIO
- env vars
- 4
- last updated
- Mar 29, 2026
Tools
17 toolsPublic tool metadata for what this MCP can expose to an agent.
get_my_profileGet your Twitter profile
Get your Twitter profile
No parameter schema in public metadata yet.
get_timelineRead your home timeline
Read your home timeline
No parameter schema in public metadata yet.
get_mentionsGet tweets mentioning you
Get tweets mentioning you
No parameter schema in public metadata yet.
get_user_profileLook up any user's profile
Look up any user's profile
No parameter schema in public metadata yet.
get_tweetGet a specific tweet by ID
Get a specific tweet by ID
No parameter schema in public metadata yet.
search_tweetsSearch recent tweets
Search recent tweets
No parameter schema in public metadata yet.
post_tweetPost a tweet
Post a tweet
No parameter schema in public metadata yet.
reply_to_tweetReply to a tweet
Reply to a tweet
No parameter schema in public metadata yet.
like_tweetLike a tweet
Like a tweet
No parameter schema in public metadata yet.
retweetRetweet a tweet
Retweet a tweet
No parameter schema in public metadata yet.
follow_userFollow a user
Follow a user
No parameter schema in public metadata yet.
find_opportunitiesAI scans your timeline for the best tweets to reply to
AI scans your timeline for the best tweets to reply to
No parameter schema in public metadata yet.
draft_replyAI drafts a reply in your voice
AI drafts a reply in your voice
No parameter schema in public metadata yet.
draft_tweetAI drafts an original tweet
AI drafts an original tweet
No parameter schema in public metadata yet.
draft_threadAI drafts a full thread
AI drafts a full thread
No parameter schema in public metadata yet.
analyze_accountAI analyzes any Twitter account
AI analyzes any Twitter account
No parameter schema in public metadata yet.
get_performanceAI-powered engagement analytics
AI-powered engagement analytics
No parameter schema in public metadata yet.
Sponsors
Configuration
TWITTER_ACCESS_TOKEN*secretYour Twitter OAuth 2.0 access token
TWITTER_REFRESH_TOKENsecretTwitter refresh token for automatic renewal
TWITTER_CLIENT_IDYour Twitter app client ID (needed for token refresh)
SHIPPOST_API_KEYsecretShipPost API key for AI-powered features (get at https://shippost.ai)
Readme
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)
Details
- Repository
- github.com/ryankramer/shippost-mcp
- Categories
- Search & Web Crawling, Media & Entertainment
- Package
shippost-mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active