socials-mcp
MCP server for X/Twitter, Reddit and Twitch.
MCP name:
socials— one server, three platforms.
Install
uv tool install socials-mcp
Update
uv tool upgrade socials-mcp
Login
-
Install Cookie Editor extension in your browser.
-
Go to x.com or reddit.com → open Cookie Editor → Export → Export as JSON (clipboard).
-
Run the login command.
Linux / macOS
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:
Get-Clipboard -Raw | socials-mcp x login # or Get-Clipboard -Raw | socials-mcp reddit login
If you paste manually, press Ctrl+Z then Enter.
-
Enjoy!
Config
{
"mcpServers": {
"socials": {
"command": "socials-mcp"
}
}
}
Twitch
-
Create an app at https://dev.twitch.tv/console/apps/create.
- Name: anything unique
- OAuth Redirect URL:
https://localhost:3000(not used for app tokens) - Category:
Application Integration - Client type:
Confidential
-
Run:
socials-mcp twitch login
Enter the Client ID, then the Client Secret.
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 |
twitch_status |
Twitch auth status |
twitch_streams |
Live Twitch streams |
twitch_clips |
Top Twitch clips |
twitch_videos |
Twitch VODs |
twitch_channel |
Twitch channel profile |
socials_status |
Auth status X + Reddit |
reddit_login_help |
Login help Reddit |
x_login_help |
Login help X |
License
MIT
1 maintainer
Metadata
1 maintainer
Release files for socials-mcp 0.7.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| socials_mcp-0.7.1.tar.gz | 57.4 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| socials_mcp-0.7.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 125.1 kB
Security for socials-mcp 0.7.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
Release files / socials_mcp-0.7.1.tar.gz
How to use checksums
905ed0bf5b37f890e48f8910a1ba3b90980669cb7749fc75085a08807bb5f37bHow to use checksums
dd977fb172c2faa0c12f4eac2a3dbe85874a36ac57e4c044b8db2144fadfa5ccWhat is trusted publishing?
twine/7.0.0 CPython/3.13.13