llms.txt Content
# superpowers.social
> MCP server that gives Claude, ChatGPT, or any LLM tool-use access to
> X/Twitter and Reddit: search, threads, timelines, posts, comments, and
> trending news. Free during beta. No API keys. All tools are read-only.
## Connect
MCP endpoint (streamable HTTP): https://superpowers.social/mcp
- Claude Code: claude mcp add --transport http social-superpowers https://superpowers.social/mcp
- Claude Desktop: Settings -> Connectors -> Add custom connector (name: social superpowers, URL above)
- ChatGPT: Settings -> Apps & Connectors -> enable Developer mode -> Create (URL above; read-only tools work on Plus/Pro)
- Cursor / any MCP client: add {"type": "http", "url": "https://superpowers.social/mcp"} under mcpServers
## Tools
### X / Twitter
- twitter-search: Search tweets by query, with engagement metrics. Paginates via cursor.
- twitter-read: Read a single tweet by URL or numeric ID.
- twitter-thread: Read a full thread/conversation from any tweet in it.
- twitter-user-tweets: Recent tweets from a user handle.
- twitter-news: Trending news; optional category filter (for-you, news, sports, entertainment, trending).
### Reddit
- reddit-search: Search posts across Reddit or within one subreddit (sort: relevance, hot, top, new, comments; time filter: hour..all).
- reddit-get-post: A post with its top comments (post_id, optional subreddit).
- reddit-get-posts: Hot/new/top/rising posts from a subreddit.
- reddit-get-user-posts: Posts submitted by a user.
- reddit-get-user-comments: Comments written by a user.
## Usage notes
- Every list tool accepts text_only: true to trim responses to IDs and text (saves tokens).
- Responses are token-optimized JSON; large responses include a savings footer.
- Errors are generic by design; retry transient failures.
## Pages
- Landing & setup: https://superpowers.social