Enables publishing posts, scheduling content, managing post history, and accessing analytics through the Sociona API for Instagram social media management.
Provides capabilities to publish posts, schedule content, retrieve post history, and analyze posting statistics through the Sociona API for Threads social media platform.
Sociona MCP Server
An MCP (Model Context Protocol) server that provides AI assistants and MCP-compatible tools with access to the Sociona social media API.
🚀 Features
Publish Posts: Immediately publish content to social media platforms
Schedule Posts: Schedule posts for future publication
Cancel Scheduled Posts: Cancel posts before they publish
List Accounts: View connected social media accounts
Post History: Retrieve recent post history with filtering
Analytics: Get statistics about your posts
Multi-Platform Support: X (Twitter), Instagram, and Threads
📦 Installation
Quick Install
Alternative Installation
⚙️ Configuration
1. Get Your API Key
Sign up at Sociona Developer Portal
Create a new application
Generate an API key with required scopes:
posts:write- for publishing postsposts:read- for reading postsschedule:write- for scheduling postsschedule:read- for reading scheduled posts
2. Configure Your MCP Client
For Claude Desktop
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json
For Other MCP Clients
Configure your MCP client to use the sociona-mcp command with the required environment variables.
3. Restart Your MCP Client
Restart your MCP client to load the new MCP server configuration.
💬 Usage
Once configured, you can use natural language commands with your MCP client:
🛠️ Available Tools
The Sociona MCP Server exposes the following tools:
publish_post: Publish a social media post immediatelyschedule_post: Schedule a social media post for future publicationget_accounts: List all connected social media accountsget_posts: Retrieve recent post historyget_scheduled_posts: View upcoming scheduled postscancel_scheduled_post: Cancel a scheduled post before it publishesget_post_stats: Get statistics about your posts
🔧 Development
Prerequisites
Node.js 18 or higher
npm or pnpm
Setup
Scripts
npm run build- Build the TypeScript codenpm run dev- Run in development modenpm start- Start the MCP servernpm test- Run tests
📚 Documentation
Developer Installation Guide - Detailed setup instructions
Local Setup Guide - For local development
Architecture Overview - Technical architecture details
Railway Deployment - Cloud deployment guide
🤝 Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
Fork the repository
Create your feature branch (
git checkout -b feature/amazing-feature)Commit your changes (
git commit -m 'Add some amazing feature')Push to the branch (
git push origin feature/amazing-feature)Open a Pull Request
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
🔗 Links
🆘 Support
If you encounter any issues or have questions:
Check the Issues page
Create a new issue if your problem isn't already reported
Join our community discussions
Made with ❤️ by the Sociona team
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Enables AI assistants to publish, schedule, and manage social media posts across X (Twitter), Instagram, and Threads through the Sociona API. Supports immediate posting, scheduling, analytics, and account management with natural language commands.