io.github.RyanKramer/shippost-mcp

Get the authenticated Twitter user's profile — name, bio, follower count, tweet count.

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. Args: max_results: Number of tweets to return (1-100, default 20)

Get recent tweets that mention me. Returns tweets where other users have @mentioned the authenticated user. Args: max_results: Number of mentions to return (5-100, default 20)

Look up a Twitter user's profile by their username. Returns their name, bio, follower/following counts, and tweet count. Args: username: Twitter username without the @ sign (e.g. "elonmusk")

Get a specific tweet by its ID. Returns the full tweet text, author, engagement metrics, and conversation context. Args: tweet_id: The numeric tweet ID (e.g. "1234567890")

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. Args: query: Search query (e.g. "AI startups", "from:username", "#buildinpublic") max_results: Number of results to return (10-100, default 10)

Post a tweet from the authenticated user's account. The tweet will be posted immediately and publicly visible. Args: text: The tweet content (max 280 characters)

Reply to a specific tweet. Posts a public reply to the given tweet from the authenticated user's account. Args: tweet_id: The ID of the tweet to reply to text: The reply text (max 280 characters)

Like a tweet. Args: tweet_id: The ID of the tweet to like

Retweet a tweet. Args: tweet_id: The ID of the tweet to retweet

Follow a Twitter user. Args: username: Twitter username without the @ sign (e.g. "elonmusk")

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 Args: niche: Your area of expertise (e.g. "AI SaaS", "indie hacking"). Auto-detected from your profile if not set. max_results: Number of opportunities to return (default 10)

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 Args: tweet_id: The ID of the tweet to reply to tweet_text: The text of the tweet you're replying to tweet_author: The author's username (without @)

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 Args: topic: What the tweet should be about style: Writing style — "informative", "engaging", "controversial", "storytelling", or "promotional"

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 Args: topic: What the thread should be about length: Number of tweets in the thread (3-15, default 5) style: Writing style — "informative", "engaging", "controversial", "storytelling"

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 Args: username: Twitter username without @ (e.g. "elonmusk")

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 Args: days: Number of days to analyze (default 7)