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
1 maintainer
Release files for shippost-mcp 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| shippost_mcp-0.1.1.tar.gz | 11.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| shippost_mcp-0.1.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 21.8 kB
Release files / shippost_mcp-0.1.1.tar.gz
| Download URL | shippost_mcp-0.1.1.tar.gz |
|---|---|
| Size | 11.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
64be838bab7bf683063b83b7ed854c0a4a0c8bf04c1df2fef64c5e5f6104a6fb
|
|
BLAKE2b-256 checksum How to use checksums |
883c8d2e6b816f3cdd10d2b657971d3feee6a2879865d185a31b26d09189ec42
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.8
|
Release files / shippost_mcp-0.1.1-py3-none-any.whl
| Download URL | shippost_mcp-0.1.1-py3-none-any.whl |
|---|---|
| Size | 9.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
447ae4fd606a502d28fd385b18ab1ee701961b62203f75dc804b0bd372a4de61
|
|
BLAKE2b-256 checksum How to use checksums |
483b2ccc08b0a9b3c7a2fbdd23f1fd491c58365cd5127e7b50992e6024dd71df
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.8
|
