English Français العربية

io.github.RyanKramer/shippost-mcp

Official registry Search and web

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

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package shippost-mcp
Claude Code 
claude mcp add shippost-mcp -e 'TWITTER_ACCESS_TOKEN=<your twitter_access_token>' -e 'TWITTER_REFRESH_TOKEN=<your twitter_refresh_token>' -e 'TWITTER_CLIENT_ID=<TWITTER_CLIENT_ID>' -e 'SHIPPOST_API_KEY=<your shippost_api_key>' -- uvx shippost-mcp==0.1.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "shippost-mcp": {
            "command": "uvx",
            "args": [
                "shippost-mcp==0.1.1"
            ],
            "env": {
                "TWITTER_ACCESS_TOKEN": "<your twitter_access_token>",
                "TWITTER_REFRESH_TOKEN": "<your twitter_refresh_token>",
                "TWITTER_CLIENT_ID": "<TWITTER_CLIENT_ID>",
                "SHIPPOST_API_KEY": "<your shippost_api_key>"
            }
        }
    }
}

Environment variables

  • TWITTER_ACCESS_TOKEN required secret Your Twitter OAuth 2.0 access token
  • TWITTER_REFRESH_TOKEN secret Twitter refresh token for automatic renewal
  • TWITTER_CLIENT_ID Your Twitter app client ID (needed for token refresh)
  • SHIPPOST_API_KEY secret ShipPost API key for AI-powered features (get at https://shippost.ai)

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. ShipPost MCP — Twitter/X tools for AI agents
  2. Quick Start
  3. Free Tools
  4. Paid AI Tools (requires ShipPost API key)
  5. Configuration
  6. License

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

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

Frequently asked questions

What is io.github.RyanKramer/shippost-mcp?

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

How do I install io.github.RyanKramer/shippost-mcp?

It runs on your machine. In Claude Code: claude mcp add shippost-mcp -e 'TWITTER_ACCESS_TOKEN=<your twitter_access_token>' -e 'TWITTER_REFRESH_TOKEN=<your twitter_refresh_token>' -e 'TWITTER_CLIENT_ID=<TWITTER_CLIENT_ID>' -e 'SHIPPOST_API_KEY=<your shippost_api_key>' -- uvx shippost-mcp==0.1.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.RyanKramer/shippost-mcp need an API key?

Yes. It expects TWITTER_ACCESS_TOKEN, TWITTER_REFRESH_TOKEN, SHIPPOST_API_KEY, which you set in its configuration.

Is io.github.RyanKramer/shippost-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.RyanKramer/shippost-mcp?

It is published by RyanKramer. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.