Skip to main content
MCP Server

Your social workspace
in any AI assistant.

The SocialScale MCP server exposes your entire social media operation as a set of tools, live data resources, and guided prompt templates — callable from Claude Desktop, Cursor, or any MCP-compatible client.

22
Tools
12
Resources
8
Prompt templates
v1
Protocol version
Claude Desktop Official
Cursor Supported
Cline Supported
Continue Supported
Zed Supported
Any MCP client Protocol

Quick setup

Two steps to connect any MCP client to your SocialScale instance.

1 Start the server

Terminal
$ socialscale mcp serve

✓ MCP server listening on stdio

✓ 22 tools · 12 resources · 8 prompts ready

Communicates over stdio — no port binding needed. Connect your MCP client using the JSON config on the right.

2 Configure your client

claude_desktop_config.json JSON 
{
  "mcpServers": {
    "socialscale": {
      "command": "socialscale",
      "args": ["mcp", "serve"]
    }
  }
}

Config location: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows). Restart the client after saving.

Self-hosted: The MCP server reads your local SocialScale database at ~/.config/socialscale/db.sqlite. Your data never touches external servers — the AI client calls tools over stdio, the tool reads your local DB, and returns results.

22 Tools

Full reference for every tool the server exposes. All tool names are prefixed socialscale_.

✦ Content
5 tools
socialscale_draft_create
content*platforms* scheduled_for?

Create a new content draft for one or more platforms.

socialscale_draft_list
status?limit?

List drafts, filtered by status (draft/reviewed/approved/scheduled/published/failed).

socialscale_draft_review
draft_id*

Retrieve full draft content and metadata for AI review.

socialscale_draft_approve
draft_id*

Approve a draft, moving it to "approved" status.

socialscale_calendar_view
range?

View the content calendar (today / week / month).

◎ Inbox
3 tools
socialscale_inbox_list
status?limit?

List inbox threads across all platforms (open/pending/resolved).

socialscale_inbox_suggest_reply
thread_id*

Get thread content and context for AI-powered reply suggestions.

socialscale_inbox_triage
limit?

List uncategorised threads for AI triage and classification.

◈ Analytics
3 tools
socialscale_analytics_overview
range?

Performance overview: posts, drafts, inbox threads, active campaigns.

socialscale_analytics_content
limit?

List recently published posts for content performance analysis.

socialscale_analytics_genome
platform?

Content genome: which hooks, formats, and timings drive performance.

⬡ Trends
3 tools
socialscale_trends_today
limit?

Today's trend digest: top trending topics and content opportunities.

socialscale_trends_research
topic*

Research a specific topic for content opportunities and angles.

socialscale_plan_generate
count?platforms?

Generate a content plan for the next N days based on trends and brand strategy.

◆ Ads
3 tools
socialscale_ads_create
goal*budget_daily_usd* platform?audience_description?

Create a new ad campaign with AI-generated strategy.

socialscale_ads_optimize
policy?

Run the AI budget optimisation engine across all active campaigns.

socialscale_ads_report
range?

Get an ad performance report (spend, ROAS, CPA, impressions).

⊞ Experiments
3 tools
socialscale_experiment_create
name*variant_draft_ids* metric?hypothesis?

Create an A/B test experiment from two or more content drafts.

socialscale_experiment_list
status?

List all experiments with status, metric, and current winner.

socialscale_learnings_list
type?

List learnings extracted from concluded experiments.

⊕ System
2 tools
socialscale_agents_status

Get live status of all 10 autonomous agents in the fleet.

socialscale_connected_accounts

List all connected social media accounts with connection status.

* required  ·  ? optional

12 Resources

Resources are live data your AI client can subscribe to and read. All URIs use the socialscale:// scheme.

URI MIME Description
socialscale://calendar/week text/plain This week's scheduled and draft posts across all platforms.
socialscale://calendar/month text/plain This month's content schedule.
socialscale://inbox/open text/plain All open inbox threads requiring attention.
socialscale://inbox/pending text/plain Inbox threads awaiting reply.
socialscale://analytics/overview/7d application/json Key performance metrics for the last 7 days.
socialscale://analytics/overview/30d application/json Key performance metrics for the last 30 days.
socialscale://trends/today text/plain Top trending topics and content opportunities detected today.
socialscale://brand/voice text/plain Brand tone, style guidelines, and voice characteristics.
socialscale://agents/status application/json Current status and task counts for all autonomous agents.
socialscale://policies/active text/plain Currently active content and safety governance policies.
socialscale://experiments/learnings text/plain Insights from all concluded A/B experiments.
socialscale://accounts/connected application/json All connected social media accounts and their status.

8 Prompt Templates

Pre-built prompt templates that guide your AI assistant through complex social media workflows. Invoke with mcp_prompt in any MCP client.

create-post topic*, platform?, tone?

Guided post creation with platform-optimised content and hook variants.

analyze-content range?, focus_area?

Performance analysis with strategic recommendations and 30-day plan.

trend-brief industry*, timeframe?

Trend research brief with content opportunities and publishing roadmap.

campaign-plan objective*, budget?, audience?

Full ad campaign plan: architecture, targeting, creative, and budget split.

weekly-report range?, focus?

Weekly performance report covering organic, paid, inbox, and experiments.

reply-draft thread_id*, tone?

Three reply options (formal / friendly / brief) for an inbox thread.

content-audit platform?

Full content strategy audit with gap analysis and immediate action items.

experiment-brief what_to_test*, hypothesis?

Rigorous A/B experiment design with control/variant, sample size, and success metric.

Example: invoke a prompt in Claude Desktop

// Claude Desktop — use the / command to pick a prompt
/socialscale:weekly-report
  range: "last 7 days"
  focus: "ad performance"

// Or call the tool directly in chat:
"Use the weekly-report prompt with range=30d and focus=engagement"

Example workflows

Real chains of tools working together in Claude Desktop.

Create a content calendar from trends
  1. 1
    socialscale_trends_today — fetch today's trend signals
  2. 2
    socialscale_plan_generate — build a 7-post plan from top trends
  3. 3
    socialscale_draft_create — create drafts for each planned post
  4. 4
    socialscale_calendar_view — review the full week calendar
Weekly review & ad optimisation
  1. 1
    socialscale_analytics_overview — pull the last 7-day overview
  2. 2
    socialscale_analytics_genome — identify best hooks and formats
  3. 3
    socialscale_ads_report — get ad performance summary
  4. 4
    socialscale_ads_optimize — rebalance budgets with policy=moderate
  5. 5
    weekly-report prompt — generate the executive summary
Inbox triage + AI reply drafting
  1. 1
    socialscale_inbox_triage — list uncategorised threads
  2. 2
    socialscale_inbox_list — filter open threads by priority
  3. 3
    socialscale_inbox_suggest_reply — get context for the top thread
  4. 4
    reply-draft prompt — generate 3 tone-matched reply options
  5. 5
    socialscale_draft_create — save the chosen reply as a draft

Ready to connect?

Install SocialScale, run socialscale mcp serve, and connect your AI assistant in under two minutes.

Install the CLI → Plugin SDK →