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
Metadata
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 | Provenance | Actions |
|---|---|---|---|---|
| shippost_mcp-0.1.1.tar.gz | 11.9 kB | Without provenance | Details for shippost_mcp-0.1.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| shippost_mcp-0.1.1-py3-none-any.whl | Python 3 | none | any | Details for shippost_mcp-0.1.1-py3-none-any.whl |
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
|
Security for shippost-mcp 0.1.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
