SocialToAIStart freeConsole

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.

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.

What these tools read on one platform: TikTok MCP, Instagram MCP, X (Twitter) MCP, Reddit MCP, YouTube MCP, Facebook MCP, LinkedIn MCP, Threads MCP, Telegram MCP, Pinterest MCP, Xiaohongshu (RedNote) MCP, Douyin MCP, Weibo MCP, WeChat Articles MCP, Bilibili MCP, Zhihu MCP, Kuaishou MCP, WeChat Channels MCP.

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.

Tools

ToolWhat it doesCredits per call
searchFind posts or accounts by keyword2–12 credits
trendingWhat is hot right now2–12 credits
detailOne post: text and numbers1–12 credits
commentsComments under a post2–12 credits
user_profileOne account: bio and counts1–12 credits
user_postsPosts from one account2–12 credits
findFind 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 jobFree
callCall one platform-specific capability by its op ("platform.name"): what the six actions do not coverBy what it runs
capabilitiesWhat can be called nowFree
accountWhose key or app this is: plan, balance, today's spend and limitsFree
brand_buzzWhat 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 linkBy what it runs
comment_insightsWhat 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 quotedBy what it runs
find_creatorsCreators on one platform for a niche: their size, their recent posts, and how well each fits what you asked for, with the reasonsBy what it runs
account_watchWhat a set of accounts published lately and which posts did clearly better than each account's usualBy what it runs
creator_cardOne creator across platforms: the accounts found for the same person, with followers, posts, engagement and how strong the evidence is that each is theirsBy what it runs
researchRun one of these by nameBy what it runs
watchDaily watch: a search, action, op or tool we run again every day or weekFree
watch_newsWhat the user's watches found that they have not been shown yet, newest first, with each watch, its time and statusFree

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.

Each tool

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, 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.
ParameterTypeRequiredWhat it is
platformstring | arrayYesOne, or a list.
querystringNoSearch terms
sortstringNoOnly 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
sincestringNoPublished 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.
untilstringNoPublished 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_withinstringNoOnly douyin, kuaishou, linkedin, reddit, tiktok, wechat, wechat_channels, xiaohongshu, youtube. By platform: day, week, half_year, month, year
typestringNoOnly douyin, instagram, kuaishou, tiktok, wechat, wechat_channels, weibo, x, xiaohongshu, youtube, zhihu. By platform: article, video, image, answer, user
cursorstringNopage.cursor of the last answer, other arguments unchanged.
max_cost_creditsintegerNoRefused, free, if the call would cost more.
handlestringNoA handle an earlier answer gave, or the request_id of an earlier call: reads that result again, free. Nothing else is run.
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, zhihuWith type=videos: bilibili, douyinWith type=trends: redditMore parameters: capabilities. On error, follow error.fix. Tell the user billing.display.
ParameterTypeRequiredWhat it is
platformstring | arrayYesOne, or a list.
boardstringNoOnly 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
typestringNoOnly bilibili, douyin, reddit. By platform: videos, trends
regionstringNoOnly 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
cursorstringNopage.cursor of the last answer, other arguments unchanged.
max_cost_creditsintegerNoRefused, free, if the call would cost more.
handlestringNoA handle an earlier answer gave, or the request_id of an earlier call: reads that result again, free. Nothing else is run.
limitintegerNoHow 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.

detail1–12 creditsread-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, 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.
ParameterTypeRequiredWhat it is
platformstring | arrayYesOne, or a list.
idstring | arrayNoVideo ID, a string of digits
urlstring | arrayNoLink 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
langstringNoOnly tiktok, youtube
export_idstring | arrayNoThe 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
typestringNoOnly zhihu. By platform: article, pin, question
includestring | arrayNoFetched beside each result: transcript.
max_cost_creditsintegerNoRefused, free, if the call would cost more.
handlestringNoA handle an earlier answer gave, or the request_id of an earlier call: reads that result again, free. Nothing else is run.

comments2–12 creditsread-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, 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.
ParameterTypeRequiredWhat it is
platformstring | arrayYesOne, or a list.
idstring | arrayNoVideo ID, a string of digits
sortstringNoOnly bilibili, reddit, xiaohongshu, youtube. By platform: popular, latest, best
reply_ofstring | arrayNo
urlstring | arrayNoLink 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
cursorstringNopage.cursor of the last answer, other arguments unchanged.
max_cost_creditsintegerNoRefused, free, if the call would cost more.
handlestringNoA handle an earlier answer gave, or the request_id of an earlier call: reads that result again, free. Nothing else is run.
limitintegerNoHow 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_profile1–12 creditsread-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, 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.
ParameterTypeRequiredWhat it is
platformstring | arrayYesOne, or a list.
idstringNoTikTok user ID, a string of digits
urlstringNoLink to the page, written facebook.com/handle
usernamestringNoTikTok handle, without the @
max_cost_creditsintegerNoRefused, free, if the call would cost more.
handlestringNoA handle an earlier answer gave, or the request_id of an earlier call: reads that result again, free. Nothing else is run.

