How do I install Shippost?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Shippost need an API key?

The publisher lists these environment variables: TWITTER_ACCESS_TOKEN, TWITTER_REFRESH_TOKEN, TWITTER_CLIENT_ID, SHIPPOST_API_KEY.

What transport does Shippost use?

Shippost runs locally over stdio.

When was Shippost last checked?

Last checked 2026-11-09. Twitter/X tools for AI agents — read timelines, post tweets, search, and engage

Shippost MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

uvx shippost-mcp==0.1.1

Credentials from the publisher

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

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1TWITTER_ACCESS_TOKEN=<secret> TWITTER_REFRESH_TOKEN=<secret> TWITTER_CLIENT_ID=<value> SHIPPOST_API_KEY=<secret> claude mcp add io.github.ryankramer-shippost-mcp -- uvx shippost-mcp==0.1.1

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.ryankramer-shippost-mcp": {4      "command": "uvx",5      "args": [6        "shippost-mcp==0.1.1"7      ],8      "env": {9        "TWITTER_ACCESS_TOKEN": "<secret>",10        "TWITTER_REFRESH_TOKEN": "<secret>",11        "TWITTER_CLIENT_ID": "<value>",12        "SHIPPOST_API_KEY": "<secret>"13      }14    }15  }16}

claude_desktop_config.json

Local · pypiPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 0.1.1

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

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

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Shippost?

Does Shippost need an API key?

What transport does Shippost use?

When was Shippost last checked?

Documentation

ShipPost MCP — Twitter/X tools for AI agents

Quick Start

Claude Code

Install from PyPI

Free Tools

Paid AI Tools (requires ShipPost API key)

Configuration

License