{
  "markdown": "<!-- mcp-name: io.github.RyanKramer/shippost-mcp -->\n# ShipPost MCP — Twitter/X tools for AI agents\n\nGive any AI agent (Claude Code, Cursor, Windsurf, etc.) the ability to read, write, and engage on Twitter/X.\n\n## Quick Start\n\n### Claude Code\n\nAdd to your `~/.claude/settings.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"twitter\": {\n      \"command\": \"shippost-mcp\",\n      \"env\": {\n        \"TWITTER_ACCESS_TOKEN\": \"your-access-token\",\n        \"TWITTER_REFRESH_TOKEN\": \"your-refresh-token\",\n        \"TWITTER_CLIENT_ID\": \"your-client-id\"\n      }\n    }\n  }\n}\n```\n\n### Install from PyPI\n\n```bash\npip install shippost-mcp\n```\n\n## Free Tools\n\n| Tool | Description |\n|------|-------------|\n| `get_my_profile` | Get your Twitter profile |\n| `get_timeline` | Read your home timeline |\n| `get_mentions` | Get tweets mentioning you |\n| `get_user_profile` | Look up any user's profile |\n| `get_tweet` | Get a specific tweet by ID |\n| `search_tweets` | Search recent tweets |\n| `post_tweet` | Post a tweet |\n| `reply_to_tweet` | Reply to a tweet |\n| `like_tweet` | Like a tweet |\n| `retweet` | Retweet a tweet |\n| `follow_user` | Follow a user |\n\n## Paid AI Tools (requires ShipPost API key)\n\n| Tool | Description |\n|------|-------------|\n| `find_opportunities` | AI scans your timeline for the best tweets to reply to |\n| `draft_reply` | AI drafts a reply in your voice |\n| `draft_tweet` | AI drafts an original tweet |\n| `draft_thread` | AI drafts a full thread |\n| `analyze_account` | AI analyzes any Twitter account |\n| `get_performance` | AI-powered engagement analytics |\n\nGet your API key at [shippost.ai](https://shippost.ai)\n\n## Configuration\n\n| Env Var | Required | Description |\n|---------|----------|-------------|\n| `TWITTER_ACCESS_TOKEN` | Yes | OAuth 2.0 access token |\n| `TWITTER_REFRESH_TOKEN` | Recommended | For automatic token renewal |\n| `TWITTER_CLIENT_ID` | For refresh | Your Twitter app's client ID |\n| `SHIPPOST_API_KEY` | For AI features | Get at shippost.ai |\n\n## License\n\nMIT\n",
  "bytes": 1987,
  "sha": "b34b93d9a3ed877674f3e494f8cb26cb7131a9a4fe0fc4fdde65d6f5f71677ca",
  "repo_slug": "ryankramer/shippost-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_ryankramer_shippost_mcp_d638eb90/readme"
}