{"_id":"@cybeleri/social-media-scheduler-mcp","name":"@cybeleri/social-media-scheduler-mcp","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@cybeleri/social-media-scheduler-mcp","version":"1.0.0","description":"MCP server for AI agents to schedule and manage social media content across Twitter/X, LinkedIn, Bluesky, and Mastodon","main":"dist/index.js","types":"dist/index.d.ts","type":"module","bin":{"social-media-scheduler-mcp":"dist/index.js"},"engines":{"node":">=18.0.0"},"scripts":{"build":"tsc","start":"node dist/index.js","dev":"tsc --watch","lint":"eslint src/**/*.ts","test":"node --test","apify:run":"APIFY_META_ORIGIN=STANDBY ACTOR_WEB_SERVER_PORT=8080 apify run","apify:push":"apify push"},"keywords":["mcp","model-context-protocol","social-media","scheduler","twitter","linkedin","bluesky","mastodon","ai-agent","claude","apify"],"author":{"name":"cybeleri"},"license":"MIT","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0","zod":"^3.23.0","date-fns":"^3.6.0","cron-parser":"^4.9.0"},"devDependencies":{"@types/node":"^20.10.0","typescript":"^5.3.0","eslint":"^8.55.0"},"peerDependencies":{"apify":"^3.0.0"},"peerDependenciesMeta":{"apify":{"optional":true}},"repository":{"type":"git","url":"git+https://github.com/cybeleri/social-media-scheduler-mcp.git"},"homepage":"https://github.com/cybeleri/social-media-scheduler-mcp#readme","bugs":{"url":"https://github.com/cybeleri/social-media-scheduler-mcp/issues"},"_id":"@cybeleri/social-media-scheduler-mcp@1.0.0","gitHead":"7c7381e02133387112a60dd3fa39ba67169c5934","_nodeVersion":"20.19.6","_npmVersion":"10.8.2","dist":{"integrity":"sha512-0wuj494lsRErLU67eg0mnQ5u4l9kDl4C4BKRKjMhaxFoVU0Vj1TKJKyVc6A/2Qfa1AG1Gn+U/JqEj1es9ctYuw==","shasum":"0d60af18def46aafa3da20a036fcf909c911091b","tarball":"https://registry.npmjs.org/@cybeleri/social-media-scheduler-mcp/-/social-media-scheduler-mcp-1.0.0.tgz","fileCount":35,"unpackedSize":150862,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIErNWoLQeUmaBwsbGr53+5dERw7L4pW8zXfvEETWcQj3AiBFRxyIC+bOX7H0vYnnULtxplhZsMUe5IvLTMMJR4qfjw=="}]},"_npmUser":{"name":"cybeleri","email":"cybeleri@gmail.com"},"directories":{},"maintainers":[{"name":"cybeleri","email":"cybeleri@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/social-media-scheduler-mcp_1.0.0_1766849038454_0.8616636484998457"},"_hasShrinkwrap":false}},"time":{"created":"2025-12-27T15:23:58.362Z","1.0.0":"2025-12-27T15:23:58.603Z","modified":"2025-12-27T15:23:58.947Z"},"maintainers":[{"name":"cybeleri","email":"cybeleri@gmail.com"}],"description":"MCP server for AI agents to schedule and manage social media content across Twitter/X, LinkedIn, Bluesky, and Mastodon","homepage":"https://github.com/cybeleri/social-media-scheduler-mcp#readme","keywords":["mcp","model-context-protocol","social-media","scheduler","twitter","linkedin","bluesky","mastodon","ai-agent","claude","apify"],"repository":{"type":"git","url":"git+https://github.com/cybeleri/social-media-scheduler-mcp.git"},"author":{"name":"cybeleri"},"bugs":{"url":"https://github.com/cybeleri/social-media-scheduler-mcp/issues"},"license":"MIT","readme":"# Social Media Scheduler MCP Server\n\nAn MCP (Model Context Protocol) server that enables AI agents to schedule and manage social media content across multiple platforms.\n\n## Features\n\n- **Multi-Platform Support**: Twitter/X, LinkedIn, Bluesky, and Mastodon\n- **Post Scheduling**: Schedule posts for future publishing with natural language time parsing\n- **Thread Support**: Create multi-post threads on supported platforms\n- **Content Validation**: Check character limits and platform-specific rules before posting\n- **Analytics**: Get engagement metrics for published posts\n- **Optimal Timing**: Get recommended posting times based on engagement patterns\n\n## Installation\n\n```bash\nnpm install @autonomous-claude/social-media-scheduler-mcp\n```\n\nOr clone and build:\n\n```bash\ngit clone https://github.com/autonomous-claude/social-media-scheduler-mcp\ncd social-media-scheduler-mcp\nnpm install\nnpm run build\n```\n\n## Usage\n\n### With Claude Desktop\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"social-scheduler\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/social-media-scheduler-mcp/dist/index.js\"]\n    }\n  }\n}\n```\n\n### With MCP Client\n\n```typescript\nimport { Client } from '@modelcontextprotocol/sdk/client/index.js';\n\n// Connect to the server\nconst client = new Client({...});\n\n// Schedule a post\nawait client.callTool({\n  name: 'schedule_post',\n  arguments: {\n    platform: 'twitter',\n    text: 'Hello from MCP! #automation',\n    scheduledAt: 'tomorrow at 9am',\n    timezone: 'America/New_York'\n  }\n});\n```\n\n## Available Tools\n\n### `create_post`\nCreate and optionally publish a social media post immediately.\n\n```json\n{\n  \"platform\": \"twitter\",\n  \"text\": \"Hello world!\",\n  \"postNow\": true\n}\n```\n\n### `schedule_post`\nSchedule a post for future publishing.\n\n```json\n{\n  \"platform\": \"linkedin\",\n  \"text\": \"Excited to share our latest update...\",\n  \"scheduledAt\": \"2024-01-15T09:00:00Z\",\n  \"timezone\": \"UTC\"\n}\n```\n\nSupports natural language scheduling:\n- \"tomorrow at 9am\"\n- \"next week\"\n- ISO 8601 format\n\n### `create_thread`\nCreate a multi-post thread (Twitter, Bluesky, Mastodon).\n\n```json\n{\n  \"platform\": \"twitter\",\n  \"posts\": [\n    \"Thread time! Here's what I learned about MCP (1/3)\",\n    \"First, MCP provides a standard protocol for AI-tool communication (2/3)\",\n    \"Finally, it enables amazing automation workflows! (3/3)\"\n  ]\n}\n```\n\n### `list_scheduled`\nList scheduled posts with filters.\n\n```json\n{\n  \"platform\": \"twitter\",\n  \"status\": \"pending\",\n  \"limit\": 20\n}\n```\n\n### `cancel_post`\nCancel a scheduled post.\n\n```json\n{\n  \"postId\": \"post_123456789_abc\"\n}\n```\n\n### `reschedule_post`\nChange the scheduled time for a pending post.\n\n```json\n{\n  \"postId\": \"post_123456789_abc\",\n  \"newScheduledAt\": \"2024-01-20T14:00:00Z\"\n}\n```\n\n### `get_analytics`\nGet engagement analytics for published posts.\n\n```json\n{\n  \"postId\": \"post_123456789_abc\"\n}\n```\n\n### `get_optimal_times`\nGet recommended posting times.\n\n```json\n{\n  \"platform\": \"linkedin\",\n  \"timezone\": \"America/Los_Angeles\"\n}\n```\n\n### `validate_content`\nCheck if content meets platform requirements.\n\n```json\n{\n  \"platform\": \"twitter\",\n  \"text\": \"This is my tweet with #hashtags and @mentions\"\n}\n```\n\n### `set_credentials`\nConfigure API credentials for a platform.\n\n```json\n{\n  \"platform\": \"twitter\",\n  \"credentials\": {\n    \"apiKey\": \"your-api-key\",\n    \"apiSecret\": \"your-api-secret\",\n    \"accessToken\": \"your-access-token\",\n    \"accessSecret\": \"your-access-secret\"\n  }\n}\n```\n\n### `get_platform_limits`\nGet character and media limits for a platform.\n\n```json\n{\n  \"platform\": \"twitter\"\n}\n```\n\n## Platform Limits\n\n| Platform | Max Text | Max Media | Threads |\n|----------|----------|-----------|---------|\n| Twitter  | 280      | 4         | Yes     |\n| LinkedIn | 3000     | 20        | No      |\n| Bluesky  | 300      | 4         | Yes     |\n| Mastodon | 500*     | 4         | Yes     |\n\n*Mastodon limit varies by instance\n\n## Resources\n\nThe server exposes two resources:\n\n- `scheduler://queue` - View all pending scheduled posts\n- `scheduler://published` - View recently published posts with analytics\n\n## Platform Credentials\n\n### Twitter/X\nRequires OAuth 1.0a credentials:\n- API Key (Consumer Key)\n- API Secret (Consumer Secret)\n- Access Token\n- Access Token Secret\n\nGet these from [Twitter Developer Portal](https://developer.twitter.com/).\n\n### LinkedIn\nRequires OAuth 2.0 access token with `w_member_social` scope.\nGet from [LinkedIn Developer Portal](https://developer.linkedin.com/).\n\n### Bluesky\nRequires:\n- Handle (e.g., `user.bsky.social`)\n- App Password (create in Bluesky settings)\n\n### Mastodon\nRequires:\n- Instance URL (e.g., `https://mastodon.social`)\n- Access Token (create in Mastodon settings > Development)\n\n## Development\n\n```bash\n# Install dependencies\nnpm install\n\n# Build TypeScript\nnpm run build\n\n# Run in development mode\nnpm run dev\n\n# Run tests\nnpm test\n```\n\n## Apify Deployment\n\nThis server can be deployed to Apify for pay-per-event monetization:\n\n```bash\n# Install Apify CLI\nnpm install -g apify-cli\n\n# Login to Apify\napify login\n\n# Deploy\nnpm run apify:push\n```\n\nSee [DEPLOY.md](./DEPLOY.md) for detailed deployment instructions.\n\n## License\n\nMIT\n\n## Contributing\n\nContributions welcome! Please read our contributing guidelines before submitting PRs.\n","readmeFilename":"README.md","_rev":"1-d817a931206a7b35f58f4149a65f80d0"}