English Français العربية

io.github.RyanKramer/shippost-mcp

Registre officiel Recherche et web

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

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

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
Configuration JSON (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>"
            }
        }
    }
}

Variables d'environnement

  • TWITTER_ACCESS_TOKEN obligatoire 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

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  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

Questions fréquentes

Qu'est-ce que io.github.RyanKramer/shippost-mcp ?

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

Comment installer io.github.RyanKramer/shippost-mcp ?

Il s'exécute sur votre machine. Dans 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. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.RyanKramer/shippost-mcp ?

Oui. Il attend TWITTER_ACCESS_TOKEN, TWITTER_REFRESH_TOKEN, SHIPPOST_API_KEY, à renseigner dans sa configuration.

io.github.RyanKramer/shippost-mcp est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.RyanKramer/shippost-mcp ?

Il est publié par RyanKramer. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.