---
title: "Social Media MCP Tools: All 18, With Parameters · SocialToAI"
canonical: https://socialtoai.app/docs/mcp/tools/
updated: 2026-11-20
---

# MCP tool list

The SocialToAI MCP server lists 18 tools at https://socialtoai.app/mcp. Each tool that reads is read-only (`watch` sets up, pauses and deletes your own watches), and each carries a short description with its price in credits, so your AI knows when to use it and what it will cost. A call that fails costs nothing, and every answer states the credits charged and the balance.

- Page: https://socialtoai.app/docs/mcp/tools/
- Last updated: 2026-11-20

These are the tools an AI client sees once it is connected to the SocialToAI [social media MCP server](https://socialtoai.app/mcp.md). Six of them are the actions every platform shares (search, trending, detail, comments, profile, posts); the rest find and call any other interface, run the ready-made tools, set up watches and check the balance. Your AI reads each description below and picks the tool itself, so you ask in plain words and never name one. This page is what the server answers to `tools/list`, with each parameter as the AI is given it. To connect Claude, ChatGPT, Cursor or another client, see [the MCP page](https://socialtoai.app/mcp.md).

What these tools read on one platform: [TikTok MCP](https://socialtoai.app/mcp/tiktok.md), [Instagram MCP](https://socialtoai.app/mcp/instagram.md), [X (Twitter) MCP](https://socialtoai.app/mcp/x.md), [Reddit MCP](https://socialtoai.app/mcp/reddit.md), [YouTube MCP](https://socialtoai.app/mcp/youtube.md), [Facebook MCP](https://socialtoai.app/mcp/facebook.md), [LinkedIn MCP](https://socialtoai.app/mcp/linkedin.md), [Threads MCP](https://socialtoai.app/mcp/threads.md), [Telegram MCP](https://socialtoai.app/mcp/telegram.md), [Pinterest MCP](https://socialtoai.app/mcp/pinterest.md), [Xiaohongshu (RedNote) MCP](https://socialtoai.app/mcp/xiaohongshu.md), [Douyin MCP](https://socialtoai.app/mcp/douyin.md), [Weibo MCP](https://socialtoai.app/mcp/weibo.md), [WeChat Articles MCP](https://socialtoai.app/mcp/wechat.md), [Bilibili MCP](https://socialtoai.app/mcp/bilibili.md), [Zhihu MCP](https://socialtoai.app/mcp/zhihu.md), [Kuaishou MCP](https://socialtoai.app/mcp/kuaishou.md), [WeChat Channels MCP](https://socialtoai.app/mcp/wechat-channels.md).

`watch` and `watch_news` let your AI keep an eye on something for you: a search or a tool run again every day or week, delivering only what is new. See [Schedules](https://socialtoai.app/docs/schedules.md).

## Tools

| Tool | What it does | Credits per call |
| --- | --- | --- |
| [`search`](https://socialtoai.app/docs/mcp/tools.md) | Find posts or accounts by keyword | 2–12 credits |
| [`trending`](https://socialtoai.app/docs/mcp/tools.md) | What is hot right now | 2–12 credits |
| [`detail`](https://socialtoai.app/docs/mcp/tools.md) | One post: text and numbers | 1–12 credits |
| [`comments`](https://socialtoai.app/docs/mcp/tools.md) | Comments under a post | 2–12 credits |
| [`user_profile`](https://socialtoai.app/docs/mcp/tools.md) | One account: bio and counts | 1–12 credits |
| [`user_posts`](https://socialtoai.app/docs/mcp/tools.md) | Posts from one account | 2–12 credits |
| [`find`](https://socialtoai.app/docs/mcp/tools.md) | Find what can be called by what the user wants done, in their words, English or Chinese: results are the calls, best first, with parameters, credits and a call that works; recommended, if any, is the tool or watch that does the whole job | Free |
| [`call`](https://socialtoai.app/docs/mcp/tools.md) | Call one platform-specific capability by its op ("platform.name"): what the six actions do not cover | By what it runs |
| [`capabilities`](https://socialtoai.app/docs/mcp/tools.md) | What can be called now | Free |
| [`account`](https://socialtoai.app/docs/mcp/tools.md) | Whose key or app this is: plan, balance, today's spend and limits | Free |
| [`brand_buzz`](https://socialtoai.app/docs/mcp/tools.md) | What people say about a brand or product on each platform: the share of each attitude, what is mentioned most, and the posts with the most engagement, each with its source link | By what it runs |
| [`comment_insights`](https://socialtoai.app/docs/mcp/tools.md) | What the comments under your posts are about: the topics and their shares, the questions asked, who wants to buy and what is complained about, with the comments quoted | By what it runs |
| [`find_creators`](https://socialtoai.app/docs/mcp/tools.md) | Creators on one platform for a niche: their size, their recent posts, and how well each fits what you asked for, with the reasons | By what it runs |
| [`account_watch`](https://socialtoai.app/docs/mcp/tools.md) | What a set of accounts published lately and which posts did clearly better than each account's usual | By what it runs |
| [`creator_card`](https://socialtoai.app/docs/mcp/tools.md) | One creator across platforms: the accounts found for the same person, with followers, posts, engagement and how strong the evidence is that each is theirs | By what it runs |
| [`research`](https://socialtoai.app/docs/mcp/tools.md) | Run one of these by name | By what it runs |
| [`watch`](https://socialtoai.app/docs/mcp/tools.md) | Daily watch: a search, action, op or tool we run again every day or week | Free |
| [`watch_news`](https://socialtoai.app/docs/mcp/tools.md) | What the user's watches found that they have not been shown yet, newest first, with each watch, its time and status | Free |

Every tool that charges takes `handle`: it reads a result an earlier answer gave a handle for, free, and runs nothing else. A large answer comes in parts, each with the handle for the next. [Results and handles](https://socialtoai.app/docs/api/results.md) explains both.

## Each tool

### `search` (2–12 credits, read-only)

**The description your AI is given**

```
Search a platform for content. Read-only. Each line: what to pass, then platforms at 2 credits a call unless numbered. A list of platforms: a call each. Failed calls cost 0. Need 100 items? Pass limit=100 (a call a page).
Give query: bilibili, douyin 12, kuaishou 12, linkedin, pinterest, reddit, threads, tiktok, wechat 12, wechat_channels 12, weibo, x, xiaohongshu 12, youtube, zhihu
With type=user: douyin, instagram 3, kuaishou 12, tiktok, wechat 12, wechat_channels 36, weibo, x 5, xiaohongshu 12, youtube, zhihu
With sort=latest: x
With type=image: xiaohongshu 12
since/until: ISO dates, all platforms.
More parameters: capabilities. On error, follow error.fix. Tell the user billing.display.
```

| Parameter | Type | Required | What it is |
| --- | --- | --- | --- |
| `platform` | string \| array | Yes | One, or a list. |
| `query` | string | No | Search terms |
| `sort` | string | No | Only bilibili, douyin, kuaishou, reddit, tiktok, wechat, wechat_channels, x, xiaohongshu, youtube, zhihu. By platform: relevance, latest, popular, most_followers, fewest_followers, most_comments, most_favorites |
| `since` | string | No | Published at or after: an ISO 8601 date (2026-10-01) or time. Where the platform has no such filter, its nearest time window is used and the page is filtered by published_at; warnings say so. |
| `until` | string | No | Published at or before: an ISO 8601 date (that whole day) or time. Where the platform has no such filter, the page is filtered by published_at; warnings say so. |
| `published_within` | string | No | Only douyin, kuaishou, linkedin, reddit, tiktok, wechat, wechat_channels, xiaohongshu, youtube. By platform: day, week, half_year, month, year |
| `type` | string | No | Only douyin, instagram, kuaishou, tiktok, wechat, wechat_channels, weibo, x, xiaohongshu, youtube, zhihu. By platform: article, video, image, answer, user |
| `cursor` | string | No | page.cursor of the last answer, other arguments unchanged. |
| `max_cost_credits` | integer | No | Refused, free, if the call would cost more. |
| `handle` | string | No | A handle an earlier answer gave, or the request_id of an earlier call: reads that result again, free. Nothing else is run. |

### `trending` (2–12 credits, read-only)

**The description your AI is given**

```
Read a platform's trending list. Read-only. Each line: what to pass, then platforms at 2 credits a call unless numbered. A list of platforms: a call each. Failed calls cost 0. Need 100 items? Pass limit=100 (a call a page).
Needs no parameter: bilibili, douyin, kuaishou, reddit, weibo, x 6, xiaohongshu 12, zhihu
With type=videos: bilibili, douyin
With type=trends: reddit
More parameters: capabilities. On error, follow error.fix. Tell the user billing.display.
```

| Parameter | Type | Required | What it is |
| --- | --- | --- | --- |
| `platform` | string \| array | Yes | One, or a list. |
| `board` | string | No | Only bilibili, douyin, reddit, weibo, x, xiaohongshu, zhihu. By platform: hot_search, rising, topics, searches, music, low_fan, high_like, high_completion, high_follow, popular, trends, inspiration, hot |
| `type` | string | No | Only bilibili, douyin, reddit. By platform: videos, trends |
| `region` | string | No | Only x. Which country's trends, by its two-letter code: US, GB, CA, AU, IN, JP, DE, FR, BR or MX; worldwide when left out |
| `cursor` | string | No | page.cursor of the last answer, other arguments unchanged. |
| `max_cost_credits` | integer | No | Refused, free, if the call would cost more. |
| `handle` | string | No | A handle an earlier answer gave, or the request_id of an earlier call: reads that result again, free. Nothing else is run. |
| `limit` | integer | No | How many items you want: pages are fetched one after another in this one call until there are that many or no more, each page charged as a call; pages not needed cost 0. Need 100 items? Pass limit=100. |

### `detail` (1–12 credits, read-only)

**The description your AI is given**

```
Get one piece of content by its id or link. Read-only. Each line: what to pass (a|b: either one), then platforms at 2 credits a call unless numbered. A list of platforms, ids or links: a call each. Failed calls cost 0.
Give id|url: bilibili, douyin, instagram, kuaishou, linkedin, pinterest, reddit, telegram, threads, tiktok, weibo, x 1, xiaohongshu 12, youtube, zhihu
Give url: facebook, wechat 12
Give id|url|export_id: wechat_channels 12
With type=article|pin|question: zhihu
Add include=transcript, charged on top: instagram, linkedin, reddit, tiktok, x, youtube
More parameters: capabilities. Pass links whole, as given. On error, follow error.fix. Tell the user billing.display.
```

| Parameter | Type | Required | What it is |
| --- | --- | --- | --- |
| `platform` | string \| array | Yes | One, or a list. |
| `id` | string \| array | No | Video ID, a string of digits |
| `url` | string \| array | No | Link to the video, pasted as it is: the https://www.tiktok.com/@handle/video/… web link, the www.tiktok.com/t/… or vm.tiktok.com short link the app copies, or a whole share text with one of these in it. A short link is opened once to see which video it leads to |
| `lang` | string | No | Only tiktok, youtube |
| `export_id` | string \| array | No | The id of a search (platform=wechat_channels) result, starting with export/. It expires: use it soon after the search. The id returned is the video's numeric ID |
| `type` | string | No | Only zhihu. By platform: article, pin, question |
| `include` | string \| array | No | Fetched beside each result: transcript. |
| `max_cost_credits` | integer | No | Refused, free, if the call would cost more. |
| `handle` | string | No | A handle an earlier answer gave, or the request_id of an earlier call: reads that result again, free. Nothing else is run. |

### `comments` (2–12 credits, read-only)

**The description your AI is given**

```
Read the comments under one piece of content. Read-only. Each line: what to pass (a|b: either one), then platforms at 2 credits a call unless numbered. A list of platforms, ids or links: a call each. Failed calls cost 0. Need 100 items? Pass limit=100 (a call a page).
Give id: bilibili, facebook, wechat_channels 12, x, zhihu
Give id|url: douyin, instagram, kuaishou, reddit, tiktok, weibo, xiaohongshu 12, youtube
Give url: wechat 12
With reply_of: bilibili, douyin, instagram, kuaishou, tiktok, wechat 12, wechat_channels 9, weibo, xiaohongshu 12, youtube, zhihu
More parameters: capabilities. Pass links whole, as given. On error, follow error.fix. Tell the user billing.display.
```

| Parameter | Type | Required | What it is |
| --- | --- | --- | --- |
| `platform` | string \| array | Yes | One, or a list. |
| `id` | string \| array | No | Video ID, a string of digits |
| `sort` | string | No | Only bilibili, reddit, xiaohongshu, youtube. By platform: popular, latest, best |
| `reply_of` | string \| array | No |  |
| `url` | string \| array | No | Link to the video, pasted as it is: the https://www.tiktok.com/@handle/video/… web link, the www.tiktok.com/t/… or vm.tiktok.com short link the app copies, or a whole share text with one of these in it. A short link is opened once to see which video it leads to |
| `cursor` | string | No | page.cursor of the last answer, other arguments unchanged. |
| `max_cost_credits` | integer | No | Refused, free, if the call would cost more. |
| `handle` | string | No | A handle an earlier answer gave, or the request_id of an earlier call: reads that result again, free. Nothing else is run. |
| `limit` | integer | No | How many items you want: pages are fetched one after another in this one call until there are that many or no more, each page charged as a call; pages not needed cost 0. Need 100 items? Pass limit=100. |

### `user_profile` (1–12 credits, read-only)

**The description your AI is given**

```
Get one account's public profile: name, bio, verification and follower counts. Read-only. Each line: what to pass (a|b: either one), then platforms at 2 credits a call unless numbered. A list of platforms: a call each. Failed calls cost 0.
Give id: bilibili, kuaishou 12, wechat 12, wechat_channels 12, weibo
Give id|url: douyin, xiaohongshu 12
Give id|username|url: facebook
Give username: instagram, reddit, telegram, threads, zhihu
Give username|url: linkedin
Give id|username: tiktok, x 1, youtube
Many creators? find_creators sizes them up in one run.
More parameters: capabilities. Pass links whole, as given. On error, follow error.fix. Tell the user billing.display.
```

| Parameter | Type | Required | What it is |
| --- | --- | --- | --- |
| `platform` | string \| array | Yes | One, or a list. |
| `id` | string | No | TikTok user ID, a string of digits |
| `url` | string | No | Link to the page, written facebook.com/handle |
| `username` | string | No | TikTok handle, without the @ |
| `max_cost_credits` | integer | No | Refused, free, if the call would cost more. |
| `handle` | string | No | A handle an earlier answer gave, or the request_id of an earlier call: reads that result again, free. Nothing else is run. |

### `user_posts` (2–12 credits, read-only)

**The description your AI is given**

```
List what one account has published. Read-only. Each line: what to pass (a|b: either one), then platforms at 2 credits a call unless numbered. A list of platforms: a call each. Failed calls cost 0. Need 100 items? Pass limit=100 (a call a page).
Give id: bilibili, kuaishou 12, wechat 12, wechat_channels 12, weibo
Give id|url: douyin, xiaohongshu 12
Give id|username|url: facebook
Give username: instagram, reddit, telegram, threads, tiktok, x, zhihu
Give username|url: linkedin
Give id|username: youtube
With type=answer|pin: zhihu
More parameters: capabilities. Pass links whole, as given. On error, follow error.fix. Tell the user billing.display.
```

| Parameter | Type | Required | What it is |
| --- | --- | --- | --- |
| `platform` | string \| array | Yes | One, or a list. |
| `id` | string | No | Channel ID, starting with UC |
| `url` | string | No | Link to the page, written facebook.com/handle |
| `username` | string | No | TikTok handle, without the @ |
| `type` | string | No | Only instagram, youtube, zhihu. By platform: all, reel, video, short, answer, pin |
| `sort` | string | No | Only tiktok, youtube. By platform: latest, popular |
| `tab` | string | No | Only wechat, x. By platform: articles, videos, images, posts, replies, media |
| `cursor` | string | No | page.cursor of the last answer, other arguments unchanged. |
| `max_cost_credits` | integer | No | Refused, free, if the call would cost more. |
| `handle` | string | No | A handle an earlier answer gave, or the request_id of an earlier call: reads that result again, free. Nothing else is run. |

### `find` (Free, read-only)

**The description your AI is given**

```
Find what can be called by what the user wants done, in their words, English or Chinese: results are the calls, best first, with parameters, credits and a call that works; recommended, if any, is the tool or watch that does the whole job. Free. Asked about docs or code, adds the links. not_offered: results are only the closest: tell the user, never pass those off as what was asked for.
```

| Parameter | Type | Required | What it is |
| --- | --- | --- | --- |
| `query` | string | Yes | What it should do, in 1 to 500 characters. |
| `platform` | string | No | Only this platform. |
| `limit` | integer | No | How many, 1 to 50; 5 unless given. |

### `call` (By what it runs, read-only)

**The description your AI is given**

```
Call one platform-specific capability by its op ("platform.name"): what the six actions do not cover. find finds an op by what it does; capabilities lists each with its parameters and its credits per call (1 to 102). Read-only. A failed call costs 0.
Ops per platform now: douyin 26, google 3, instagram 1, linkedin 2, meta 5, reddit 3, tiktok 10, wechat 6, wechat_channels 5, weibo 2, x 13, xiaohongshu 21, youtube 2, zhihu 3.
Pass links whole, as given. On error, follow error.fix. Tell the user billing.display.
Docs: https://socialtoai.app/docs/api/call/
```

| Parameter | Type | Required | What it is |
| --- | --- | --- | --- |
| `op` | string | Yes | As find and capabilities give it, like douyin.account_audience. |
| `params` | object | No | The op's own parameters, by name. |
| `cursor` | string | No | page.cursor of the last answer, other arguments unchanged. |
| `max_cost_credits` | integer | No | Refused, free, if the call would cost more. |
| `handle` | string | No | A handle an earlier answer gave, or the request_id of an earlier call: reads that result again, free. Nothing else is run. |

### `capabilities` (Free, read-only)

**The description your AI is given**

```
What can be called now. With platform: each action and op there, with parameters, credits, page size, fields it cannot give and a call that works. Without: only the platforms and how many calls each has. Free.
Platforms now: bilibili, douyin, facebook, google, instagram, kuaishou, linkedin, meta, pinterest, reddit, telegram, threads, tiktok, wechat, wechat_channels, weibo, x, xiaohongshu, youtube, zhihu.
```

| Parameter | Type | Required | What it is |
| --- | --- | --- | --- |
| `platform` | string | No | This platform's calls. |

### `account` (Free, read-only)

**The description your AI is given**

```
Whose key or app this is: plan, balance, today's spend and limits. Free. Scripts: for_scripts.
```

### `brand_buzz` (By what it runs, read-only)

**The description your AI is given**

```
What people say about a brand or product on each platform: the share of each attitude, what is mentioned most, and the posts with the most engagement, each with its source link. Runs on our side. A costly or long run quotes its price first.
Credits by scale small/medium/large, for one name on one platform: bilibili, youtube 16/100/284; douyin 60/180/420; kuaishou 60/210/540; reddit 20/76/210; wechat 36/270/834; weibo 20/100/282; x 16/124/368; xiaohongshu 36/258/780; zhihu 18/90/234; instagram 16/92/254; linkedin 20/-/-; threads, pinterest 16/-/-; tiktok 16/140/440; wechat_channels 60/306/906.
On error, follow error.fix. Tell the user billing.display.
```

| Parameter | Type | Required | What it is |
| --- | --- | --- | --- |
| `brand` | string | Yes | The brand, product or topic by its name. |
| `about` | string | No | What it is, in a sentence: keeps out other things of the same name. |
| `compare_with` | array | No | Up to 2 competitors. Each is read by the same plan and priced on its own. |
| `platforms` | array | No | 1 to 5 platforms. Left out: the usual three for the language the name is written in, as far as each is offered; the answer names them. |
| `window` | string | No | How far back to read. One of 7d, 30d, 90d. |
| `scale` | string | No | small reads up to 40 posts a platform and no comments; medium about 100 posts and 2 pages of comments of 6 of them; large about 200 posts and 3 pages of comments of 15. |
| `max_cost_credits` | integer | No | Refused, free, with the quote, if the run would cost more. |
| `confirm` | boolean | No | true: run it whatever it costs. false: answer the plan and its price, and run nothing. Left out: a costly run, and one that runs in the background, answers its price first. |
| `handle` | string | No | A handle an earlier answer gave, or the request_id of an earlier call: reads that result again, free. Nothing else is run. |

### `comment_insights` (By what it runs, read-only)

**The description your AI is given**

```
What the comments under your posts are about: the topics and their shares, the questions asked, who wants to buy and what is complained about, with the comments quoted. Runs on our side. A costly or long run quotes its price first.
Credits by scale small/medium/large, for one post: bilibili, douyin, weibo, youtube 50/232/672; kuaishou 40/182/522; reddit 80/382/1122; wechat 150/732/-; x 42/190/544; xiaohongshu 270/672/-; zhihu, facebook 70/332/972; instagram 58/266/772; tiktok 38/172/492; wechat_channels 138/636/-.
Pass links whole, as given. On error, follow error.fix. Tell the user billing.display.
```

| Parameter | Type | Required | What it is |
| --- | --- | --- | --- |
| `targets` | array | Yes | 1 to 20 links to posts; they may be of different platforms. |
| `focus` | string | No | What you want to know, in a sentence: adds the comments that speak to it. |
| `topics` | array | No | Your own topics, up to 10: the step that finds topics is then left out. |
| `scale` | string | No | The most comments read in all, shared by the posts: small 200, medium 1,000, large 3,000; fewer on a platform whose comments cost more, as the answer says. |
| `max_cost_credits` | integer | No | Refused, free, with the quote, if the run would cost more. |
| `confirm` | boolean | No | true: run it whatever it costs. false: answer the plan and its price, and run nothing. Left out: a costly run, and one that runs in the background, answers its price first. |
| `handle` | string | No | A handle an earlier answer gave, or the request_id of an earlier call: reads that result again, free. Nothing else is run. |

### `find_creators` (By what it runs, read-only)

**The description your AI is given**

```
Creators on one platform for a niche: their size, their recent posts, and how well each fits what you asked for, with the reasons. Runs on our side. A costly or long run quotes its price first.
Credits by scale small/medium/large, for one search on one platform: bilibili 90/226/442; douyin 9/27/75; weibo 96/236/456; x 75/181/347; xiaohongshu 30/90/390; youtube, tiktok 92/228/444; instagram 93/229/445.
On error, follow error.fix. Tell the user billing.display.
```

| Parameter | Type | Required | What it is |
| --- | --- | --- | --- |
| `query` | string | Yes | The niche, as keywords. |
| `platform` | string | Yes | One platform. |
| `followers_min` | integer | No | The fewest followers a creator may have. |
| `followers_max` | integer | No | The most followers a creator may have. |
| `brief` | string | No | Who you are looking for, in a sentence: what each creator is judged against. |
| `scale` | string | No | Creators whose profile and posts are fetched: small 20, medium 50, large 100. |
| `max_cost_credits` | integer | No | Refused, free, with the quote, if the run would cost more. |
| `confirm` | boolean | No | true: run it whatever it costs. false: answer the plan and its price, and run nothing. Left out: a costly run, and one that runs in the background, answers its price first. |
| `handle` | string | No | A handle an earlier answer gave, or the request_id of an earlier call: reads that result again, free. Nothing else is run. |

### `account_watch` (By what it runs, read-only)

**The description your AI is given**

```
What a set of accounts published lately and which posts did clearly better than each account's usual. It runs once. Runs on our side. A costly or long run quotes its price first. To repeat it daily, use watch.
Credits by scale small/medium/large, for one account: bilibili, youtube 10/12/22; douyin, reddit, weibo, zhihu 10/14/24; kuaishou 30/54/70; wechat 42/90/120; x 9/13/29; xiaohongshu 30/54/84; facebook 12/20/30; instagram 12/18/28; linkedin 12/20/-; telegram 10/14/-; threads 12/16/-; tiktok 12/20/36; wechat_channels 42/66/96.
Pass links whole, as given. On error, follow error.fix. Tell the user billing.display.
```

| Parameter | Type | Required | What it is |
| --- | --- | --- | --- |
| `accounts` | array | Yes | 1 to 20 links to account pages; they may be of different platforms. |
| `window` | string | No | How far back to look for new posts. One of 7d, 30d. |
| `scale` | string | No | Per account: small about 20 posts, medium about 60, large as medium and the comments of 2 posts that took off. |
| `max_cost_credits` | integer | No | Refused, free, with the quote, if the run would cost more. |
| `confirm` | boolean | No | true: run it whatever it costs. false: answer the plan and its price, and run nothing. Left out: a costly run, and one that runs in the background, answers its price first. |
| `handle` | string | No | A handle an earlier answer gave, or the request_id of an earlier call: reads that result again, free. Nothing else is run. |

### `creator_card` (By what it runs, read-only)

**The description your AI is given**

```
One creator across platforms: the accounts found for the same person, with followers, posts, engagement and how strong the evidence is that each is theirs. Runs on our side. A costly or long run quotes its price first.
Credits by scale small/medium, for one creator, starting on this platform, looked for on the default platforms: bilibili, x 34/58; douyin, weibo 26/50; kuaishou 58/88; reddit, facebook 47/59; wechat, wechat_channels 58/112; xiaohongshu 58/154; youtube 35/53; zhihu 38/56; instagram 34/46; linkedin, telegram, threads 47/-; tiktok 47/71.
Pass links whole, as given. On error, follow error.fix. Tell the user billing.display.
```

| Parameter | Type | Required | What it is |
| --- | --- | --- | --- |
| `creator` | string | Yes | A link to the creator's page. |
| `platforms` | array | No | The other platforms to look on: up to 3, or 6 with scale medium. Left out: the usual three for the platform the creator starts on, as far as each is offered; the answer names them. |
| `scale` | string | No | medium adds a sample of the comments under the creator's latest posts and, where the platform has one, the creator's marketplace profile. |
| `max_cost_credits` | integer | No | Refused, free, with the quote, if the run would cost more. |
| `confirm` | boolean | No | true: run it whatever it costs. false: answer the plan and its price, and run nothing. Left out: a costly run, and one that runs in the background, answers its price first. |
| `handle` | string | No | A handle an earlier answer gave, or the request_id of an earlier call: reads that result again, free. Nothing else is run. |

### `research` (By what it runs, read-only)

**The description your AI is given**

```
Run one of these by name. A costly or long run quotes its price first. Pass links whole, as given. On error, follow error.fix. Tell the user billing.display.
batch_stats: urls, max_cost_credits?, confirm?. Credits a link, post/account: bilibili, douyin, reddit, weibo, youtube, zhihu, facebook, instagram, linkedin, telegram, threads, tiktok 2/2; kuaishou 2/12; wechat 24/12; x 1/1; xiaohongshu, wechat_channels 12/12.
viral_finder: query, platform, window?, scale?, max_cost_credits?, confirm?. Credits by scale small/medium/large: bilibili, youtube 24/64/160; douyin 48/88/192; x 24/54/130; xiaohongshu 54/294/810; tiktok 36/76/178.
Docs: https://socialtoai.app/docs/mcp/tools/
```

| Parameter | Type | Required | What it is |
| --- | --- | --- | --- |
| `tool` | string | Yes | One of batch_stats, viral_finder. |
| `inputs` | object | Yes | That tool's inputs, by name. |
| `handle` | string | No | A handle an earlier answer gave, or the request_id of an earlier call: reads that result again, free. Nothing else is run. |

### `watch` (Free)

**The description your AI is given**

```
Daily watch: a search, action, op or tool we run again every day or week. The first run is the baseline; then only what is new goes to email, webhooks, a Feishu/WeCom/Slack chat, RSS and watch_news.
Two steps. action=preview with run (tool, action or op), inputs (as it takes them), every, time, timezone, name, delivery: tell the user preview.display. Only after they agree, action=confirm with its token.
list shows each watch's feed URL; pause, resume, delete, rotate_feed and revoke_feed take id. Each run is charged as the call itself; a free account keeps 1 watch. On error, follow error.fix.
```

| Parameter | Type | Required | What it is |
| --- | --- | --- | --- |
| `action` | string | Yes |  |
| `run` | string | No | What runs each time: a tool (brand_buzz), an action (search) or an op. |
| `inputs` | object | No | Its inputs, as that tool takes them. |
| `name` | string | No | A short name, in the user's words. |
| `every` | string | No | day unless given. |
| `time` | string | No | HH:MM, 09:00 unless given. |
| `timezone` | string | No | The user's IANA time zone. |
| `delivery` | string | No | email, webhook, both (email unless given), or the user's group bot webhook URL (Feishu/Lark, WeCom, Slack) to post new items to that chat. |
| `token` | string | No | The preview's, to confirm it. |
| `id` | string | No | The watch's (from list), for pause, resume, delete, rotate_feed or revoke_feed. |

### `watch_news` (Free, read-only)

**The description your AI is given**

```
What the user's watches found that they have not been shown yet, newest first, with each watch, its time and status. Use it when the user asks what is new. Free. Pass id for one watch; what is shown is not shown again.
```

| Parameter | Type | Required | What it is |
| --- | --- | --- | --- |
| `id` | string | No | Only this watch. |
