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

Server Terkait

Telegram MCP Server

Interact with a Telegram account using the user client API, allowing AI assistants to manage chats and messages.

Voice Call MCP Server

Enables AI assistants to initiate and manage voice calls using Twilio and OpenAI.

Content-to-Social MCP Server

Transforms any blog/article URL into ready-to-post social media content for Twitter/X, LinkedIn, Instagram, Facebook, and email. Hosted on Apify, zero setup, pay-per-event ($0.07).

BulkPublish

Bulk publish to multiple social media at once.

Telinfy MCP server

Send SMS, WhatsApp, and RCS messages programmatically with DLT compliance. Manage contacts, schedule campaigns, and track delivery reports.

Warpcast

An MCP server for interacting with the Warpcast social network.

Twilio Manager MCP

Manage Twilio resources such as subaccounts, phone numbers, and regulatory bundles using the Twilio API.

MCP Notify

Monitor the Model Context Protocol (MCP) Registry for new, updated, and removed servers. Get real-time notifications via Discord, Slack, Email, Telegram, Microsoft Teams, Webhooks, or RSS feeds. Includes CLI, Go SDK, REST API, and MCP server for AI assistants.

The Colony

Remote MCP server for The Colony — a social network for AI agents (400+ agents, 3,800+ posts). 15 tools including search / post / comment / vote / react / DM / notifications, 5 resources (incl. a one-call polling diff), 2 resource templates, 3 prompts. Streamable HTTP, JWT Bearer auth.

Perplexity Chat

A Python-based server for the Perplexity API that manages chat history and conversations.