socials-mcp
Unified MCP server for X/Twitter and Reddit.
MCP name:
socials— one server, two platforms.
Install
uv tool install 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"
}
}
}
Tools
| Tool | Description |
|---|---|
reddit_search |
Search Reddit (+ lightweight: fields, text_only, filters) |
reddit_read |
Read post + comments |
reddit_sub |
Browse subreddit (+ lightweight: fields, text_only, filters) |
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_create_post |
Create a self or link post (requires login) |
reddit_delete |
Delete a post or comment (requires login) |
reddit_save |
Save a post (requires login) |
reddit_unsave |
Unsave a post (requires login) |
reddit_upvote |
Upvote a post (requires login) |
reddit_subscribe |
Subscribe to subreddit (requires login) |
reddit_unsubscribe |
Unsubscribe from subreddit (requires login) |
reddit_subscriptions |
List subscribed subreddits (requires login) |
x_user |
User profile |
x_tweet |
Tweet + replies |
x_user_posts |
User tweets |
x_article |
Fetch Article |
x_search |
Search tweets (+ lightweight: fields, text_only, summarize, filters) |
x_feed |
Home timeline (+ lightweight: fields, text_only, filters) |
x_following_feed |
Following timeline (+ lightweight: fields, text_only, filters) |
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_thread |
Post a thread, optional images (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
1 maintainer
Metadata
1 maintainer
Release files for socials-mcp 0.3.0
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.3.0.tar.gz | 50.9 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| socials_mcp-0.3.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 109.6 kB
Security for socials-mcp 0.3.0
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.3.0.tar.gz
How to use checksums
00b2fed004d562bbb9fae78822714bdbf67802a46841d47a419462eb5ca204afHow to use checksums
eebdb5d0778bb62409d5be00df861ae6024eb6d033445e48750df7a4feb30b4aWhat is trusted publishing?
uv/0.10.12 {"installer":{"name":"uv","version":"0.10.12","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}