{"_id":"mcp-socialapi","_rev":"3-4fe6747a82ce5e83adb04fc52234c796","name":"mcp-socialapi","dist-tags":{"latest":"1.2.0"},"versions":{"1.0.0":{"name":"mcp-socialapi","version":"1.0.0","keywords":["mcp","socialapi","social-media","instagram","facebook","tiktok","youtube"],"license":"MIT","_id":"mcp-socialapi@1.0.0","maintainers":[{"name":"socialapi","email":"contact@social-api.ai"}],"homepage":"https://github.com/SocialAPI-AI/mcp-socialapi#readme","bugs":{"url":"https://github.com/SocialAPI-AI/mcp-socialapi/issues"},"bin":{"mcp-socialapi":"dist/index.js"},"dist":{"shasum":"383baef459894c4813569823d4119a20319bb168","tarball":"https://registry.npmjs.org/mcp-socialapi/-/mcp-socialapi-1.0.0.tgz","fileCount":39,"integrity":"sha512-l/CkC8fdwkc9oyM0d/sRjnrsxEfvJQ/XpHMdzy83xa8BIYupvCN6uJfxltIEr1gf3Phsln8TuAMJerLo990CcQ==","signatures":[{"sig":"MEUCIQCb9ZH+e1SqyQDJ7uhupZA7MmkCbMMb+WkkMhDLvVoO6gIgYNURq0dRPNgqhrweCftzgcnTZnX6srOM/8FCmHTh27c=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":50459},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"9e37eea3df92ff905ddbf456df95695d79d5f275","scripts":{"dev":"tsc --watch","build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"socialapi","email":"contact@social-api.ai"},"repository":{"url":"git+https://github.com/SocialAPI-AI/mcp-socialapi.git","type":"git"},"_npmVersion":"11.6.4","description":"MCP server for SocialAPI — manage social media comments, DMs, reviews, and mentions across platforms","directories":{},"_nodeVersion":"22.21.1","dependencies":{"zod":"^3.25.0","@modelcontextprotocol/sdk":"^1.27.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-socialapi_1.0.0_1773169753736_0.6909123971215061","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"mcp-socialapi","version":"1.0.1","keywords":["mcp","socialapi","social-media","instagram","facebook","tiktok","youtube"],"license":"MIT","_id":"mcp-socialapi@1.0.1","maintainers":[{"name":"socialapi","email":"contact@social-api.ai"}],"homepage":"https://github.com/SocialAPI-AI/mcp-socialapi#readme","bugs":{"url":"https://github.com/SocialAPI-AI/mcp-socialapi/issues"},"bin":{"mcp-socialapi":"dist/index.js"},"dist":{"shasum":"01e4ab3814c27953f8ac9eb3d77e0c693dc08100","tarball":"https://registry.npmjs.org/mcp-socialapi/-/mcp-socialapi-1.0.1.tgz","fileCount":39,"integrity":"sha512-oC/hO3BRxt7mFDmfggdFau+JUUEzlfus8rvanuOaVNaOb4yK9dfO39/cVxGn7/lc3SXo4OceoNLP7XXMKO39Pg==","signatures":[{"sig":"MEUCIQDZpyQEdGRTDE5MUfbEznDgcS14hNDzNPoXpe3EhSi+JgIgQPaZG9mV38SJJqLJiEzJiihbgCd86pSKB6ezlhJFIFo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":50560},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"aec434b31b53a6ff84cdd6ee184186dd66b4f649","mcpName":"ai.social-api/socialapi","scripts":{"dev":"tsc --watch","build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"socialapi","email":"contact@social-api.ai"},"repository":{"url":"git+https://github.com/SocialAPI-AI/mcp-socialapi.git","type":"git"},"_npmVersion":"11.6.4","description":"MCP server for SocialAPI — manage social media comments, DMs, reviews, and mentions across platforms","directories":{},"_nodeVersion":"22.21.1","dependencies":{"zod":"^3.25.0","@modelcontextprotocol/sdk":"^1.27.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-socialapi_1.0.1_1773172123662_0.7608422276307218","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"name":"mcp-socialapi","version":"1.2.0","description":"MCP server for SocialAPI — manage social media comments, DMs, reviews, and mentions across platforms","type":"module","mcpName":"ai.social-api/socialapi","bin":{"mcp-socialapi":"dist/index.js"},"main":"dist/index.js","scripts":{"build":"tsc","start":"node dist/index.js","dev":"tsc --watch"},"keywords":["mcp","socialapi","social-media","instagram","facebook","tiktok","youtube"],"license":"MIT","engines":{"node":">=18.0.0"},"repository":{"type":"git","url":"git+https://github.com/SocialAPI-AI/mcp-socialapi.git"},"publishConfig":{"access":"public"},"dependencies":{"@modelcontextprotocol/sdk":"^1.27.0","zod":"^3.25.0"},"devDependencies":{"typescript":"^5.8.0","@types/node":"^22.0.0"},"gitHead":"da6134737f5d203b2ad6f9bc6771dbe4ba1f62e4","types":"./dist/index.d.ts","_id":"mcp-socialapi@1.2.0","bugs":{"url":"https://github.com/SocialAPI-AI/mcp-socialapi/issues"},"homepage":"https://github.com/SocialAPI-AI/mcp-socialapi#readme","_nodeVersion":"22.21.1","_npmVersion":"11.6.4","dist":{"integrity":"sha512-/OQ0O/YpXitrvRi93F83esmhJsS/nY7gxO4Vc/4LoieD78HLgUzK1fw/llLcaGCwcP+bkaM8UezxwLmHA57+Ug==","shasum":"5140b84913bbc3482d1510d7742991410e6d0d1c","tarball":"https://registry.npmjs.org/mcp-socialapi/-/mcp-socialapi-1.2.0.tgz","fileCount":54,"unpackedSize":145461,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIEWiaXB2odAVhByjpkKbNLgZi4iXeoN+Sj9sTSXSmyjHAiEA9uG8TzplvrQ2lgSKzHgzFU5hWzMJQZXZtPOqL/8kVfs="}]},"_npmUser":{"name":"socialapi","email":"contact@social-api.ai"},"directories":{},"maintainers":[{"name":"socialapi","email":"contact@social-api.ai"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-socialapi_1.2.0_1777720946605_0.7032021340571637"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-10T19:09:13.630Z","modified":"2026-05-02T11:22:26.911Z","1.0.0":"2026-03-10T19:09:13.917Z","1.0.1":"2026-03-10T19:48:43.803Z","1.2.0":"2026-05-02T11:22:26.759Z"},"bugs":{"url":"https://github.com/SocialAPI-AI/mcp-socialapi/issues"},"license":"MIT","homepage":"https://github.com/SocialAPI-AI/mcp-socialapi#readme","keywords":["mcp","socialapi","social-media","instagram","facebook","tiktok","youtube"],"repository":{"type":"git","url":"git+https://github.com/SocialAPI-AI/mcp-socialapi.git"},"description":"MCP server for SocialAPI — manage social media comments, DMs, reviews, and mentions across platforms","maintainers":[{"name":"socialapi","email":"contact@social-api.ai"}],"readme":"# mcp-socialapi\r\n\r\nMCP server for [SocialAPI](https://social-api.ai) — manage social media comments, DMs, reviews, and mentions across platforms through a single unified API.\r\n\r\nSupports Instagram, Facebook, Google Business, TikTok, YouTube, X/Twitter, Trustpilot, and LinkedIn.\r\n\r\n## Installation\r\n\r\n### Claude Desktop (API key)\r\n\r\nAdd to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS, `%APPDATA%\\Claude\\claude_desktop_config.json` on Windows):\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"socialapi\": {\r\n      \"command\": \"npx\",\r\n      \"args\": [\"-y\", \"mcp-socialapi\"],\r\n      \"env\": {\r\n        \"SOCIALAPI_API_KEY\": \"sapi_key_...\"\r\n      }\r\n    }\r\n  }\r\n}\r\n```\r\n\r\nGet your API key from the [SocialAPI dashboard](https://app.social-api.ai/keys).\r\n\r\n### OAuth (Marketplace)\r\n\r\nWhen installing from the Claude MCP marketplace or Smithery, OAuth is handled automatically — no manual configuration needed.\r\n\r\n## Configuration\r\n\r\n| Variable | Required | Default | Description |\r\n|---|---|---|---|\r\n| `SOCIALAPI_API_KEY` | In self-hosted mode | — | Your SocialAPI API key (`sapi_key_...`) |\r\n| `SOCIALAPI_BASE_URL` | No | `https://api.social-api.ai` | Override for self-hosted API instances |\r\n\r\n## Available Tools\r\n\r\n### Accounts\r\n| Tool | Description |\r\n|---|---|\r\n| `social_api_list_accounts` | List all connected social media accounts |\r\n| `social_api_connect_account` | Initiate OAuth flow to connect a new account |\r\n| `social_api_exchange_oauth` | Complete OAuth flow by exchanging authorization code |\r\n\r\n### Posts\r\n| Tool | Description |\r\n|---|---|\r\n| `social_api_get_posts` | List posts/media for a connected account |\r\n\r\n### Comments\r\n| Tool | Description |\r\n|---|---|\r\n| `social_api_get_comments` | List comments on a specific post |\r\n| `social_api_get_comment_replies` | List replies to a comment |\r\n| `social_api_reply_to_interaction` | Reply to a comment or review |\r\n| `social_api_moderate_comment` | Hide, unhide, or delete a comment |\r\n| `social_api_toggle_post_comments` | Enable or disable comments on a post |\r\n\r\n### Direct Messages\r\n| Tool | Description |\r\n|---|---|\r\n| `social_api_get_dms` | List DM threads |\r\n| `social_api_get_dm_thread` | Look up a thread by user ID |\r\n| `social_api_send_dm` | Send a message to a DM thread |\r\n\r\n### Reviews & Mentions\r\n| Tool | Description |\r\n|---|---|\r\n| `social_api_get_reviews` | List reviews (Google Business, Trustpilot) |\r\n| `social_api_get_mentions` | List brand mentions and tags |\r\n\r\n### Usage\r\n| Tool | Description |\r\n|---|---|\r\n| `social_api_get_usage` | Get credit usage for current billing period |\r\n| `social_api_get_account_limits` | Get platform-specific limits for an account |\r\n\r\n### API Keys\r\n| Tool | Description |\r\n|---|---|\r\n| `social_api_list_keys` | List all API keys |\r\n| `social_api_create_key` | Generate a new API key |\r\n| `social_api_revoke_key` | Revoke an API key |\r\n\r\n### Webhooks\r\n| Tool | Description |\r\n|---|---|\r\n| `social_api_list_webhooks` | List webhook endpoints |\r\n| `social_api_create_webhook` | Create a new webhook endpoint |\r\n| `social_api_update_webhook` | Update an existing webhook |\r\n| `social_api_delete_webhook` | Delete a webhook endpoint |\r\n\r\n### User\r\n| Tool | Description |\r\n|---|---|\r\n| `social_api_get_me` | Get current user profile |\r\n| `social_api_send_feedback` | Send feedback to the SocialAPI team |\r\n\r\n## Documentation\r\n\r\nFull API reference: [docs.social-api.ai](https://docs.social-api.ai)\r\n\r\n## License\r\n\r\nMIT\r\n","readmeFilename":"README.md"}