Superpowers.social

Official12 toolsLive

by pkobielak

Live X/Twitter and Reddit research. 10 read-only MCP tools, Google/GitHub sign-in. Free tier.

social.superpowers/social-superpowers — MCP Server for X/Twitter & Reddit

Hosted MCP server that provides live tool-use access to X/Twitter and Reddit for Claude, ChatGPT, Cursor, and other agent runtimes. The server runs 12 read-only tools and is available without API keys or scraping setup, with no banned accounts. The endpoint supports Streamable HTTP.

🛠️ Key Features

Hosted MCP server for X/Twitter and Reddit
12 read-only tools
No API keys required
Streamable HTTP endpoint: https://superpowers.social/mcp
Emphasized “no scraping setup” and “no banned accounts”

🚀 Use Cases

Integrate agent workflows that need access to X/Twitter and Reddit via MCP
Run read-only social queries from supported agent runtimes

⚡ Developer Benefits

Connect using a single hosted endpoint
Avoid API key management and scraping configuration
Use standard MCP tool calling for social data access

⚠️ Limitations

Tools are read-only (no write actions described)
Availability is indicated as “public beta” and “free during beta”

Captured live from the server via tools/list.

reddit-get-post

Get detailed content of a specific Reddit post with comments.

Parameters4

post_id	string	required	Reddit post ID
subreddit	string	optional	Subreddit name for faster lookup
comment_limit	number	optional	Number of comments to return (default 10)
text_only	boolean	optional	If true, return only id and title per post to save tokens.

Raw schema

