Docs

Overview

What is MCP?

Model Context Protocol (MCP) is an open standard that lets AI assistants connect to external systems through a common interface. With Sociality.io MCP, your AI tool can securely access Sociality.io data through OAuth and use Sociality.io tools, resources, and prompts.

Sociality.io MCP Server

Remote MCP server URL: https://api.sociality.io/mcp

What You Can Do

• List managed social accounts you can access
• Fetch account stats and published posts
• List tracked competitors
• Create a competitor tracking record from a profile URL
• Fetch competitor stats and published posts
• Inspect current workspace context and MCP credit usage
• Discover supported channels, metrics, and tool metadata
• Use built-in prompts for workflow guidance and readiness checks

Supported Channels

facebook, x, instagram, youtube, linkedin, tiktok

Billing and Limits

• Billable tools charge credits per returned data row.
• Free tools do not consume MCP credits.
• Tool and resource responses include an _envelope block with versioning, server timestamp, cache TTL, and warnings.
• List tools paginate up to 50 rows per page.
• Stats and posts tools return up to 50 rows per call.
• Competitor creation is a write action and is also subject to your workspace permissions and plan limits.

Billable tools

• social_account_stats_list
• social_account_posts_list
• social_competitor_stats_list
• social_competitor_posts_list

Free primitives

• social_accounts_list
• social_competitors_list
• social_competitors_create
• All resources
• All prompts

Examples

• A 30-day daily stats query that returns 30 rows uses 30 credits.
• A posts query that returns 18 posts uses 18 credits.

Use the social_workspace_context resource to check current usage, limit, and resets_at before running larger billable queries.