Skip to main content

socials-mcp

MCP server for X/Twitter and Reddit.

MCP name: socials — one server, two platforms.

Install

uv tool install socials-mcp

Login

  1. Install Cookie Editor extension in your browser.

  2. Go to x.com or reddit.com → open Cookie Editor → Export → Export as JSON (clipboard).

  3. 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.

  4. Enjoy!

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
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

Metadata

Release files for socials-mcp 0.5.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for socials-mcp 0.5.0
File Size Uploaded Provenance
socials_mcp-0.5.0.tar.gz 52.5 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for socials-mcp 0.5.0
File Interpreter ABI Platform
socials_mcp-0.5.0-py3-none-any.whl Python 3 none any Details

Total release size: 114.2 kB

Release files / socials_mcp-0.5.0.tar.gz

Download URL socials_mcp-0.5.0.tar.gz
Size 52.5 kB
Tags Source
SHA-256 checksum
How to use checksums
b27279d4eea3ac16cfd2c65532024ec13e096777074bd10c8ee129771bdae948
BLAKE2b-256 checksum
How to use checksums
ee645ebc175d4fb1ad4151245c6b7eb952fe2bfd95259d52ae6645221ecfaf5a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via 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}

Release files / socials_mcp-0.5.0-py3-none-any.whl

Download URL socials_mcp-0.5.0-py3-none-any.whl
Size 61.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
826e68935d274385545b3559e5504bf2a65ce01d8c83b639c80e91a1c8afff02
BLAKE2b-256 checksum
How to use checksums
9088c047e1cd00eed69573acdce156201123cf98f73daeb4bae2114d1e6e8006
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via 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}

Security for socials-mcp 0.5.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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page