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.

Shippost

Q: When was Shippost last checked?

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

by io.github.RyanKramer

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

Power your agent

Add this server

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

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)

Provider

Claude Code

TWITTER_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.

Claude Desktop

{
  "mcpServers": {
    "io.github.ryankramer-shippost-mcp": {
      "command": "uvx",
      "args": [
        "shippost-mcp==0.1.1"
      ],
      "env": {
        "TWITTER_ACCESS_TOKEN": "<secret>",
        "TWITTER_REFRESH_TOKEN": "<secret>",
        "TWITTER_CLIENT_ID": "<value>",
        "SHIPPOST_API_KEY": "<secret>"
      }
    }
  }
}

claude_desktop_config.json

Step-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

Related MCP

Related skills

View all

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

Shippost

by io.github.RyanKramer

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

Power your agent

Add this server

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

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)

Provider

Claude Code

TWITTER_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.

Claude Desktop

{
  "mcpServers": {
    "io.github.ryankramer-shippost-mcp": {
      "command": "uvx",
      "args": [
        "shippost-mcp==0.1.1"
      ],
      "env": {
        "TWITTER_ACCESS_TOKEN": "<secret>",
        "TWITTER_REFRESH_TOKEN": "<secret>",
        "TWITTER_CLIENT_ID": "<value>",
        "SHIPPOST_API_KEY": "<secret>"
      }
    }
  }
}

claude_desktop_config.json

Step-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

Related MCP

Related skills

View all

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