user_posts2–12 creditsread-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, 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.
ParameterTypeRequiredWhat it is
platformstring | arrayYesOne, or a list.
idstringNoChannel ID, starting with UC
urlstringNoLink to the page, written facebook.com/handle
usernamestringNoTikTok handle, without the @
typestringNoOnly instagram, youtube, zhihu. By platform: all, reel, video, short, answer, pin
sortstringNoOnly tiktok, youtube. By platform: latest, popular
tabstringNoOnly wechat, x. By platform: articles, videos, images, posts, replies, media
cursorstringNopage.cursor of the last answer, other arguments unchanged.
max_cost_creditsintegerNoRefused, free, if the call would cost more.
handlestringNoA handle an earlier answer gave, or the request_id of an earlier call: reads that result again, free. Nothing else is run.

findFreeread-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.
ParameterTypeRequiredWhat it is
querystringYesWhat it should do, in 1 to 500 characters.
platformstringNoOnly this platform.
limitintegerNoHow many, 1 to 50; 5 unless given.

callBy what it runsread-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/
ParameterTypeRequiredWhat it is
opstringYesAs find and capabilities give it, like douyin.account_audience.
paramsobjectNoThe op's own parameters, by name.
cursorstringNopage.cursor of the last answer, other arguments unchanged.
max_cost_creditsintegerNoRefused, free, if the call would cost more.
handlestringNoA handle an earlier answer gave, or the request_id of an earlier call: reads that result again, free. Nothing else is run.

capabilitiesFreeread-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.
ParameterTypeRequiredWhat it is
platformstringNoThis platform's calls.

accountFreeread-only

The description your AI is given
Whose key or app this is: plan, balance, today's spend and limits. Free. Scripts: for_scripts.
ParameterTypeRequiredWhat it is

brand_buzzBy what it runsread-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.
ParameterTypeRequiredWhat it is
brandstringYesThe brand, product or topic by its name.
aboutstringNoWhat it is, in a sentence: keeps out other things of the same name.
compare_witharrayNoUp to 2 competitors. Each is read by the same plan and priced on its own.
platformsarrayNo1 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.
windowstringNoHow far back to read. One of 7d, 30d, 90d.
scalestringNosmall 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_creditsintegerNoRefused, free, with the quote, if the run would cost more.
confirmbooleanNotrue: 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.
handlestringNoA handle an earlier answer gave, or the request_id of an earlier call: reads that result again, free. Nothing else is run.

comment_insightsBy what it runsread-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.
ParameterTypeRequiredWhat it is
targetsarrayYes1 to 20 links to posts; they may be of different platforms.
focusstringNoWhat you want to know, in a sentence: adds the comments that speak to it.
topicsarrayNoYour own topics, up to 10: the step that finds topics is then left out.
scalestringNoThe 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_creditsintegerNoRefused, free, with the quote, if the run would cost more.
confirmbooleanNotrue: 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.
handlestringNoA handle an earlier answer gave, or the request_id of an earlier call: reads that result again, free. Nothing else is run.

find_creatorsBy what it runsread-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.
ParameterTypeRequiredWhat it is
querystringYesThe niche, as keywords.
platformstringYesOne platform.
followers_minintegerNoThe fewest followers a creator may have.
followers_maxintegerNoThe most followers a creator may have.
briefstringNoWho you are looking for, in a sentence: what each creator is judged against.
scalestringNoCreators whose profile and posts are fetched: small 20, medium 50, large 100.
max_cost_creditsintegerNoRefused, free, with the quote, if the run would cost more.
confirmbooleanNotrue: 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.
handlestringNoA handle an earlier answer gave, or the request_id of an earlier call: reads that result again, free. Nothing else is run.

account_watchBy what it runsread-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.
ParameterTypeRequiredWhat it is
accountsarrayYes1 to 20 links to account pages; they may be of different platforms.
windowstringNoHow far back to look for new posts. One of 7d, 30d.
scalestringNoPer account: small about 20 posts, medium about 60, large as medium and the comments of 2 posts that took off.
max_cost_creditsintegerNoRefused, free, with the quote, if the run would cost more.
confirmbooleanNotrue: 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.
handlestringNoA handle an earlier answer gave, or the request_id of an earlier call: reads that result again, free. Nothing else is run.

creator_cardBy what it runsread-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.
ParameterTypeRequiredWhat it is
creatorstringYesA link to the creator's page.
platformsarrayNoThe 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.
scalestringNomedium 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_creditsintegerNoRefused, free, with the quote, if the run would cost more.
confirmbooleanNotrue: 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.
handlestringNoA handle an earlier answer gave, or the request_id of an earlier call: reads that result again, free. Nothing else is run.

researchBy what it runsread-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/
ParameterTypeRequiredWhat it is
toolstringYesOne of batch_stats, viral_finder.
inputsobjectYesThat tool's inputs, by name.
handlestringNoA handle an earlier answer gave, or the request_id of an earlier call: reads that result again, free. Nothing else is run.

watchFree

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.
ParameterTypeRequiredWhat it is
actionstringYes
runstringNoWhat runs each time: a tool (brand_buzz), an action (search) or an op.
inputsobjectNoIts inputs, as that tool takes them.
namestringNoA short name, in the user's words.
everystringNoday unless given.
timestringNoHH:MM, 09:00 unless given.
timezonestringNoThe user's IANA time zone.
deliverystringNoemail, webhook, both (email unless given), or the user's group bot webhook URL (Feishu/Lark, WeCom, Slack) to post new items to that chat.
tokenstringNoThe preview's, to confirm it.
idstringNoThe watch's (from list), for pause, resume, delete, rotate_feed or revoke_feed.

watch_newsFreeread-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.
ParameterTypeRequiredWhat it is
idstringNoOnly this watch.

Last updated: