Shippost Mcp

io.github.RyanKramerPublished by GitHub account RyanKramerv0.1.1Updated Oct 27, 2026

Twitter/X tools for AI agents — read timelines, post tweets, search, and engage

VerifiedSTDIODesktop onlyCommunication & CollaborationMedia & Design

Overview

AI-generated overview

Local MCP server that lets an AI agent read, post, and engage on Twitter/X, with optional paid AI drafting and analytics tools.

What you can do
  • Read profiles, timelines, mentions, single tweets and recent search results
  • Post tweets, reply to tweets, like, retweet and follow users
  • AI-assisted drafting of replies, tweets and threads, plus opportunity finding, account analysis and engagement analytics (paid tier)
When to use it
Useful when you want an assistant to work directly in a Twitter/X account: monitoring mentions and timelines, drafting and publishing posts, or engaging with other users from a chat session.
Requirements
Runs locally as a Python package installed with pip. Needs a Twitter OAuth 2.0 access token in TWITTER_ACCESS_TOKEN; TWITTER_REFRESH_TOKEN and TWITTER_CLIENT_ID enable automatic token renewal. The AI drafting and analytics tools additionally need a ShipPost API key in SHIPPOST_API_KEY. Network access to Twitter/X and ShipPost is required.
Before you install
Requires Twitter/X OAuth credentials and, for AI features, a ShipPost API key; all are secrets stored in the local configuration. Several tools act publicly on the account: posting, replying, liking, retweeting and following cannot be undone by the assistant. The paid AI tools depend on a ShipPost subscription or key that may involve cost. Account data and drafted content are sent to Twitter/X and, for AI features, to ShipPost.

Installation

In SourceWeft

  1. Open Shippost Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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:

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

bash
pip install shippost-mcp

Free Tools

ToolDescription
get_my_profileGet your Twitter profile
get_timelineRead your home timeline
get_mentionsGet tweets mentioning you
get_user_profileLook up any user's profile
get_tweetGet a specific tweet by ID
search_tweetsSearch recent tweets
post_tweetPost a tweet
reply_to_tweetReply to a tweet
like_tweetLike a tweet
retweetRetweet a tweet
follow_userFollow a user

Paid AI Tools (requires ShipPost API key)

ToolDescription
find_opportunitiesAI scans your timeline for the best tweets to reply to
draft_replyAI drafts a reply in your voice
draft_tweetAI drafts an original tweet
draft_threadAI drafts a full thread
analyze_accountAI analyzes any Twitter account
get_performanceAI-powered engagement analytics

Get your API key at shippost.ai

Configuration

Env VarRequiredDescription
TWITTER_ACCESS_TOKENYesOAuth 2.0 access token
TWITTER_REFRESH_TOKENRecommendedFor automatic token renewal
TWITTER_CLIENT_IDFor refreshYour Twitter app's client ID
SHIPPOST_API_KEYFor AI featuresGet at shippost.ai

License

MIT

Source: README.md at commit f5bfad4

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts