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.
These are the tools an AI client sees once it is connected to the SocialToAI social media MCP server. 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.
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.
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
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
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
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
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 explains both.
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, zhihuWith type=user: douyin, instagram 3, kuaishou 12, tiktok, wechat 12, wechat_channels 36, weibo, x 5, xiaohongshu 12, youtube, zhihuWith sort=latest: xWith type=image: xiaohongshu 12since/until: ISO dates, all platforms.More parameters: capabilities. On error, follow error.fix. Tell the user billing.display.
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.
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, zhihuWith type=videos: bilibili, douyinWith type=trends: redditMore 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.
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, zhihuGive url: facebook, wechat 12Give id|url|export_id: wechat_channels 12With type=article|pin|question: zhihuAdd include=transcript, charged on top: instagram, linkedin, reddit, tiktok, x, youtubeMore 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.
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, zhihuGive id|url: douyin, instagram, kuaishou, reddit, tiktok, weibo, xiaohongshu 12, youtubeGive url: wechat 12With reply_of: bilibili, douyin, instagram, kuaishou, tiktok, wechat 12, wechat_channels 9, weibo, xiaohongshu 12, youtube, zhihuMore 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.
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, weiboGive id|url: douyin, xiaohongshu 12Give id|username|url: facebookGive username: instagram, reddit, telegram, threads, zhihuGive username|url: linkedinGive id|username: tiktok, x 1, youtubeMany 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.
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, weiboGive id|url: douyin, xiaohongshu 12Give id|username|url: facebookGive username: instagram, reddit, telegram, threads, tiktok, x, zhihuGive username|url: linkedinGive id|username: youtubeWith type=answer|pin: zhihuMore 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 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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.