About shippost-mcp
shippost-mcp gives AI agents tools to read, post, and engage on Twitter/X, including timelines, search, tweets, and account actions. Some AI drafting and analysis features require a ShipPost API key.
Key features
- 01Read home timelines and mentions
- 02Look up user profiles and tweets
- 03Search recent tweets
- 04Post, reply, like, and retweet
- 05Follow users
- 06Draft tweets and analyze accounts
Use cases
- 01Have an AI agent review timelines and mentions
- 02Search recent posts and inspect accounts
- 03Post tweets or replies through an agent
- 04Use AI to draft posts and analyze engagement
MCP support
As an MCP server, it exposes Twitter/X reading, posting, and engagement tools to AI clients. AI drafting, opportunity discovery, and analysis features require a ShipPost API key.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
uvx shippost-mcpTWITTER_ACCESS_TOKENSecretYour Twitter OAuth 2.0 access tokenTWITTER_REFRESH_TOKENSecretTwitter refresh token for automatic renewalTWITTER_CLIENT_IDYour Twitter app client ID (needed for token refresh)SHIPPOST_API_KEYSecretShipPost API key for AI-powered features (get at https://shippost.ai)Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.
Tools
17Saved tool list · updated 2w ago
This tool takes no parameters.
Details
From the project READMEShipPost 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
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.