Skip to main content
Glama
deenesjakoruzh
aryaminus

@aryaminus/socials-mcp

by aryaminus
OverviewSchemaRelated ServersScoreDiscussions
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 deploys the server, connects it to your agent, installs the 6 skills, walks you through platform OAuth, and runs your first digest. You click consent screens; the agent does the rest.

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: creatordb-mcp-server

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 installed

A
license - permissive license
Not graded
quality - not tested
A
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
0dRelease cycle
8Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • roc-mcp-server

    sugar-co-dev
    A
    license
    Not graded
    quality
    C
    maintenance
    Creator commerce intelligence for TikTok Shop brands. GMV benchmarks, ROC calculations, ideal creator profiles, content formats, and commission guidance powered by $30M+ in real transaction data.
    13
    1
    MIT
  • creatordb-mcp-server by CreatorDB

    creatordb-mcp-serverofficial

    CreatorDB
    A
    license
    A
    quality
    B
    maintenance
    Exposes the CreatorDB V3 API as 42 tools for creator search, profile data, sponsor intelligence, and content search across YouTube, Instagram, and TikTok.
    42
    183
    2
    MIT
  • Influship MCP by Influship

    Influship MCPofficial

    Influship
    A
    license
    A
    quality
    B
    maintenance
    Enables AI-native creator discovery for influencer marketing, including creator search, lookalikes, profile lookup, and Instagram post transcript analysis.
    14
    66
    1
    MIT

View all related MCP servers

Related MCP Connectors

  • CreatorDB

    Creator discovery & analytics across YouTube, Instagram, TikTok (30M+) + brand/sponsor intel.

  • Influship

    Find and analyze influencers with creator search, lookalikes, profiles, posts, and transcripts.

  • TokPortal

    Managed TikTok/Instagram/YouTube accounts + video posting at scale, operated by human managers.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/aryaminus/socials-assistant'

If you have feedback or need assistance with the MCP directory API, please join our Discord server