Skip to main content
Glama
deenesjakoruzh
aryaminus

@aryaminus/socials-mcp

by aryaminus
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

Socials Assistant

npm version GitHub Release License: MIT CI Docker

MCP server + agent skills for social media creators. Pull your own TikTok, Instagram, Facebook, and YouTube analytics into a permanent vault, get weekly digests, review scripts, build media kits, and draft brand outreach with real numbers — from any AI agent.

Official APIs only. No scraping. No ToS risk.

Quick start — pick one

1. One prompt (easiest)

Copy the prompt from docs/SETUP-PROMPT.md and paste it into Claude, ChatGPT, Gemini, Codex, Cursor, or any MCP-compatible agent. It asks you one question (cloud or local), then guides you step by step — handing you each link to click, coaching you through platform credentials from the repo's own docs, connecting your agent, and verifying every step before moving on. You stay in control; nothing runs without your go-ahead.

2. Cloud, zero install

Deploy to Cloudflare

Then open https://<your-worker>.workers.dev/setup for the credential checklist. Full journey: docs/GET-STARTED-CLOUD.md.

3. npx

npx @aryaminus/socials-mcp onboard

Installs nothing globally — prints guided setup for platform credentials, then serves MCP on stdio/HTTP.

4. Local from source

git clone https://github.com/aryaminus/socials-assistant && cd socials-assistant
./setup.sh && node apps/mcp/bin/socials-mcp.js onboard

Related MCP server: social-mcp

What you get

20 MCP tools

connect · snapshot · vault query · period compare · top content · audience · digest · media kit · pipeline · outreach log

6 skills

socials-connect · weekly-digest · script-review · publish-package · brand-outreach · media-kit

History vault

platforms expire analytics; your SQLite (local) or D1 (cloud) vault doesn't

TikTok CSV import

retention, traffic sources, search terms — Studio-only data via one command

Draft-first outreach

real numbers from your vault; nothing sends without your approval

Connect your agent

Agent

How

Claude.ai / Desktop

Settings → Connectors → custom connector → paste MCP URL

Claude Code

claude mcp add --transport http socials <URL>

Codex

[mcp_servers.socials] url = "<URL>" + codex mcp login socials

Cursor

Settings → MCP Servers → paste URL

Gemini CLI

mcpServers block in ~/.gemini/settings.json

Everything else

agents/README.md

Docs

Doc

Read when

docs/SETUP-PROMPT.md

you want the one-prompt path

docs/GET-STARTED-CLOUD.md

deploying to Cloudflare

docs/onboarding-google.md / meta / tiktok

creating platform apps for OAuth

docs/CAPABILITIES.md

checking what data each platform exposes

docs/hosting-cloudflare.md

manual cloud deployment details

docs/automation.md

scheduling weekly snapshots + digests

AGENTS.md

env vars, CLI commands, release process

CONTRIBUTING.md

developing on this repo

Security

Tokens encrypted at rest (AES-256-GCM) · official APIs only · vault local by default · outreach never auto-sends. Details: SECURITY.md.

MIT © 2026 aryaminus

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityStale
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • socialgpt-mcp

    scrollmark
    A
    license
    Not graded
    quality
    C
    maintenance
    Brings social media analytics and content intelligence into any MCP-compatible AI agent, enabling analysis of your own videos, competitor research, and creator discovery via a hosted OAuth-authenticated server.
    10
    MIT

  • social-mcp

    nilaydatta1234
    A
    license
    A
    quality
    C
    maintenance
    Gives LLM agents read-only access to YouTube and Instagram analytics, returning engagement rates, performance versus a channel's median, outlier detection, and Shorts/Reels versus long-form splits for channels, videos, comments, posts, and hashtags. It also provides a prompt that audits a channel and proposes data-backed video ideas, with quota-aware caching and actionable error messages.
    8
    MIT

  • ViralScout MCP

    TYKAIRO-AI
    F
    license
    B
    quality
    B
    maintenance
    Enables creators to analyze supplied short-form video transcripts and metadata into structured hook, retention, remix, script, content-gap, and creator-pack outputs without API keys or paid external services.
    8
    -

  • bamf-mcp

    houstongolden
    A
    license
    Not graded
    quality
    C
    maintenance
    Enables AI agents to create, schedule, and analyze LinkedIn and X content, manage ideas, media, and a creator knowledge vault, and run approval-gated outreach campaigns through a hosted MCP endpoint.
    MIT