social_360
Social 360 | the caller's OWN deterministic social performance report over their connected Facebook Page, Instagram, TikTok, YouTube, LinkedIn and Threads data, computed server-side (the numbers the user sees in the app, nothing estimated). Call it for "how are my social accounts doing", "which post worked best", "which format should I post more of", "what caused the follower jump", "how much of this came from ads", "how do I compare to my competitors". Sections: score (a 0-100 index per platform plus a reach-weighted blend from engagement rate on reach, follower growth and posting consistency, against the account OWN history; a part the platform cannot report is dropped, never zero), explorer (every channel as daily series for every KPI its platform reports, a support matrix naming WHY a KPI is missing, per channel the window sums of paid reach and paid engagements from Meta Ads, and the Instagram splits: views by content type incl. its Ads type, views and reach by followers vs non-followers, interactions by content type, story replies, reposts, contact button taps), posts (top posts sortable by engagement, reach, views, likes, comments, shares, saves and the rates on reach; format benchmark; frequency vs engagement; effectiveness vs the median post of the same format; Instagram posts with reposts, follows, profile visits and reel skip rate; stories as format STORY rows with replies, link taps and navigation; PAID VS ORGANIC: a post a Meta ad promotes carries paid=true, paidReach, paidInteractions and the campaign next to its organic numbers, a post no ad names is organic by fact), geo (official country breakdowns: Instagram demographics, YouTube geography; plus follower age, gender and top cities), spikes (unusual follower or reach days with the posts of that window as CANDIDATES, never a claimed cause), peers (You vs tracked public accounts: follower gap, growth race, posting frequency, public engagement), findings (deterministic works / needs-attention list, each with a hedged reading and an evidence line), financials (SOCIAL ads only: Meta, TikTok, Pinterest, Snapchat, Reddit, LinkedIn Ads, with Google Ads in marketing_report; spend, CPC, CPM per account and campaign, the currency on every figure, revenue and ROAS only where the platform reports a money value, paid vs organic side by side, never summed), health (what each platform counts as reach, freshness, caveats). Works with ONE connected channel; an unconnected platform carries an honest not-connected state, never zeros. Requires the caller own autario account (API key or OAuth) with at least one social connector | see get_app_context("social-360").
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| days | No | Analysis window in days (7-90, default 28). Each platform anchors it at the newest day of ITS OWN connector table, because connectors refresh on different rhythms. | |
| sort | No | How the cross-platform top-post list is ranked (posts section). Default engagement. The three rates rank only posts whose platform reports them (Instagram today). | |
| brand | No | The brand (connector grouping) id to report on, as a uuid. Omitted means the brand selected in the autario app (the account's stored brand choice), so you see what the user sees on screen; with no brand selected, all of the account's brands. A brand that is not yours answers an error, never another brand's numbers. | |
| format | No | Output wire format for this MCP call. Default 'toon' (Token-Oriented Notation, fewest tokens, best for tabular rows). 'compact' = minified JSON. 'json' = pretty JSON for readability. The REST API always returns JSON regardless. | |
| sections | No | Which report sections to return. Default ["score","health"]. Request only what the question needs (token efficiency); call again for more. activity = the activity table: every post with platform, content type, topic, post type, sentiment and language, per-dimension pivots and the (platform, content type, topic, language) groups that beat the platform median; labels come from the user's own classification run. | |
| instances | No | Optional comma-separated connector instance ids, to narrow the report to some of the connections inside the selected brand (for example one of two Search Console properties). Omitted means all of them. An id that is not yours, or not in that brand, answers an error rather than a quietly shorter report. The ids are the instance ids get_app_context returns for this app. |