Give any AI agent (Claude Code, Cursor, Windsurf, etc.) the ability to read, write, and engage on Twitter/X.
Give any AI agent (Claude Code, Cursor, Windsurf, etc.) the ability to read, write, and engage on Twitter/X. That is what the shippost mcp mcp server brings to an AI assistant: the same capability, reachable through the Model Context Protocol rather than a separate app or dashboard.
The server publishes 14 tools. What each one is for:
get_my_profile — Get your Twitter profileget_timeline — Read your home timelineget_mentions — Get tweets mentioning youget_user_profile — Look up any user's profileget_tweet — Get a specific tweet by IDsearch_tweets — Search recent tweetspost_tweet — Post a tweetreply_to_tweet — Reply to a tweetlike_tweet — Like a tweetretweet — Retweet a tweetfollow_user — Follow a userfind_opportunities — AI scans your timeline for the best tweets to reply toConfiguration is passed through the environment: TWITTER_ACCESS_TOKEN, TWITTER_REFRESH_TOKEN, TWITTER_CLIENT_ID, SHIPPOST_API_KEY. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.
The server ships on PyPI as shippost-mcp, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.
Among the developer tooling options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Shippost MCP's toolset — get_my_profile, get_timeline, get_mentions and 11 more — is a fair guide to whether it matches your workflow. It is maintained by ryankramer; worth a glance at recent repository activity before you build anything load-bearing on it.
This entry was verified against Shippost MCP's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.
| Tool | What it does |
|---|---|
| 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 |
| 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 |
{
"mcpServers": {
"twitter": {
"command": "shippost-mcp",
"env": {
"TWITTER_ACCESS_TOKEN": "your-access-token",
"TWITTER_REFRESH_TOKEN": "your-refresh-token",
"TWITTER_CLIENT_ID": "your-client-id"
}
}
}
}Configuration as documented by the project. Restart the client after saving.
| Variable | Description | Required |
|---|---|---|
| TWITTER_ACCESS_TOKEN | Credential the server authenticates with. | Yes |
| TWITTER_REFRESH_TOKEN | Credential the server authenticates with. | Yes |
| TWITTER_CLIENT_ID | Configuration value read at startup. | Optional |
| SHIPPOST_API_KEY | Credential the server authenticates with. | Yes |
Kill hallucinated APIs — version-accurate, up-to-date library documentation injected straight into context.
Microsoft's official browser automation server — drive a real browser through the accessibility tree, no screenshots needed.
GitHub's official server — repos, issues, pull requests, Actions and code security, straight from your assistant.
Issue tracking at the speed of conversation — Linear's official hosted server with OAuth and zero install.
Local repository surgery — status, diffs, commits, branches and history for any repo on disk.
Timezone sanity for AI — current time anywhere and correct conversions, without the model doing date math.