---
title: "Social Media MCP Server: Read 18 Platforms · SocialToAI"
canonical: https://socialtoai.app/mcp/
updated: 2026-11-20
---

# Social Media MCP Server

> The public REST API and MCP are not yet available on socialtoai.app. The signed-in console supports Xiaohongshu comment reports.

SocialToAI is a hosted MCP server for social media data: add one address to your AI client and it can read publicly visible posts, comments, profiles and trends on 18 platforms. There is nothing to install and no platform account or cookie to provide. The server lists 18 tools; most calls cost 2 credits, and failed calls are free. A client that can sign in signs in; a tool that only takes a header sends an API key.

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

## Connect SocialToAI

Address: `https://socialtoai.app/mcp`

Add an MCP server in your AI and enter this address. If a sign-in page opens, sign in with your email and press Allow. If your tool asks for a key instead, copy one from the console and put it in a header: `Authorization: Bearer <YOUR_API_KEY>`. [Get a key](https://socialtoai.app/console/keys/)

In a terminal: run a command, then sign in: 

Claude Code: 

```
claude mcp add --transport http socialtoai https://socialtoai.app/mcp
```

Then in Claude Code type /mcp, pick socialtoai and sign in.

Codex: 

```
codex mcp add socialtoai --url https://socialtoai.app/mcp
```

Then sign in in the browser that opens.

Writing code? Call the API with a key: see [the API docs](https://socialtoai.app/docs.md).

## Step-by-step for your client

The same address everywhere. Each client has a page: where to enter it, how it signs in, and what to ask first.

- [Claude Code](https://socialtoai.app/connect/claude-code.md): Run a command, then sign in
- [Claude app](https://socialtoai.app/connect/claude.md): Paste the address, then sign in
- [ChatGPT](https://socialtoai.app/connect/chatgpt.md): Paste the address, then sign in
- [Cursor](https://socialtoai.app/connect/cursor.md): Add the address, then sign in
- [Codex](https://socialtoai.app/connect/codex.md): Run a command, then sign in
- [Trae](https://socialtoai.app/connect/trae.md): A few lines of settings and a key
- [Cherry Studio](https://socialtoai.app/connect/cherry-studio.md): The address and a key in a form
- [Dify](https://socialtoai.app/connect/dify.md): The address and a key in a form
- [n8n](https://socialtoai.app/connect/n8n.md): The address and a key in a form

## Server

- MCP (Streamable HTTP): `https://socialtoai.app/mcp`
- Transport: Streamable HTTP
- Sign-in: Sign in (OAuth) where the client can; otherwise an API key in a header
- Tools: 18
- Platforms: 18
- Ad libraries: 2

## Tools (18)

| Tool | What it does | Per call |
| --- | --- | --- |
| [`search`](https://socialtoai.app/docs/mcp/tools.md#tool-search) | Find posts or accounts by keyword | 2–12 credits |
| [`trending`](https://socialtoai.app/docs/mcp/tools.md#tool-trending) | What is hot right now | 2–12 credits |
| [`detail`](https://socialtoai.app/docs/mcp/tools.md#tool-detail) | One post: text and numbers | 1–12 credits |
| [`comments`](https://socialtoai.app/docs/mcp/tools.md#tool-comments) | Comments under a post | 2–12 credits |
| [`user_profile`](https://socialtoai.app/docs/mcp/tools.md#tool-user_profile) | One account: bio and counts | 1–12 credits |
| [`user_posts`](https://socialtoai.app/docs/mcp/tools.md#tool-user_posts) | Posts from one account | 2–12 credits |
| [`find`](https://socialtoai.app/docs/mcp/tools.md#tool-find) | Describe a task or paste a link. Returns the right call, filled in, with its price. | free |
| [`call`](https://socialtoai.app/docs/mcp/tools.md#tool-call) | Runs a platform-specific interface that find suggests. | by operation |
| [`capabilities`](https://socialtoai.app/docs/mcp/tools.md#tool-capabilities) | What each platform supports and what each call costs. | free |
| [`brand_buzz`](https://socialtoai.app/docs/mcp/tools.md#tool-brand_buzz) | 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. | quoted before it runs |
| [`comment_insights`](https://socialtoai.app/docs/mcp/tools.md#tool-comment_insights) | 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. | quoted before it runs |
| [`find_creators`](https://socialtoai.app/docs/mcp/tools.md#tool-find_creators) | Creators on one platform for a niche: their size, their recent posts, and how well each fits what you asked for, with the reasons. | quoted before it runs |
| [`account_watch`](https://socialtoai.app/docs/mcp/tools.md#tool-account_watch) | What a set of accounts published lately and which posts did clearly better than each account's usual. It runs once. | quoted before it runs |
| [`creator_card`](https://socialtoai.app/docs/mcp/tools.md#tool-creator_card) | 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. | quoted before it runs |
| [`research`](https://socialtoai.app/docs/mcp/tools.md#tool-research) | Runs the ready-made tools that have no tool of their own, such as Bulk link data and Viral finder. | quoted before it runs |
| [`watch`](https://socialtoai.app/docs/mcp/tools.md#tool-watch) | Watches a search or a tool every day or week: a preview with the price first, then only what is new, by email too. | free |
| [`watch_news`](https://socialtoai.app/docs/mcp/tools.md#tool-watch_news) | What your watches found since you last asked. | free |
| [`account`](https://socialtoai.app/docs/mcp/tools.md#tool-account) | Balance, today's spend and limit. | free |

[Each tool's description and parameters](https://socialtoai.app/docs/mcp/tools.md)

- [Brand buzz](https://socialtoai.app/tools/brand-buzz.md)
- [Comment analysis](https://socialtoai.app/tools/comment-insights.md)
- [Account snapshot](https://socialtoai.app/tools/account-watch.md)
- [Find creators](https://socialtoai.app/tools/find-creators.md)
- [Creator profile](https://socialtoai.app/tools/creator-card.md)
- [Bulk link data](https://socialtoai.app/tools/batch-stats.md)
- [Viral finder](https://socialtoai.app/tools/viral-finder.md)

## FAQ

**Which AI clients work?**

Any client that can add a remote MCP server over HTTP, and every one takes the same address. A client that can sign in opens our sign-in page: sign in with the code we email you and press Allow. New here? Signing in creates your account. A tool that only takes a header, or a server nobody signs in on, sends an API key in it.

**Does my AI see my key?**

The client holds the key, or the token a sign-in gave it, and sends it with each request; it is not part of what the model is given, and no answer of ours repeats it. We store only hashes and never write them to a log.

**What does a question cost?**

A question is as many calls as your AI decides to make. Most calls cost 2 credits (range 1–102), and every answer states the credits charged and your balance, so your AI can tell you what it spent.

**What happens when a call fails?**

It costs nothing. The answer says why and what to change, so your AI can correct the call by itself. When a result is uncertain we do not retry on our own.

**Are there rate limits?**

5 call a second per key, and 20 a second after the first purchase. Going over is answered with a wait time and is not charged.
