# socials-mcp

Unified MCP server for **X/Twitter** and **Reddit**.

> **MCP name:** `socials` — one server, two platforms.

## Install

```bash
pip install git+https://github.com/nyrhe/socials-mcp
```

Or with uvx:

```bash
uvx --from git+https://github.com/nyrhe/socials-mcp socials-mcp
```

Login once:

```bash
twitter login
rdt login
```

## Config

```json
{
  "mcpServers": {
    "socials": {
      "command": "socials-mcp"
    }
  }
}
```

## Tools

| Tool | Description |
|------|-------------|
| `reddit_search` | Search Reddit |
| `reddit_read` | Read post + comments |
| `reddit_sub` | Browse subreddit |
| `reddit_sub_info` | Subreddit info |
| `reddit_user` | User profile |
| `reddit_user_posts` | User posts |
| `reddit_user_comments` | User comments |
| `reddit_popular` | Popular posts (/r/popular) |
| `reddit_popular_all` | Browse r/all |
| `reddit_feed` | Home feed (requires login) |
| `reddit_saved` | Saved posts (requires login) |
| `reddit_upvoted` | Upvoted posts (requires login) |
| `reddit_whoami` | Current account (requires login) |
| `reddit_status` | Auth status (requires login) |
| `reddit_comment` | Post a comment (requires login) |
| `reddit_save` | Save a post (requires login) |
| `reddit_upvote` | Upvote a post (requires login) |
| `reddit_subscribe` | Subscribe to subreddit (requires login) |
| `x_user` | User profile |
| `x_tweet` | Tweet + replies |
| `x_user_posts` | User tweets |
| `x_article` | Fetch Article |
| `x_search` | Search tweets (requires login) |
| `x_feed` | Home timeline (requires login) |
| `x_bookmarks` | Bookmarks (requires login) |
| `x_whoami` | Current account (requires login) |
| `x_status` | Auth status (requires login) |
| `x_post` | Post a tweet (requires login) |
| `x_follow` | Follow user (requires login) |
| `x_unfollow` | Unfollow user (requires login) |
| `x_followers` | List followers (requires login) |
| `x_following` | List following (requires login) |
| `x_like` | Like tweet (requires login) |
| `x_unlike` | Unlike tweet (requires login) |
| `x_likes` | Liked tweets (requires login) |
| `x_retweet` | Retweet (requires login) |
| `x_unretweet` | Undo retweet (requires login) |
| `x_reply` | Reply to tweet (requires login) |
| `x_quote` | Quote tweet (requires login) |
| `x_bookmark` | Bookmark tweet (requires login) |
| `x_unbookmark` | Remove bookmark (requires login) |
| `x_delete` | Delete tweet (requires login) |
| `x_list` | Fetch List tweets (requires login) |
| `socials_status` | Auth status X + Reddit |
| `reddit_login_help` | Login help Reddit |
| `x_login_help` | Login help X |

## License

MIT