Getting started
Verify your setup
This workflow confirms that Sociality MCP is connected correctly, your workspace is accessible, and your client can read the context needed for future workflows. It does not use MCP credits. It only reads workspace context, available data sources, platform capabilities, and tool information.
The goal is to finish with a verified MCP setup that is ready for agent workflows, internal copilots, reporting assistants, benchmarking flows, and custom tools powered by Sociality.io intelligence.
Step 1: Check your workspace
Goal: Confirm that your client is authenticated and connected to the correct Sociality.io workspace.
Read:
social_workspace_contextUse the response to check:
- active workspace or team context
- current user context
- MCP credit usage
- MCP credit limit
- next reset date, if available
Step 2: Discover available data sources
Goal: Confirm that your workspace has accessible owned accounts or tracked competitors.
For owned accounts:
social_accounts_listFor tracked competitors:
social_competitors_listUse the response to identify at least one account or competitor that could be used later in an analysis workflow.
Step 3: Review platform capabilities
Goal: Confirm which channels, features, metrics, and aggregation behavior are supported before preparing any stats query.
Read:
social_platform_capabilitiesUse the response to check:
- supported channels
- available account metrics
- available competitor metrics
- metric descriptions
- aggregation behavior
This step helps prevent failed queries caused by unsupported channels or guessed metric names.
Step 4: Review available tools
Goal: Understand which tools are available and which ones consume credits.
Read:
social_tools_catalogUse the response to distinguish:
- free setup and discovery tools
- billable account analysis tools
- billable competitor analysis tools
- read-only tools
- write actions, such as competitor creation
Final step: Confirm your first milestone
You have completed this setup check when you can confirm:
- MCP client is connected
- OAuth is working
- Correct workspace is visible
- Credit status is visible
- At least one owned account or competitor is listed
- Supported channels and metrics are visible
- Available tools are visible
- Free tools and billable tools can be distinguished
After this, your MCP setup is ready to use Sociality.io intelligence to support broader workflows through AI agents and custom tools.