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

npm install -g sociona-mcp-server

Alternative Installation

# Using the installation script
curl -sSL https://raw.githubusercontent.com/fav-devs/sociona-mcp-server/main/install.sh | bash

⚙️ 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

{
  "mcpServers": {
    "sociona": {
      "command": "sociona-mcp",
      "args": [],
      "env": {
        "SOCIONA_API_KEY": "sk_live_your_api_key_here",
        "SOCIONA_API_BASE": "https://api.sociona.app/api/v1"
      }
    }
  }
}

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:

"Post to Twitter: Just launched our new feature! 🚀 #TechNews"

"Schedule a post for Instagram tomorrow at 10 AM about our weekly roundup"

"Show me my connected social accounts"

"Get my last 10 posts from X"

"Cancel the scheduled post with ID sched-123"

"What's my posting statistics?"

🛠️ 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

# Clone the repository
git clone https://github.com/fav-devs/sociona-mcp-server.git
cd sociona-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

# Run in development mode
npm run dev

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