Metadata-Version: 2.5
Name: socials-mcp
Version: 0.6.0
Summary: MCP server for X/Twitter and Reddit
Project-URL: Homepage, https://github.com/nyrhe/socials-mcp
Project-URL: Repository, https://github.com/nyrhe/socials-mcp
Project-URL: Issues, https://github.com/nyrhe/socials-mcp/issues
Author: nyrhe
License: MIT
License-File: LICENSE
Keywords: mcp,reddit,socials,twitter,x
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Requires-Dist: beautifulsoup4>=4.12
Requires-Dist: curl-cffi>=0.7
Requires-Dist: httpx
Requires-Dist: mcp>=1.0.0
Requires-Dist: xclienttransaction>=1.0.1
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == 'dev'
Description-Content-Type: text/markdown

# socials-mcp

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

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

## Install

```bash
uv tool install socials-mcp
```

## Update

```bash
uv tool upgrade socials-mcp
```

## Login

1. Install [Cookie Editor](https://cookie-editor.com/) extension in your browser.

2. Go to [x.com](https://x.com) or [reddit.com](https://reddit.com) → open [Cookie Editor](https://cookie-editor.com/) → Export → Export as JSON (clipboard).

3. Run the login command.

   **Linux / macOS**

   ```bash
   socials-mcp x login
   # or
   socials-mcp reddit login
   ```

   Paste the JSON, then press Ctrl+D.

   **Windows (PowerShell)**

   The export is already in the clipboard, so pipe it:

   ```powershell
   Get-Clipboard -Raw | socials-mcp x login
   # or
   Get-Clipboard -Raw | socials-mcp reddit login
   ```

   If you paste manually, press Ctrl+Z then Enter.

4. Enjoy!


## 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 |
| `reddit_popular_all` | Browse r/all |
| `reddit_feed` | Home feed |
| `reddit_saved` | Saved posts |
| `reddit_upvoted` | Upvoted posts |
| `reddit_whoami` | Current account |
| `reddit_status` | Auth status |
| `reddit_comment` | Post a comment |
| `reddit_create_post` | Create a self or link post |
| `reddit_delete` | Delete a post or comment |
| `reddit_save` | Save a post |
| `reddit_unsave` | Unsave a post |
| `reddit_upvote` | Upvote a post |
| `reddit_subscribe` | Subscribe to subreddit |
| `reddit_unsubscribe` | Unsubscribe from subreddit |
| `reddit_subscriptions` | List subscribed subreddits |
| `x_user` | User profile |
| `x_tweet` | Tweet + replies |
| `x_user_posts` | User tweets |
| `x_article` | Fetch Article |
| `x_search` | Search tweets |
| `x_feed` | Home timeline |
| `x_following_feed` | Following timeline |
| `x_bookmarks` | Bookmarks |
| `x_whoami` | Current account |
| `x_status` | Auth status |
| `x_post` | Post a tweet |
| `x_follow` | Follow user |
| `x_unfollow` | Unfollow user |
| `x_followers` | List followers |
| `x_following` | List following |
| `x_like` | Like tweet |
| `x_unlike` | Unlike tweet |
| `x_likes` | Liked tweets |
| `x_retweet` | Retweet |
| `x_unretweet` | Undo retweet |
| `x_reply` | Reply to tweet |
| `x_thread` | Post a thread, optional images |
| `x_quote` | Quote tweet |
| `x_bookmark` | Bookmark tweet |
| `x_unbookmark` | Remove bookmark |
| `x_delete` | Delete tweet |
| `x_list` | Fetch List tweets |
| `socials_status` | Auth status X + Reddit |
| `reddit_login_help` | Login help Reddit |
| `x_login_help` | Login help X |

## License

MIT
