π₯
io.github.RyanKramer/shippost-mcp
Twitter/X tools for AI agents β read timelines, post tweets, search, and engage
0 installs
Trust: 37 β Low
Social
Ask AI about io.github.RyanKramer/shippost-mcp
Powered by Claude Β· Grounded in docs
I know everything about io.github.RyanKramer/shippost-mcp. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Loading tools...
Reviews
Documentation
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
