# social-superpowers

Hosted MCP for X/Twitter and Reddit. 12 read-only tools, no API keys, free during beta.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y smithery mcp add pkobielak/social-superpowers

# Browse available tools
npx -y smithery tool list pkobielak/social-superpowers

# Get full schema for a tool
npx -y smithery tool get pkobielak/social-superpowers reddit-get-posts

# Call a tool
npx -y smithery tool call pkobielak/social-superpowers reddit-get-posts '{}'
```

## Direct MCP Connection

Endpoint: `https://social-superpowers.run.tools`

## Tools (12)

- `reddit-get-posts` — Get posts from a subreddit.
- `reddit-get-post` — Get detailed content of a specific Reddit post with comments.
- `reddit-get-subreddit-info` — Get information about a subreddit.
- `reddit-get-user-comments` — Get comments submitted by a specific Reddit user.
- `reddit-get-user-info` — Get information about a Reddit user.
- `reddit-get-user-posts` — Get posts submitted by a specific Reddit user.
- `reddit-search` — Search Reddit for posts matching a query.
- `twitter-news` — Get trending news from X/Twitter.
- `twitter-read` — Read a single tweet by URL or ID.
- `twitter-search` — Search X/Twitter for tweets matching a query. Returns token-optimized results with engagement metrics.
- `twitter-thread` — Read an entire tweet thread/conversation.
- `twitter-user-tweets` — Get recent tweets from a specific X/Twitter user.

```bash
# Get full input/output schema for a tool
npx -y smithery tool get pkobielak/social-superpowers <tool-name>
```