SocialToAI

SocialToAI MCP server

中文

SocialToAI is an API and MCP server that lets AI tools read publicly visible social media content (posts, comments, profiles and trends) from 18 platforms, including TikTok, Instagram, X (Twitter), Reddit, YouTube, Xiaohongshu (RedNote), Douyin, Weibo. It is billed in prepaid credits, and failed calls are free.

Facts

Connect

This is a hosted remote MCP server: there is nothing to install. Address: https://mcp.socialtoai.com/mcp (Streamable HTTP). In ChatGPT and Claude's apps you paste the address and sign in, with no key; every other client authenticates with an API key. Create a key in the console; it is shown once, when it is created. Wherever a key goes below there is the environment variable SOCIALTOAI_KEY or a placeholder.

Claude Code

Where: Terminal

1. Create a key in the console and export it as SOCIALTOAI_KEY.
2. Run the command in your terminal.
3. Start Claude Code and ask. Type /mcp at any time to see the connection.

export SOCIALTOAI_KEY="<YOUR_API_KEY>"

claude mcp add --transport http socialtoai \
  https://mcp.socialtoai.com/mcp \
  --header "Authorization: Bearer $SOCIALTOAI_KEY"

# check the connection
claude mcp list

Claude app

Where: Customize → Connectors → Add custom connector

1. In Claude on the web or the desktop app, open Customize → Connectors → Add custom connector.
2. Name it SocialToAI, paste the address and add it. Leave the advanced settings empty.
3. Press Connect. Sign in to SocialToAI with the code we email you and press Allow.
4. Switch the connector on in a chat and ask.

• Name: SocialToAI
• Remote MCP server URL: https://mcp.socialtoai.com/mcp

No key to copy: the connection shows up under API keys in the console, named Claude, where you can give it a daily cap or revoke it.

On the free plan Claude allows one custom connector.

ChatGPT

Where: ChatGPT settings → Apps → Create

1. In ChatGPT, turn on developer mode in the settings, then create an app for a custom MCP server.
2. Name it SocialToAI, paste the address, choose OAuth and create it.
3. Sign in to SocialToAI with the code we email you and press Allow.
4. Pick it in a chat and ask.

• Name: SocialToAI
• MCP server URL: https://mcp.socialtoai.com/mcp
• Authentication: OAuth

Developer mode has to be on. Which plans can turn it on is decided by ChatGPT and changes; check your account's settings.

No key to copy: the connection shows up under API keys in the console, named ChatGPT, where you can give it a daily cap or revoke it.

Cursor

Where: ~/.cursor/mcp.json

1. Create a key in the console and set it as the environment variable SOCIALTOAI_KEY.
2. Add the server to ~/.cursor/mcp.json, or to .cursor/mcp.json in one project.
3. Open Cursor's settings, find MCP, and check that socialtoai is listed with its tools. Then ask in the chat.

{
  "mcpServers": {
    "socialtoai": {
      "url": "https://mcp.socialtoai.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:SOCIALTOAI_KEY}"
      }
    }
  }
}

Codex

Where: ~/.codex/config.toml

1. Create a key in the console and export it as SOCIALTOAI_KEY.
2. Add these lines to ~/.codex/config.toml.
3. Start Codex and ask. Codex reads the key from the environment variable; the file never holds it.

[mcp_servers.socialtoai]
url = "https://mcp.socialtoai.com/mcp"
bearer_token_env_var = "SOCIALTOAI_KEY"

Trae

Where: MCP → Add → Configure manually

1. Create a key in the console.
2. In Trae, open the MCP panel, choose to add a server manually and paste the configuration.
3. Replace <YOUR_API_KEY> with your key, confirm, and ask in the chat.

