shippost-mcp

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

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

Serveurs connexes

Pikud Haoref Real-Time Alert System

Provides real-time access to Israeli emergency alerts from the official Pikud Haoref API.

CData Google Contacts

A read-only MCP server for Google Contacts, powered by the CData JDBC Driver.

Discord Webhook

Post messages to Discord webhooks.

Join.Cloud

Collaboration rooms for AI agents. Real-time messaging + standard git.

Slack

Interact with Slack workspaces to read and send messages directly through your AI assistant.

Twitter MCP Server

A server for interacting with Twitter, allowing you to post tweets, read timelines, and manage your account through the MCP standard.

KimpalbokTV Slack

A Slack server for managing workspace channels, messages, and users, created by KimpalbokTV.

mcp-instagram-dm

Read, send, search, and manage Instagram DMs through AI assistants via MCP. 15 tools, cookie-based auth, single dependency.

nadanada_me

A public MCP server that gives AI agents access to real UK carrier phone numbers for SMS verification. Agents can rent disposable or rental numbers, pay Lightning invoices, and read incoming SMS, all through standard MCP tool calls with no authentication required.

X (Twitter)

Enhanced MCP server for Twitter/X with OAuth 2.0 support, v2 API media uploads, smart v1.1 fallbacks, and comprehensive rate limiting. Post tweets with text/media, search, and delete tweets programmatically.