{
  "markdown": "# Superpowers.social — MCP server for X/Twitter & Reddit\n\nA hosted [MCP](https://modelcontextprotocol.io) server that gives Claude, ChatGPT, Cursor, and any agent runtime live tool-use access to **X/Twitter** and **Reddit**. No API keys. No scraping setup. No banned accounts.\n\n**Endpoint:** `https://superpowers.social/mcp` (Streamable HTTP)\n\n[![Status](https://img.shields.io/badge/status-public%20beta-blue)](https://superpowers.social)\n[![Free](https://img.shields.io/badge/pricing-free%20during%20beta-green)](https://superpowers.social)\n[![MCP](https://img.shields.io/badge/protocol-MCP-purple)](https://modelcontextprotocol.io)\n[![smithery badge](https://smithery.ai/badge/pkobielak/social-superpowers)](https://smithery.ai/servers/pkobielak/social-superpowers)\n\n---\n\n## Why\n\nThe official APIs are paywalled into oblivion (X starts at $100/mo, Reddit is heavily rate limiting). Direct scraping flags accounts in days. Most agents end up stuck on stale article snippets while the actual conversation happens on X and Reddit.\n\nThis server runs the gateway so you don't have to. One URL, ten tools, schema-validated responses, token-optimized payloads.\n\n## Tools\n\n### X/Twitter (5)\n| Tool | What it does |\n|---|---|\n| `twitter-search` | Search tweets by query with engagement metrics |\n| `twitter-read` | Read a single tweet by URL or ID |\n| `twitter-thread` | Read a full conversation thread |\n| `twitter-user-tweets` | Recent tweets from a user |\n| `twitter-news` | Trending news on X |\n\n### Reddit (5)\n| Tool | What it does |\n|---|---|\n| `reddit-search` | Search posts across Reddit or one subreddit |\n| `reddit-get-post` | Get a post + comments |\n| `reddit-get-posts` | Get hot/new/top posts from a subreddit |\n| `reddit-get-user-posts` | Posts submitted by a user |\n| `reddit-get-user-comments` | Comments by a user |\n\nAll tools are read-only, idempotent, and return token-optimized responses (up to 90% smaller than raw API JSON).\n\n## Install\n\n### Claude Desktop\nSettings → Connectors → **Add custom connector**:\n- **Name:** `social-superpowers`\n- **URL:** `https://superpowers.social/mcp`\n\n### ChatGPT (desktop or web)\nSettings → Apps & Connectors → enable **Developer mode** (one-time) → **Create**:\n- **Name:** `social-superpowers`\n- **URL:** `https://superpowers.social/mcp`\n\nAll tools are read-only, so the connector works on Plus/Pro developer mode.\n\n### Claude Code\n```bash\nclaude mcp add --transport http social-superpowers https://superpowers.social/mcp\n```\n\n### Cursor\nSettings → MCP → Add new MCP Server:\n```json\n{\n  \"social-superpowers\": {\n    \"type\": \"http\",\n    \"url\": \"https://superpowers.social/mcp\"\n  }\n}\n```\n\n### Any MCP client (`mcp.json`)\n```json\n{\n  \"mcpServers\": {\n    \"social-superpowers\": {\n      \"type\": \"http\",\n      \"url\": \"https://superpowers.social/mcp\"\n    }\n  }\n}\n```\n\n## Examples\n\n```\nYou: search X for what people are saying about $INTC catalysts this week\nAgent: [calls twitter-search with q=\"$INTC\", time_range=\"7d\"]\n       → returns 25 tweets with sentiment, engagement, top replies\n\nYou: which subreddits discuss the Tirzepatide side-effects?\nAgent: [calls reddit-search → reddit-get-posts → reddit-get-post]\n       → grounded answer with permalinks\n```\n\n## Pricing\n\n**Free during public beta.** No OAuth. No login. No credit card required.\n\n## Status & Limits\n\n- Uptime / status: [superpowers.social](https://superpowers.social)\n- Fair-use limits may apply during beta to keep the service open for everyone.\n\n## Specs\n\n- **Transport:** Streamable HTTP (`https://superpowers.social/mcp`)\n- **Auth:** none required during beta\n- **Spec version:** MCP 2025-12-11\n- **Source platforms:** X/Twitter, Reddit\n\n## License\n\nMIT — this repository contains the public manifest, examples, and docs. The hosted gateway implementation is closed-source; the MCP contract is the integration surface.\n\n## Links\n\n- Site: <https://superpowers.social>\n- MCP endpoint: <https://superpowers.social/mcp>\n- Issues / feature requests: open an issue on this repo\n- Agent-readable reference: <https://superpowers.social/llms.txt>\n- MCP spec: <https://modelcontextprotocol.io>\n",
  "bytes": 4097,
  "sha": "d851f65233f97301eafc1ff42d53b13d6dccb5f50f5aff3fe4169c0193365a48",
  "repo_slug": "pkobielak/social-superpowers-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_social_superpowers_social_superpowers_c5af3d7b/readme"
}