# Shippost Mcp

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

- **Type:** MCP server
- **Install:** `agentstack add mcp-ryankramer-shippost-mcp`
- **Verified:** Pending review
- **Seller:** [RyanKramer](https://agentstack.voostack.com/s/ryankramer)
- **Installs:** 0
- **Latest version:** 0.1.1
- **License:** MIT
- **Upstream author:** [RyanKramer](https://github.com/RyanKramer)
- **Source:** https://github.com/RyanKramer/shippost-mcp

## Install

```sh
agentstack add mcp-ryankramer-shippost-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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`:

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

```bash
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](https://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

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [RyanKramer](https://github.com/RyanKramer)
- **Source:** [RyanKramer/shippost-mcp](https://github.com/RyanKramer/shippost-mcp)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Versions

- **0.1.1** — security scan: pending review — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-ryankramer-shippost-mcp
- Seller: https://agentstack.voostack.com/s/ryankramer
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.