About io.github.RyanKramer/shippost-mcp
io.github.RyanKramer/shippost-mcp is an MCP server in the Social category: twitter/X tools for AI agents — read timelines, post tweets, search, and engage.
Install
uvx shippost-mcppip install shippost-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (11)
follow_userFollow a user
Parameters not published.
get_mentionsGet tweets mentioning you
Parameters not published.
get_my_profileGet your Twitter profile
Parameters not published.
get_timelineRead your home timeline
Parameters not published.
get_tweetGet a specific tweet by ID
Parameters not published.
get_user_profileLook up any user's profile
Parameters not published.
like_tweetLike a tweet
Parameters not published.
post_tweetPost a tweet
Parameters not published.
reply_to_tweetReply to a tweet
Parameters not published.
retweetRetweet a tweet
Parameters not published.
search_tweetsSearch recent tweets
Parameters not published.
Ask AI
Ask AI about io.github.RyanKramer/shippost-mcp
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
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)
| 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
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.