Sociona

You run an MCP server that exposes social media tooling through the Model Context Protocol, enabling AI assistants and MCP clients to publish, schedule, and analyze posts across multiple platforms using the Sociona API.

How to use

You interact with the Sociona MCP Server through your MCP client. Start by ensuring your MCP client is pointed at the Sociona MCP Server executable and has your API credentials loaded. Once connected, you can issue natural language commands to perform common actions such as publishing posts immediately, scheduling posts for future times, listing connected accounts, retrieving post history, and checking posting analytics. Examples of actionable phrases include asking to publish a post to a platform, scheduling content for a future date, listing your connected social accounts, retrieving recent posts, canceling a scheduled post, or querying your posting statistics.

How to install

Prerequisites: Node.js 18 or higher and npm (or pnpm) installed on your machine.

npm install -g sociona-mcp-server

Alternatively, install using the installation script provided by the project.

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

Configuration and startup notes

Configure your MCP client to use the Sociona MCP Server by providing the server command and the required environment variables. The server is typically run as a local process that your MCP client can invoke.

{
  "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"
      }
    }
  }
}

Restart your MCP client after adding this configuration so the Sociona MCP Server loads the new settings.

Security and credentials

Protect your API key. Treat the SOCIONA_API_KEY as a secret and rotate it regularly. Use role-based scopes to limit access to publish, read, and schedule actions as needed.

Examples and usage notes

You can request actions such as publishing, scheduling, listing accounts, or retrieving stats using natural language. For example: “Post to Twitter: Just launched our new feature! 🚀 #TechNews” or “Schedule a post for Instagram tomorrow at 10 AM about our weekly roundup.” You can also ask to see your connected accounts, fetch the last posts, or check posting statistics.

Troubleshooting

If you encounter connection issues, verify that the Sociona API base URL is reachable and that the API key has the required scopes. Ensure your MCP client has the latest Sociona MCP Server configuration loaded and that the Sociona service is running on the expected command path.

Available tools

publish_post

Publish a social media post immediately to a connected account

schedule_post

Schedule a social media post for future publication with a specified time

get_accounts

List all connected social media accounts

get_posts

Retrieve recent post history with optional filters

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