{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_mau67s5awkfp","handle":"socials-mcp","url":"https://wellknown.network/agents/socials-mcp","links":{"self":"https://wellknown.network/agents/socials-mcp/record.json","html":"https://wellknown.network/agents/socials-mcp","markdown":"https://wellknown.network/agents/socials-mcp/record.md","api":"https://wellknown.network/api/v1/agents/socials-mcp","status":"https://wellknown.network/api/v1/agents/socials-mcp/status","claim":"https://wellknown.network/agents/socials-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/socials-mcp/claim.json","badge":"https://wellknown.network/agents/socials-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/socials-mcp/history","tools":"https://wellknown.network/api/v1/agents/socials-mcp/tools"},"ard":{"identifier":"urn:air::server:socials-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"socials-mcp","summary":"MCP server for X/Twitter, Reddit and Twitch","description":"# socials-mcp\n\nMCP server for **X/Twitter**, **Reddit** and **Twitch**.\n\n> **MCP name:** `socials` — one server, three platforms.\n\n## Install\n\n```bash\nuv tool install socials-mcp\n```\n\n## Update\n\n```bash\nuv tool upgrade socials-mcp\n```\n\n## Login\n\n1. Install [Cookie Editor](https://cookie-editor.com/) extension in your browser.\n\n2. Go to [x.com](https://x.com) or [reddit.com](https://reddit.com) → open [Cookie Editor](https://cookie-editor.com/) → Export → Export as JSON (clipboard).\n\n3. Run the login command.\n\n   **Linux / macOS**\n\n   ```bash\n   socials-mcp x login\n   # or\n   socials-mcp reddit login\n   ```\n\n   Paste the JSON, then press Ctrl+D.\n\n   **Windows (PowerShell)**\n\n   The export is already in the clipboard, so pipe it:\n\n   ```powershell\n   Get-Clipboard -Raw | socials-mcp x login\n   # or\n   Get-Clipboard -Raw | socials-mcp reddit login\n   ```\n\n   If you paste manually, press Ctrl+Z then Enter.\n\n4. Enjoy!\n\n## Config\n\n```json\n{\n  \"mcpServers\": {\n    \"socials\": {\n      \"command\": \"socials-mcp\"\n    }\n  }\n}\n```\n\n## Twitch\n\n1. Create an app at <https://dev.twitch.tv/console/apps/create>.\n   - Name: anything unique\n   - OAuth Redirect URL: `https://localhost:3000` (not used for app tokens)\n   - Category: `Application Integration`\n   - Client type: `Confidential`\n\n2. Run:\n\n   ```bash\n   socials-mcp twitch login\n   ```\n\n   Enter the **Client ID**, then the **Client Secret**.\n\n## Tools\n\n| Tool | Description |\n|------|-------------|\n| `reddit_search` | Search Reddit |\n| `reddit_read` | Read post + comments |\n| `reddit_sub` | Browse subreddit |\n| `reddit_sub_info` | Subreddit info |\n| `reddit_user` | User profile |\n| `reddit_user_posts` | User posts |\n| `reddit_user_comments` | User comments |\n| `reddit_popular` | Popular posts |\n| `reddit_popular_all` | Browse r/all |\n| `reddit_feed` | Home feed |\n| `reddit_saved` | Saved posts |\n| `reddit_upvoted` | Upvoted posts |\n| `reddit_whoami` | Current account |\n| `reddit_status` | Auth status |\n| `reddit_comment` | Post a co…","publisher":{"name":"nyrhe","url":null},"homepage":"https://github.com/nyrhe/socials-mcp","repository":"https://github.com/nyrhe/socials-mcp","version":"0.7.1","license":"MIT","protocols":["mcp"],"tags":["mcp","reddit","socials","twitch","twitter","x"],"pricing":null,"endpoints":[{"url":"pypi:socials-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"content.social","name":"Social Media","confidence":1,"provenance":"declared"},{"slug":"security.identity","name":"Identity & Access","confidence":0.745,"provenance":"derived"}],"categories":["content","security"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"socials-mcp","registry":"pypi","observedAt":"2026-10-30T20:23:28.716Z","publishedAt":"2026-10-23T08:06:08.001098Z","latestVersion":"0.7.1"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"socials-mcp","url":"https://pypi.org/project/socials-mcp/","firstSeenAt":"2026-10-24T18:28:22.680Z","fetchedAt":"2026-10-30T20:22:40.062Z","normalizedAt":"2026-10-30T20:22:40.062Z"}]},"firstSeenAt":"2026-10-24T18:28:22.680Z","updatedAt":"2026-10-30T20:23:28.716Z"}