Tools are structured actions that an MCP client can run through tool calling. Instead of only reading static documentation or free-form text, the client sends defined inputs to a tool and receives a structured response from the connected system.

In Sociality MCP, tools let clients discover available accounts and competitors, retrieve account or competitor insights, fetch posts, and create tracked competitors when explicitly requested. Some tools are free and useful for setup or discovery, while billable tools consume MCP credits based on the data returned by the request.

Account tools work with owned social accounts connected to the current Sociality.io workspace. Use them to list available accounts, inspect account details such as name and platform, and retrieve account-level stats or published posts.

All account tools are read-only. Start with social_accounts_list to see which accounts are available to your user, then use the returned account details to choose the right account or accounts before running stats or post queries. In the table, Credit usage shows whether a tool consumes MCP credits when it returns data.

Calling account tools

• Before using account tools, read social_platform_capabilities to confirm supported channels, metric names, metric descriptions, and aggregation behavior. Supported channels are: facebook, x, instagram, youtube, linkedin, tiktok.
• social_accounts_list supports optional filters to help narrow the account list:
  • channel filters results by social platform from the supported channels list above.
  • name searches within the account name or username/handle. For example, use Nike Running or nikerunning.
  • page is used for pagination. List results return up to 50 records per page, so use the page number you want to retrieve.
• social_account_stats_list supports the optional period input. Use day, week, or month to control how account metrics are grouped across the selected date range.
• social_account_posts_list supports optional inputs for post filtering and ordering:
  • type filters results by supported post format. Supported values: status, photo, gif, video, link, album, carousel, story, reels, document, poll, repost.
  • order sorts results by publish date. Supported values: published_at_desc, published_at_asc.

Competitor tools work with tracked competitors in the current Sociality.io workspace. Use them to list available competitors, inspect competitor details such as name and platform, and retrieve competitor-level stats or published posts.

Most competitor tools are read-only, with one exception: social_competitors_create. This is a write action used only when you want to add a new tracked competitor to the workspace.

For existing competitors, start with social_competitors_list to confirm what your user can access, then use the returned competitor details to select the right profiles for stats or post queries. The Credit usage column shows whether returned results count against MCP credits.

Calling competitor tools

• Before using competitor tools, read social_platform_capabilities to confirm supported channels, metric names, metric descriptions, and aggregation behavior. Supported channels are: facebook, x, instagram, youtube, linkedin, tiktok.
• social_competitors_list supports optional filters to help narrow the competitor list:
  • channel filters results by social platform from the supported channels list above.
  • name searches within the competitor name or username/handle. For example, use Nike Running or nikerunning.
  • page is used for pagination. List results return up to 50 records per page, so use the page number you want to retrieve.
• social_competitor_stats_list supports the optional period input. Use day, week, or month to control how competitor metrics are grouped across the selected date range.
• social_competitor_posts_list supports optional inputs for post filtering and ordering:
  • type filters results by supported post format. Supported values: status, photo, gif, video, carousel, reels, document, poll, repost.
  • order sorts results by publish date. Supported values: published_at_desc, published_at_asc.
• social_competitors_create supports the optional timezone input when creating a tracked competitor. Use a standard IANA timezone ID, such as Europe/London, America/New_York, or UTC.

Tool limits define how much data a single tool call can return and when returned data counts against MCP credits. For plan-level credits, retention, and broader usage rules, see Billing and limits.

Credit usage

• Tools marked Yes in the Credit usage column consume MCP credits when they return data.
• Stats tools use credits based on returned metric periods. Posts tools use credits based on returned posts.

Result limits

• List tools return up to 50 rows per page.
• Stats and posts tools return up to 50 rows per call. For larger result sets, use narrower date ranges, filters, or pagination where supported.

Response envelope

• Tool responses include an _envelope block with response metadata such as versioning, server timestamp, cache TTL, and warnings.