ryankramer avatar

Shippost Mcp

ryankramer/shippost-mcp

Gives Claude direct access to Twitter/X through OAuth 2.0, exposing the standard operations you'd expect: reading timelines and mentions, posting tweets and replies, searching, liking, retweeting, and following. The free tier covers all basic Twitter API interactions. There's also a paid ShipPost AI layer that adds higher-level capabilities like scanning your timeline for engagement opportunities, drafting replies in your voice, and analyzing accounts. Useful when you want Claude to monitor Twitter conversations, engage with relevant tweets, or handle routine social media tasks without leaving your editor. Supports Claude Code, Cursor, and similar MCP-compatible environments.

tools
17
auth
Secret needed
transport
STDIO
env vars
4
last updated
Mar 29, 2026

Tools

17 tools

Public tool metadata for what this MCP can expose to an agent.

get_my_profileGet your Twitter profile

Get your Twitter profile

No parameter schema in public metadata yet.

get_timelineRead your home timeline

Read your home timeline

No parameter schema in public metadata yet.

get_mentionsGet tweets mentioning you

Get tweets mentioning you

No parameter schema in public metadata yet.

get_user_profileLook up any user's profile

Look up any user's profile

No parameter schema in public metadata yet.

get_tweetGet a specific tweet by ID

Get a specific tweet by ID

No parameter schema in public metadata yet.

search_tweetsSearch recent tweets

Search recent tweets

No parameter schema in public metadata yet.

post_tweetPost a tweet

Post a tweet

No parameter schema in public metadata yet.

reply_to_tweetReply to a tweet

Reply to a tweet

No parameter schema in public metadata yet.

like_tweetLike a tweet

Like a tweet

No parameter schema in public metadata yet.

retweetRetweet a tweet

Retweet a tweet

No parameter schema in public metadata yet.

follow_userFollow a user

Follow a user

No parameter schema in public metadata yet.

find_opportunitiesAI scans your timeline for the best tweets to reply to

AI scans your timeline for the best tweets to reply to

No parameter schema in public metadata yet.

draft_replyAI drafts a reply in your voice

AI drafts a reply in your voice

No parameter schema in public metadata yet.

draft_tweetAI drafts an original tweet

AI drafts an original tweet

No parameter schema in public metadata yet.

draft_threadAI drafts a full thread

AI drafts a full thread

No parameter schema in public metadata yet.

analyze_accountAI analyzes any Twitter account

AI analyzes any Twitter account

No parameter schema in public metadata yet.

get_performanceAI-powered engagement analytics

AI-powered engagement analytics

No parameter schema in public metadata yet.

Sponsors

Configuration

TWITTER_ACCESS_TOKEN*secret

Your Twitter OAuth 2.0 access token

TWITTER_REFRESH_TOKENsecret

Twitter refresh token for automatic renewal

TWITTER_CLIENT_ID

Your Twitter app client ID (needed for token refresh)

SHIPPOST_API_KEYsecret

ShipPost API key for AI-powered features (get at https://shippost.ai)

Readme

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)


View the full README on GitHub

Details

Repository
github.com/ryankramer/shippost-mcp
Categories
Search & Web Crawling, Media & Entertainment
Package
shippost-mcp
Transport
STDIO
Auth
Required
Registry
MCP registry, active

More from ryankramer

Related Search & Web Crawling MCP servers

View all
1gradientvibe avatarBolagskvarnengradientvibe/bolagskvarnen-examplesSwedish company data for AI agents: search, board, history, financials. Sandbox: fictional firms.0stars
2severin2k avatarBlumen Komander Münchenseverin2k/blumen-komander-mcpFirst German florist with a public MCP server. Search bouquets and order flowers via AI in Munich.0stars
3sharozdawa avatarContent Optimizersharozdawa/content-optimizerSERP-based content scoring and optimization with 7 SEO categories.0stars
4sierikov avatarMCP server for Planka (unofficial)sierikov/planka-mcpFind, read and manage cards on your Planka v2 boards: search, move, comment, edit, checklists.0stars
5slashml-ai avatarSlashML (/ ml) Persistent Agent Memory & Code Localizationslashml-ai/ml-memorySub-millisecond persistent memory, behavioral code search, and bug localization for AI agents.0stars
6inttech-solutions avatarAEGIS Eventsinttech-solutions/events-mcpRead-only search of security events from the news by place, point and radius, category and date.0stars