socials-mcp
Unified MCP server for X/Twitter and Reddit.
MCP name:
socials— one server, two platforms.
Install
pip install git+https://github.com/nyrhe/socials-mcp
Or with uvx:
uvx --from git+https://github.com/nyrhe/socials-mcp socials-mcp
Login once (this only writes the cookies the libraries read):
twitter login
rdt login
Backend
100 % native: every tool imports twitter_cli / rdt_cli and calls
TwitterClient / RedditClient in-process. No subprocess, no CLI binary
invoked at runtime — SOCIALS_X_COOKIES_FILE, TWITTER_AUTH_TOKEN and
TWITTER_CT0 are enough to run without any twitter/rdt executable.
Config
{
"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
1 maintainer
Metadata
1 maintainer
Release files for socials-mcp 0.1.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.1.0.tar.gz | 56.0 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| socials_mcp-0.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 120.1 kB
Security for socials-mcp 0.1.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.
Release files / socials_mcp-0.1.0.tar.gz
How to use checksums
81ae70387bfeba52706f6926066e933957ba50dd757e9138254c198fd73fed92How to use checksums
5ce8ec89faef10a1f51d9bb5fea07443a6c4514d9d9589b1daed8661a9ead7a9What is trusted publishing?
twine/7.0.0 CPython/3.14.7