Marketing MCP server

Social media research and planning your agent can call

Social Media Analytics exposes five focused MCP tools for public-profile review, hashtag research, 30-day content planning, competitor comparison, and heuristic post scoring. Profile requests attempt a basic public-page HTML fetch and fall back to estimates when a platform blocks or withholds usable data.

5 MCP tools 3 calls free Node.js 18+ MIT licensed

Run with npx View pricing

What it actually does

Five tools with bounded inputs and rules-based outputs

Profiles and competitors

analyze_profile accepts one supported public profile URL. analyze_competitors accepts two to five supported profile URLs or @-prefixed Twitter handles. They report inferred activity, engagement, content themes or strategy, and comparisons against built-in platform data.

Hashtags and calendars

analyze_hashtags returns estimated volume bands, competition, related tags, posting times, and platform guidance. generate_content_calendar builds a rules-based 30-day schedule with captions, formats, times, and hashtags.

Draft scoring

viral_score evaluates supplied text against emotional-trigger, shareability, length, and readability rules. It returns a 0–100 heuristic score, detected factors, suggestions, and platform-specific tips.

Agent-ready examples

Three concrete agent workflows

Workflow 1

Research a hashtag set with analyze_hashtags

Ask an agent to compare estimated popularity and competition, find related tags, and return Twitter and LinkedIn guidance for a candidate set. 

{
  "hashtags": ["#ai", "#startup", "#buildinpublic"],
  "platforms": ["twitter", "linkedin"]
}
Workflow 2 · Pro tool

Draft a 30-day plan with generate_content_calendar

Give an agent a niche, supported platform list, and weekly frequency. The tool returns a template-based calendar, content mix, UTC posting times, captions, and tags. 

{
  "niche": "AI startups",
  "platforms": ["twitter", "linkedin", "instagram"],
  "posts_per_week": 5
}
Workflow 3

Review a draft with viral_score

Have an agent inspect a proposed LinkedIn post before publishing and summarize the rule-based score, detected triggers, shareability factors, and suggested edits. 

{
  "text": "Here are 3 ways to simplify an AI startup content plan:\n\n1. Pick one topic\n2. Choose a format\n3. Set a schedule\n\nWhich step would you start with?",
  "platform": "linkedin"
}

Quick start

Run from npm, then add it to an MCP client

Open your client's config file

  • Claude Desktop ~/Library/Application Support/Claude/claude_desktop_config.json

    Windows: %APPDATA%\Claude\claude_desktop_config.json. In the app: Settings → Developer → Edit Config.

  • Cursor ~/.cursor/mcp.json

    Or .cursor/mcp.json inside a single project.

  • Windsurf ~/.codeium/windsurf/mcp_config.json

    Cascade panel → MCP icon → edit the raw config.

Paste this entry

All three clients accept the same object. If the file already has an mcpServers block, add just the "social-media-analytics" entry inside it.

{
  "mcpServers": {
    "social-media-analytics": {
      "command": "npx",
      "args": ["-y", "social-media-analytics"]
    }
  }
}

No env block is needed to start: the first 3 tool calls total across this server's tools run without a license.

Using Claude Code instead? One command, no file

$ claude mcp add --transport stdio social-media-analytics -- npx -y social-media-analytics

Check it registered with claude mcp list. Add a key later with --env LICENSE_KEY=your-key placed before --transport.

Restart the client, then confirm it loaded

  • Claude Desktop: quit and reopen the app, then look for Social Media Analytics in the tools/plugin menu.
  • Cursor: Settings → Customize → MCP; the server should list its tools.
  • Windsurf: reload Cascade; the server appears under the MCP panel.
  • Claude Code: run claude mcp list and look for ✔ Connected.

Running npx -y social-media-analytics in a terminal looks frozen — that is correct. It is a stdio server: it waits silently for an MCP client on stdin and never returns a prompt. Press Ctrl+C to exit. Use the config above rather than the bare command; your client starts the process for you.

Add your license key when you buy

A key arrives on screen right after checkout. Add it as an environment variable in the same entry:

{
  "mcpServers": {
    "social-media-analytics": {
      "command": "npx",
      "args": ["-y", "social-media-analytics"],
      "env": {
        "LICENSE_KEY": "paste-your-key-here"
      }
    }
  }
}

Keys are verified offline against a public key compiled into the package — no account, no network check, no usage reporting. Lost the key? Recover it here. More detail on the FAQ.

Access and pricing

Try three calls before choosing a plan

Free trial

Without a license key, the package allows three calls total, shared across all five tools—not three per tool, and not three per day. It is a one-off trial with no credit card or signup; the count persists in ~/.aivp-mcp/usage.json when the filesystem is writable, with an in-memory fallback, so restarting does not reset it.

Basic · $10/month

Unlimited, licensed access to analyze_profile, analyze_hashtags, and viral_score. The Pro-only tools generate_content_calendar and analyze_competitors are not included.

Pro · $15/month

Everything in Basic, plus unlimited use of the Pro-only tools generate_content_calendar and analyze_competitors.

Buying a license removes the trial counter and unlocks unlimited, ungated calls to the tools in your plan. Every key is verified fully offline against a public key compiled into the package—no account, no network check, no usage reporting—and stays valid for 365 days.

Compare Social Media Analytics plans

Clear boundaries

Scope and what it does not do

In scope

  • Twitter/X, Instagram, YouTube, LinkedIn, and TikTok inputs.
  • Basic HTML parsing of publicly accessible profile pages.
  • Fallback estimates based on handles and built-in platform data.
  • Rules-based hashtag research, calendars, comparisons, and draft scoring.

It does not

  • Connect social accounts, use OAuth, or access private profile data.
  • Provide guaranteed live or up-to-the-minute platform metrics.
  • Publish, schedule, delete, or monitor posts and campaigns.
  • Predict or guarantee reach, engagement, follower growth, or virality.

Start with three free calls

Add Social Media Analytics to your client, then license it.

Connect the server with no key and spend the shared three-call trial on a real profile or draft. Buy Basic or Pro when you want unlimited, ungated calls to the tools in your plan.

Run with npx View pricing