ShipPost MCP
ShipPost MCP — 面向AI代理的Twitter/X工具
让任何AI代理(如Claude Code、Cursor、Windsurf等)都能在Twitter/X上阅读、发布和互动。
快速开始
Claude Code
添加到你的 ~/.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"
}
}
}
}从PyPI安装
pip install shippost-mcpRelated MCP server: TwitterAPI.io MCP Server
免费工具
工具 | 描述 |
| 获取你的Twitter个人资料 |
| 阅读你的主页时间线 |
| 获取提及你的推文 |
| 查看任意用户的个人资料 |
| 按ID获取特定推文 |
| 搜索最近的推文 |
| 发布推文 |
| 回复推文 |
| 点赞推文 |
| 转发推文 |
| 关注用户 |
付费AI工具(需要ShipPost API密钥)
工具 | 描述 |
| AI扫描你的时间线,找出最适合回复的推文 |
| AI以你的风格起草回复 |
| AI起草原创推文 |
| AI起草完整推文串 |
| AI分析任意Twitter账户 |
| AI驱动的互动分析 |
在 shippost.ai 获取你的API密钥
配置
环境变量 | 是否必需 | 描述 |
| 是 | OAuth 2.0访问令牌 |
| 推荐 | 用于自动续期令牌 |
| 用于刷新 | 你的Twitter应用的客户端ID |
| 用于AI功能 | 在shippost.ai获取 |
许可证
MIT
Available Tools
17 toolsanalyze_accountA
Analyze a Twitter account — who they are, what they post about, engagement patterns.
Useful for deciding whether to engage with someone or understanding their audience.
Requires a ShipPost API key (SHIPPOST_API_KEY). Get one at https://shippost.ai
Inputs: username (required). Returns: result
draft_replyA
Draft a reply to a tweet in your voice using AI.
Analyzes the tweet and generates a reply that matches your writing style. Returns a DRAFT — does not post automatically. Use reply_to_tweet() to post.
Requires a ShipPost API key (SHIPPOST_API_KEY). Get one at https://shippost.ai
Inputs: tweet_id (required), tweet_text (required), tweet_author (required). Returns: result
draft_threadA
Draft a tweet thread about a topic in your voice using AI.
Returns DRAFTS — does not post. Review and use post_tweet() for each.
Requires a ShipPost API key (SHIPPOST_API_KEY). Get one at https://shippost.ai
Inputs: topic (required), style, length. Returns: result
draft_tweetA
Draft an original tweet about a topic in your voice using AI.
Returns a DRAFT — does not post automatically. Use post_tweet() to post.
Requires a ShipPost API key (SHIPPOST_API_KEY). Get one at https://shippost.ai
Inputs: topic (required), style. Returns: result
find_opportunitiesA
Scan my timeline and find the best tweets to reply to, scored by relevance.
Uses AI to analyze each tweet and score it on:
Relevance to your niche/expertise
Engagement potential (will a reply get seen?)
Reply opportunity (can you add genuine value?)
Returns scored tweets with suggested reply angles.
Requires a ShipPost API key (SHIPPOST_API_KEY). Get one at https://shippost.ai
Inputs: niche, max_results. Returns: result
follow_userB
Follow a Twitter user.
Inputs: username (required). Returns: result
get_mentionsA
Get recent tweets that mention me.
Returns tweets where other users have @mentioned the authenticated user.
Inputs: max_results. Returns: result
get_my_profileA
Get the authenticated Twitter user's profile — name, bio, follower count, tweet count.
Inputs: no named parameters. Returns: result
get_performanceA
Get engagement analytics on your recent tweets.
Shows which tweets performed best, what's working, and trends.
Requires a ShipPost API key (SHIPPOST_API_KEY). Get one at https://shippost.ai
Inputs: days. Returns: result
get_timelineA
Get recent tweets from my home timeline.
Returns tweets with text, author, engagement metrics, and URLs. Use this to see what's happening in the user's feed.
Inputs: max_results. Returns: result
get_tweetA
Get a specific tweet by its ID.
Returns the full tweet text, author, engagement metrics, and conversation context.
Inputs: tweet_id (required). Returns: result
get_user_profileA
Look up a Twitter user's profile by their username.
Returns their name, bio, follower/following counts, and tweet count.
Inputs: username (required). Returns: result
like_tweetB
Like a tweet.
Inputs: tweet_id (required). Returns: result
post_tweetA
Post a tweet from the authenticated user's account.
The tweet will be posted immediately and publicly visible.
Inputs: text (required). Returns: result
reply_to_tweetA
Reply to a specific tweet.
Posts a public reply to the given tweet from the authenticated user's account.
Inputs: text (required), tweet_id (required). Returns: result
retweetB
Retweet a tweet.
Inputs: tweet_id (required). Returns: result
search_tweetsA
Search recent tweets by keyword or phrase.
Searches the last 7 days of public tweets. Retweets are excluded. Returns tweets with text, author, engagement metrics, and URLs.
Inputs: query (required), max_results. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 17 tools
Most tools are clearly distinct (get_tweet vs get_timeline vs get_mentions), but get_my_profile and get_user_profile could be confused if not for the 'my' vs 'user' distinction. The draft_* tools are distinct from post/reply actions.
Tools follow a consistent verb_noun pattern (get_*, post_*, reply_to_*, like_*, retweet, follow_*, draft_*, analyze_*, find_*). Minor deviation: 'retweet' lacks an underscore but is still clear and consistent with the action.
17 tools is slightly above the ideal range but appropriate for a Twitter client with both standard actions and AI-assisted features. Each tool serves a distinct purpose, though some could be consolidated (e.g., draft_tweet and draft_thread).
Covers core Twitter operations (read, post, reply, like, retweet, follow) plus analytics and AI drafting. Missing delete_tweet, unfollow, and block/mute, but the main engagement workflow is complete. The AI features add value beyond basic CRUD.
Maintenance
Related MCP Connectors
Publish and schedule tweets and threads on X (Twitter) from your AI assistant.
X (formerly Twitter) posts, profiles, and search for AI agents. Free key, self-minted, no signup.
Twitter (X) API alternative for AI agents: tweet search, profiles, followers. $0.0002 per result.
Your agent posts, schedules, queues and threads posts on X, with a human approval queue.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables LLM agents to interact with Twitter (X) for searching tweets, posting content with images, analyzing engagement, and extracting topics using the Twitter API.-
- AlicenseNot gradedqualityDmaintenanceProvides AI agents and coding assistants with Twitter data access including tweets, user profiles, followers, and search functionality.MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with X (Twitter) API v2 for posting tweets, searching, liking, retweeting, and more through natural language.MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to fully automate X/Twitter interactions including searching, posting, engaging, and managing multiple accounts without paid API keys.MIT