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

1. Sign up at Sociona Developer Portal

2. Create a new application

3. Generate an API key with required scopes:

   • posts:write - for publishing posts

   • posts:read - for reading posts

   • schedule:write - for scheduling posts

   • schedule: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 immediately

• schedule_post: Schedule a social media post for future publication

• get_accounts: List all connected social media accounts

• get_posts: Retrieve recent post history

• get_scheduled_posts: View upcoming scheduled posts

• cancel_scheduled_post: Cancel a scheduled post before it publishes

• get_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 code

• npm run dev - Run in development mode

• npm start - Start the MCP server

• npm 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.

1. Fork the repository

2. Create your feature branch (git checkout -b feature/amazing-feature)

3. Commit your changes (git commit -m 'Add some amazing feature')

4. Push to the branch (git push origin feature/amazing-feature)

5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🔗 Links

• NPM Package

• Sociona API Documentation

• Model Context Protocol

🆘 Support

If you encounter any issues or have questions:

1. Check the Issues page

2. Create a new issue if your problem isn't already reported

3. Join our community discussions

Made with ❤️ by the Sociona team