{
  "type": "object",
  "properties": {
    "post_id": {
      "description": "Reddit post ID",
      "type": "string"
    },
    "subreddit": {
      "description": "Subreddit name for faster lookup",
      "type": "string"
    },
    "comment_limit": {
      "description": "Number of comments to return (default 10)",
      "default": 10,
      "type": "number"
    },
    "text_only": {
      "description": "If true, return only id and title per post to save tokens.",
      "default": false,
      "type": "boolean"
    }
  },
  "required": [
    "post_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

reddit-get-posts

Get posts from a subreddit.

Parameters5

subreddit	string	required	Subreddit name without r/ prefix
count	number	optional	Number of results to return (default 10)
sort	string	optional	Sort: hot, new, top, rising
time_filter	string	optional	Time filter for top sort: hour, day, week, month, year, all
text_only	boolean	optional	If true, return only id and title per post to save tokens.

Raw schema

{
  "type": "object",
  "properties": {
    "subreddit": {
      "description": "Subreddit name without r/ prefix",
      "type": "string"
    },
    "count": {
      "description": "Number of results to return (default 10)",
      "default": 10,
      "type": "number"
    },
    "sort": {
      "description": "Sort: hot, new, top, rising",
      "default": "hot",
      "type": "string"
    },
    "time_filter": {
      "description": "Time filter for top sort: hour, day, week, month, year, all",
      "default": "week",
      "type": "string"
    },
    "text_only": {
      "description": "If true, return only id and title per post to save tokens.",
      "default": false,
      "type": "boolean"
    }
  },
  "required": [
    "subreddit"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

reddit-get-subreddit-info

Get information about a subreddit.

Parameters1

subreddit

string

required

Subreddit name without r/ prefix

Raw schema

{
  "type": "object",
  "properties": {
    "subreddit": {
      "description": "Subreddit name without r/ prefix",
      "type": "string"
    }
  },
  "required": [
    "subreddit"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

reddit-get-user-comments

Get comments submitted by a specific Reddit user.

Parameters4

username	string	required	Reddit username without u/ prefix
count	number	optional	Number of results to return (default 10)
sort	string	optional	Sort: hot, new, top, controversial
time_filter	string	optional	Time filter: hour, day, week, month, year, all

Raw schema

{
  "type": "object",
  "properties": {
    "username": {
      "description": "Reddit username without u/ prefix",
      "type": "string"
    },
    "count": {
      "description": "Number of results to return (default 10)",
      "default": 10,
      "type": "number"
    },
    "sort": {
      "description": "Sort: hot, new, top, controversial",
      "default": "new",
      "type": "string"
    },
    "time_filter": {
      "description": "Time filter: hour, day, week, month, year, all",
      "default": "all",
      "type": "string"
    }
  },
  "required": [
    "username"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

reddit-get-user-info

Get information about a Reddit user.

Parameters1

username

string

required

Reddit username without u/ prefix

Raw schema

{
  "type": "object",
  "properties": {
    "username": {
      "description": "Reddit username without u/ prefix",
      "type": "string"
    }
  },
  "required": [
    "username"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

reddit-get-user-posts

Get posts submitted by a specific Reddit user.

Parameters5

username	string	required	Reddit username without u/ prefix
count	number	optional	Number of results to return (default 10)
sort	string	optional	Sort: hot, new, top, controversial
time_filter	string	optional	Time filter: hour, day, week, month, year, all
text_only	boolean	optional	If true, return only id and title per post to save tokens.

Raw schema

{
  "type": "object",
  "properties": {
    "username": {
      "description": "Reddit username without u/ prefix",
      "type": "string"
    },
    "count": {
      "description": "Number of results to return (default 10)",
      "default": 10,
      "type": "number"
    },
    "sort": {
      "description": "Sort: hot, new, top, controversial",
      "default": "new",
      "type": "string"
    },
    "time_filter": {
      "description": "Time filter: hour, day, week, month, year, all",
      "default": "all",
      "type": "string"
    },
    "text_only": {
      "description": "If true, return only id and title per post to save tokens.",
      "default": false,
      "type": "boolean"
    }
  },
  "required": [
    "username"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

reddit-search

Search Reddit for posts matching a query.

Parameters6

query	string	required	Search query string
subreddit	string	optional	Limit search to a specific subreddit
count	number	optional	Number of results to return (default 10)
sort	string	optional	Sort order: relevance, hot, top, new, comments
time_filter	string	optional	Time filter: hour, day, week, month, year, all
text_only	boolean	optional	If true, return only id and title per post to save tokens.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Search query string",
      "type": "string"
    },
    "subreddit": {
      "description": "Limit search to a specific subreddit",
      "type": "string"
    },
    "count": {
      "description": "Number of results to return (default 10)",
      "default": 10,
      "type": "number"
    },
    "sort": {
      "description": "Sort order: relevance, hot, top, new, comments",
      "type": "string"
    },
    "time_filter": {
      "description": "Time filter: hour, day, week, month, year, all",
      "type": "string"
    },
    "text_only": {
      "description": "If true, return only id and title per post to save tokens.",
      "default": false,
      "type": "boolean"
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

twitter-news

Get trending news from X/Twitter.

Parameters2

count	number	optional	Number of news items to return (default 10)
category	string	optional	Optional tab filter — one of: for-you, news, sports, entertainment, trending

Raw schema

{
  "type": "object",
  "properties": {
    "count": {
      "description": "Number of news items to return (default 10)",
      "default": 10,
      "type": "number"
    },
    "category": {
      "description": "Optional tab filter — one of: for-you, news, sports, entertainment, trending",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

twitter-read

Read a single tweet by URL or ID.

Parameters2

tweet	string	required	Tweet URL or tweet ID
text_only	boolean	optional	If true, return only id and text to save tokens.

Raw schema

{
  "type": "object",
  "properties": {
    "tweet": {
      "description": "Tweet URL or tweet ID",
      "type": "string"
    },
    "text_only": {
      "description": "If true, return only id and text to save tokens.",
      "default": false,
      "type": "boolean"
    }
  },
  "required": [
    "tweet"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

twitter-search

Search X/Twitter for tweets matching a query. Returns token-optimized results with engagement metrics.

Parameters4

query	string	required	Search query string
count	number	optional	Number of results to return (default 10)
cursor	string	optional	Pagination cursor from a previous response
text_only	boolean	optional	If true, return only id and text per tweet to save tokens.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Search query string",
      "type": "string"
    },
    "count": {
      "description": "Number of results to return (default 10)",
      "default": 10,
      "type": "number"
    },
    "cursor": {
      "description": "Pagination cursor from a previous response",
      "type": "string"
    },
    "text_only": {
      "description": "If true, return only id and text per tweet to save tokens.",
      "default": false,
      "type": "boolean"
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

twitter-thread

Read an entire tweet thread/conversation.

Parameters3

tweet	string	required	Tweet URL or ID of any tweet in the thread
cursor	string	optional	Pagination cursor from a previous response
text_only	boolean	optional	If true, return only id and text per tweet to save tokens.

Raw schema

{
  "type": "object",
  "properties": {
    "tweet": {
      "description": "Tweet URL or ID of any tweet in the thread",
      "type": "string"
    },
    "cursor": {
      "description": "Pagination cursor from a previous response",
      "type": "string"
    },
    "text_only": {
      "description": "If true, return only id and text per tweet to save tokens.",
      "default": false,
      "type": "boolean"
    }
  },
  "required": [
    "tweet"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

twitter-user-tweets

Get recent tweets from a specific X/Twitter user.

Parameters4

handle	string	required	Twitter handle (without @)
count	number	optional	Number of tweets to return (default 20)
cursor	string	optional	Pagination cursor from a previous response
text_only	boolean	optional	If true, return only id and text per tweet to save tokens.

Raw schema

{
  "type": "object",
  "properties": {
    "handle": {
      "description": "Twitter handle (without @)",
      "type": "string"
    },
    "count": {
      "description": "Number of tweets to return (default 20)",
      "default": 20,
      "type": "number"
    },
    "cursor": {
      "description": "Pagination cursor from a previous response",
      "type": "string"
    },
    "text_only": {
      "description": "If true, return only id and text per tweet to save tokens.",
      "default": false,
      "type": "boolean"
    }
  },
  "required": [
    "handle"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

README.md6 KBView on GitHub

Superpowers.social — MCP server for X/Twitter & Reddit

Hosted MCP server for live X/Twitter and Reddit research. 10 read-only tools for search, threads, timelines, posts and comments. Streamable HTTP: add the URL and sign in with Google or GitHub when prompted. Free tier available.

Website: https://superpowers.social
Endpoint: https://superpowers.social/mcp (Streamable HTTP)

Tools

All ten tools are read-only and idempotent. Eight of them trim the upstream response to the fields listed below and, when the trim saves enough to be worth reporting, append a stats line saying how much was stripped. twitter-news and reddit-get-user-comments are the exceptions: they return the upstream objects as they arrive, so the field lists below do not describe them and no stats line is emitted.

X/Twitter (5)

Tool	What it does	Arguments
`twitter-search`	Search tweets matching a query	`query` (required), `count` (default 10), `cursor`, `text_only`
`twitter-read`	Read a single tweet	`tweet` (URL or ID, required), `text_only`
`twitter-thread`	Read a full conversation thread	`tweet` (URL or ID, required), `cursor`, `text_only`
`twitter-user-tweets`	Recent tweets from one account	`handle` (required, no `@`), `count` (default 20), `cursor`, `text_only`
`twitter-news`	Trending news on X	`count` (default 10), `category` (`for-you`, `news`, `sports`, `entertainment`, `trending`)

Tweet fields, for twitter-search, twitter-read, twitter-thread and twitter-user-tweets: id, text, createdAt, author, authorName, url, and replyCount / retweetCount / likeCount when X returns them. Quoted tweets are nested under quotedTweet. text_only reduces each tweet to {id, text}. twitter-news returns news items, not tweets, and passes their fields through unchanged apart from a curation prefix stripped off category.

Reddit (5)

Tool	What it does	Arguments
`reddit-search`	Search posts across Reddit or one subreddit	`query` (required), `subreddit`, `count` (default 10), `sort`, `time_filter`, `text_only`
`reddit-get-post`	A post plus its comments	`post_id` (required), `subreddit`, `comment_limit` (default 10)
`reddit-get-posts`	Top posts from a subreddit for a time window	`subreddit` (required), `count` (default 10), `time_filter` (default `week`), `text_only`
`reddit-get-user-posts`	Posts submitted by a user	`username` (required), `count` (default 10), `sort` (default `new`), `time_filter` (default `all`), `text_only`
`reddit-get-user-comments`	Comments by a user	`username` (required), `count` (default 10), `sort` (default `new`), `time_filter` (default `all`)

Post fields: id, title, author, subreddit, createdUtc, url, and the post body when there is one. The list tools — reddit-search, reddit-get-posts, reddit-get-user-posts — truncate that body to a 500-character selftext_preview; reddit-get-post returns the full selftext and its comments as id, author, body, plus depth where the source gives one. text_only reduces each post to {id, title}. None of these carry a Reddit score or comment count — the source does not provide them. reddit-get-user-comments applies no field filtering — its comment objects come through as the source returns them.

Setup

Authentication is required for every call — an unauthenticated initialize returns 401.

Claude Code (verified 2026-09-16)

bash

claude mcp add --transport http social-superpowers https://superpowers.social/mcp

Sign in with Google or GitHub when Claude Code opens the browser prompt. That is the whole setup — the ten tools are then available in the session.

Any other MCP client

Any client that speaks Streamable HTTP can connect to https://superpowers.social/mcp with either:

its own MCP OAuth sign-in flow, if it supports one — the same Google or GitHub prompt, nothing to set up in advance; or
an API key, for clients without MCP OAuth: mint a key at https://superpowers.social/account and send it as Authorization: Bearer sk_live_… or x-api-key.

Generic Streamable-HTTP-with-API-key configuration shape (adjust to your client's own config format):

json

{
  "mcpServers": {
    "social-superpowers": {
      "type": "http",
      "url": "https://superpowers.social/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_…"
      }
    }
  }
}

Examples

code

You: what are people on X saying about $INTC?
Agent: twitter-search { "query": "$INTC", "count": 25 }
       → up to 25 tweets with author, timestamp, link and reply/retweet/like counts

You: which subreddits discuss Tirzepatide side effects?
Agent: reddit-search { "query": "tirzepatide side effects", "count": 10 }
       → posts with author, subreddit, permalink and a body preview
       reddit-get-post { "post_id": "1abc234" }
       → the full post with its comments

License

MIT — this repository contains the public manifest, examples, and docs. The hosted gateway implementation is closed-source; the MCP contract is the integration surface.

Install

Tools (12)

reddit-get-postreddit-get-postsreddit-get-subreddit-inforeddit-get-user-commentsreddit-get-user-inforeddit-get-user-postsreddit-searchtwitter-news

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://superpowers.social/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "social-superpowers": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://superpowers.social/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

Superpowers.social

social.superpowers/social-superpowers — MCP Server for X/Twitter & Reddit

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

reddit-get-post

reddit-get-posts

reddit-get-subreddit-info

reddit-get-user-comments

reddit-get-user-info

reddit-get-user-posts

reddit-search

twitter-news

twitter-read

twitter-search

twitter-thread

twitter-user-tweets

Superpowers.social — MCP server for X/Twitter & Reddit

Tools

X/Twitter (5)

Reddit (5)

Setup

Claude Code (verified 2026-09-16)

Any other MCP client

Examples

License

Links

Install

Remote endpoint

Related servers