{
  "mcpServers": {
    "socialtoai": {
      "url": "https://mcp.socialtoai.com/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}

Cherry Studio

Where: Settings → MCP Servers → Add

1. Create a key in the console.
2. In Cherry Studio, open Settings → MCP Servers and add a server with these values.
3. Replace <YOUR_API_KEY> with your key, save, switch the server on and ask.

• Name: SocialToAI
• Type: Streamable HTTP
• URL: https://mcp.socialtoai.com/mcp
• Headers: Authorization=Bearer <YOUR_API_KEY>

Dify

Where: Tools → MCP → Add MCP Server (HTTP)

1. Create a key in the console.
2. In Dify, open Tools → MCP, add an HTTP server and fill in these values; the header is under the advanced settings.
3. Replace <YOUR_API_KEY> with your key and save. The tools can then be added to an agent or a workflow.

• Server URL: https://mcp.socialtoai.com/mcp
• Name: SocialToAI
• Server identifier: socialtoai
• Headers: Authorization: Bearer <YOUR_API_KEY>

n8n

Where: MCP Client Tool node

1. Create a key in the console.
2. Add an MCP Client Tool node to an AI Agent and fill in these values.
3. Store your key in the Bearer Auth credential, not in the node, then run the workflow.

• Endpoint: https://mcp.socialtoai.com/mcp
• Server transport: HTTP Streamable
• Authentication: Bearer Auth
• Bearer token: <YOUR_API_KEY>

Tools

The parameters of each tool and the credits of each call are in the documentation. A failed call is not charged.

Recorded examples

Questions that were run on the live system, with the names of ordinary users removed.

What do people complain about with standing desks on Reddit and X?

• Searched Reddit “standing desk”: 7 posts · 2 credits
• Searched X “standing desk”: 11 posts · 2 credits
• Ran Comment analysis on Reddit comments under the 3 most-discussed threads: 173 comments · 84 credits

I searched both, then read 173 comments under the 3 most-discussed Reddit threads. 55 of the 162 that could be judged complain about something; the complaints cluster here:

• Back and neck pain (12%): “Either position for 8 hours solid leaves my back hurting.” (source)
• Forgetting to switch between sitting and standing (11%): “I forget I have it most of the time...” (source)
• Sore feet from standing (8%): “My feet do get tired by the end of the day it’s better than the back pain.” (source)

Replay · recorded 2026-10-18, 3 requests, 88 credits ($0.29)

What home coffee content is taking off on TikTok and YouTube this week?

• Ran Viral finder on TikTok “home coffee”, last 7 days: 59 videos · 36 credits
• Ran Viral finder on YouTube “home coffee”, last 7 days: 57 videos · 24 credits

From 116 videos posted in the last 7 days (109 with a format the analysis could name), 15 took off (3 times the usual or more). The formats that took off most, each with its share of all the videos:

• How-to (24%): “October made me do it. 👻 Marshmallow Iced Latte Ingredients • 1 giant marshmallow” (source)
• Showcase (25%): “Setting up my home coffee bar (for now hehe) ☕️🧸🤎🕯️ what do we think?!” (source)
• Story (20%): “I’ve been drinking mold for months.. PSA ALL AT HOME COFFEE MAKERS!” (source)

Replay · recorded 2026-10-18, 2 requests, 60 credits ($0.2)

What are people on Xiaohongshu saying about camping coffee?

• Ran Brand buzz on Xiaohongshu “露营咖啡”, last 90 days: 13 notes · 36 credits

8 of the 13 posts found are about it: 100% positive, 0% neutral, 0% negative. What they mention most:

• Features (38%): “泰摩手冲套装，户外也能稳定萃取” (source)
• Ease of use (25%): “意外比想象中方便。 撕开直接倒进水或牛奶里，冷水大约3秒就能化开” (source)
• Quality (13%): “亲手萃取的温柔质感 是成年人超治愈的低成本快乐” (source)

Replay · recorded 2026-10-18, 1 request, 36 credits ($0.12)

Links

• Site: https://socialtoai.com/?utm_source=github&utm_medium=repository
• Connect your AI client: https://socialtoai.com/mcp/?utm_source=github&utm_medium=repository
• Pricing: https://socialtoai.com/pricing/?utm_source=github&utm_medium=repository
• Documentation: https://socialtoai.com/docs/?utm_source=github&utm_medium=repository
• Status: https://socialtoai.com/status/?utm_source=github&utm_medium=repository
• Changelog: https://socialtoai.com/changelog/?utm_source=github&utm_medium=repository
• The other repository: https://github.com/socialtoai/socialtoai-skills
• Support: [email protected]