Live Β· Model Context Protocol v1.0 Β· mcp.viraldm.app

Connect any AI agent
to your social automation

ViralDM's MCP server lets Claude, Gemini Spark, Cursor AI, and any MCP-compatible client directly use 25 social media tools β€” schedule posts, generate captions, run auto-DM sequences β€” without ever leaving the chat.

Get Started in 5 min β†’ View Live Server JSON
25
Tools available
OAuth 2
Auth standard
4
Platforms
∞
AI agents

What is MCP?

Model Context Protocol is an open standard (created by Anthropic, adopted by Google, OpenAI, Microsoft) that lets AI agents securely call external tools. Think of it as USB-C for AI β€” one protocol, every agent compatible.

πŸ”Œ

For Users

Tell Claude "schedule my Instagram post for tomorrow at 6 PM" β€” it directly calls ViralDM. No copy-paste. No app switching. Your AI assistant becomes your social media manager.

βš™οΈ

For Developers

One integration covers Claude Desktop, Gemini Spark, Cursor, Microsoft Copilot, and dozens more. Build once, distribute via every AI marketplace simultaneously.

πŸ›‘οΈ

For Businesses

OAuth 2.0 with PKCE, dynamic client registration, scoped permissions, audit logs. Enterprise-grade security baked in. Users explicitly approve every agent before granting access.

πŸš€

For ViralDM Users

Every paid plan includes MCP access at no extra cost. Use your existing API key, or connect via OAuth from Claude/Gemini in 30 seconds.

How it works

The full flow from "Hey Claude…" to your Instagram post being scheduled, in 4 steps.

1
πŸ’¬
You ask
"Schedule a fitness post tomorrow 6 PM on Instagram"
β†’
2
πŸ€–
AI decides
Claude reads tool descriptions, picks schedule_post
β†’
3
πŸ”
MCP secured
OAuth token authorizes the call to ViralDM API
β†’
4
βœ…
Done
Post scheduled. Telegram alert sent. AI confirms.

Quick start

Choose your AI agent β€” each takes under 5 minutes to set up.

1Open Claude Desktop config file

Location depends on your OS:

Windows Β· PowerShell
notepad "$env:APPDATA\Claude\claude_desktop_config.json"
macOS Β· Terminal
open "~/Library/Application Support/Claude/claude_desktop_config.json"
2Paste this config
claude_desktop_config.json
{
  "mcpServers": {
    "viraldm": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.viraldm.app/mcp"
      ]
    }
  }
}
3Restart Claude + authorize

1. Completely quit Claude Desktop (system tray β†’ Quit)
2. Reopen β€” a browser window will pop up automatically
3. Log in to ViralDM, click "Allow access" on the consent screen
4. Done β€” 25 tools are now available in Claude πŸŽ‰

1Open Cursor settings

Cursor β†’ Settings β†’ Features β†’ Model Context Protocol β†’ Add Server

2Add ViralDM server
Cursor MCP config
// Name:  ViralDM
// URL:   https://mcp.viraldm.app/mcp
// Auth:  OAuth 2.0 (Cursor will prompt to log in)

First time you use a ViralDM tool, Cursor opens a browser tab β€” log in and authorize. After that, all 25 tools available in Cursor's AI chat.

1Get your ViralDM API key

Visit viraldm.app/dashboard/api-keys β†’ click Generate new key. You'll get a key like vdm_abc123…

2Open any n8n workflow

In your n8n editor (self-hosted or n8n.cloud), open a workflow and add an "AI Agent" node (from the LangChain category).

3Add ViralDM as an MCP tool

Inside the AI Agent node β†’ Tools tab β†’ + Add Tool β†’ choose "MCP Client Tool":

n8n MCP Client Tool config
// Inside the MCP Client Tool node:
SSE Endpoint:  https://mcp.viraldm.app/mcp
Server Name:   viraldm
Transport:     HTTP Streaming

// Authentication header:
Header Name:   Authorization
Header Value:  Bearer vdm_YOUR_KEY_HERE
4Use ViralDM in any workflow

All 25 ViralDM tools instantly become available to your n8n AI agent. Example workflow ideas:

β€’ Daily content cron β†’ AI agent generates Monday-Sunday calendar at 9 AM IST
β€’ Webhook trigger β†’ form submission auto-sends personalized DM
β€’ Email node β†’ new sale β†’ tag subscriber as VIP in ViralDM
β€’ Slack node β†’ daily digest of top DM conversations
β€’ Cron + AI β†’ every 4 hours, check best posting time, schedule a reel
β€’ Manual trigger β†’ bulk-broadcast to all VIP tag subscribers

1Install Gemini CLI
Terminal
npm install -g @google/generative-ai-cli
2Get your API key

Visit viraldm.app/dashboard/api-keys and generate a new key.

3Configure Gemini

Edit ~/.gemini/settings.json:

~/.gemini/settings.json
{
  "mcpServers": {
    "viraldm": {
      "httpUrl": "https://mcp.viraldm.app/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_VIRALDM_API_KEY"
      }
    }
  }
}
1Discover available tools (no auth)
GET /
curl https://mcp.viraldm.app/
2List MCP tools
POST /mcp Β· method: tools/list
curl -X POST https://mcp.viraldm.app/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'
3Call a tool
POST /mcp Β· tools/call schedule_post
curl -X POST https://mcp.viraldm.app/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "schedule_post",
      "arguments": {
        "platform": "instagram",
        "content": "Hello from MCP!",
        "scheduled_time": "2026-06-01T18:00:00+05:30"
      }
    }
  }'

All 25 tools

Every ViralDM feature is exposed via MCP, organized by category. AI agents read these descriptions to decide which tool to call.

πŸ“…

Posting & scheduling

Schedule, list, and manage social media posts
schedule_post
Schedule a post on Instagram, Twitter, LinkedIn, or Facebook
get_scheduled_posts
List all upcoming scheduled posts across platforms
delete_scheduled_post
Cancel a scheduled post before it goes live
get_best_posting_time
AI-recommended best times to post for max engagement
✨

AI content generation

Captions, calendars, and content safety
generate_content
AI captions with hashtags, tone-aware, English / Hindi / Hinglish
generate_content_calendar
Full weekly or monthly content calendar with post ideas
humanize_text
Run text through humanizer to bypass Meta spam detection
check_content_safety
Pre-check content for Meta policy violations before posting
πŸ’¬

DM automation

Auto-DMs, sequences, broadcasts, templates
setup_auto_dm
Trigger DMs on new follower, comment keyword, story reply, or post like
manage_sequences
Create, list, update, or delete drip-campaign DM sequences
send_broadcast
Mass DM to all subscribers or a tagged segment
manage_dm_templates
CRUD reusable DM templates with categories
πŸ‘₯

Subscribers & tags

Manage your Instagram audience
list_subscribers
List, search, and filter subscribers by tag or engagement
tag_subscribers
Add or remove tags from subscribers (single or bulk)
πŸ“ˆ

Growth & revenue

Analytics, A/B tests, coupons, attribution
get_analytics
Engagement, reach, followers, impressions across platforms
manage_coupons
Create and distribute discount codes via DM
manage_ab_test
Run A/B tests on DM responses and captions
get_revenue_stats
Revenue attribution per automation + conversion rates
get_affiliate_stats
Your affiliate referrals, commissions, and click stats
run_profile_audit
AI-powered profile audit with health score + suggestions
πŸ”—

Integrations & webhooks

Connect to Notion, Sheets, Airtable, Slack, n8n, and more
list_social_accounts
List connected Instagram, Facebook, YouTube accounts
manage_webhooks
CRUD outgoing webhooks for n8n, Make, custom apps
list_integrations
List 10+ available 3rd-party integrations
send_to_integration
Push data to any connected integration
βš™οΈ

Account & billing

Plan info, usage, subscription
get_subscription_info
Current plan, usage stats, billing info, limits

Example conversations

Real prompts you can use today in Claude, Gemini, or Cursor β€” written like you'd actually talk.

Mere top 10 engaged subscribers ko 'VIP' tag laga do
Tagged 10 subscribers as VIP β€” Riya (@riya_g), Akash (@akash_design), Priya (@priyacooks)... All 10 will now match your "VIP" segment in broadcasts.
πŸ”§ Tools used: list_subscribers Β· tag_subscribers
Schedule 5 fitness posts for next week, 6 PM IST each day, with hashtags
Done! Generated 5 unique fitness captions and scheduled them β€” Mon "Start your week strong πŸ’ͺ..." Β· Tue "Form > weight, always..." Β· Wed "Hydration is key..." Β· Thu "Rest days matter..." Β· Fri "Weekend warrior..." All visible at /dashboard/scheduled-dms
πŸ”§ Tools used: generate_content Β· schedule_post (Γ—5)
Create a 3-step welcome sequence triggered by keyword "welcome"
Welcome sequence created βœ…
β€’ Step 1 (0 min): "Hey! Thanks for reaching out πŸ‘‹..."
β€’ Step 2 (1 day): "Quick question β€” what's your biggest challenge?..."
β€’ Step 3 (3 days): "Exclusive 15% off β€” code: WELCOME15"
Triggers when anyone DMs "welcome".
πŸ”§ Tools used: manage_sequences
Aaj ka revenue dekho, agar 5000 se kam hai to Slack pe notify karo
Today's revenue: β‚Ή3,420 ⚠️ Below β‚Ή5,000 threshold. Sent alert to your #sales-alerts Slack channel via the connected webhook.
πŸ”§ Tools used: get_revenue_stats Β· send_to_integration
Profile audit chalao mere account ka aur top 3 improvements bata do
πŸ“Š Profile health score: 78/100 (B+)
1. Add 3+ more story highlights β€” accounts with 5+ get 32% more visits
2. Post Reels weekly β€” Reels get 3x more reach than carousels
3. Reply to comments within 1 hour β€” current avg is 4 hours, hurts algorithm
πŸ”§ Tools used: run_profile_audit

Frequently asked

Quick answers to common questions about ViralDM MCP.

Which plans include MCP access?

All paid plans (Starter β‚Ή499/mo, Growth β‚Ή1,499/mo, Agency β‚Ή4,999/mo) include unlimited MCP access at no extra cost. Free trial users get MCP during their 7-day trial too.

Which AI agents are compatible?

Any agent that supports Model Context Protocol β€” Claude Desktop, Claude in Chrome, Cursor AI, Gemini CLI, Microsoft Copilot, OpenAI Agents, Cline, Continue.dev, and dozens more. Raw HTTP API also available for custom integrations.

How is authentication handled?

Two methods: OAuth 2.0 (recommended) with PKCE for Claude/Gemini/Cursor β€” user explicitly approves access via a consent screen. Or Personal API keys for custom scripts β€” generate at /dashboard/api-keys.

Can I limit what an AI agent can do?

Yes. Three scopes available: mcp:read (view only), mcp:write (create + modify), mcp:admin (full access including deletions). When agents request access, you see exactly what they're asking for on the consent screen.

What's the rate limit?

60 requests per minute per token. Above that, you'll get a 429 response with a clear message. Need higher? Email info@viraldm.app β€” Agency plans can get custom limits.

Where is data stored?

All data stays on ViralDM's existing PostgreSQL infrastructure (Neon, India region). MCP server is just a translation layer β€” it doesn't store anything. AES-256-GCM encryption for tokens, HTTPS-only communication, no third-party data sharing.

How do I revoke access?

Go to /dashboard/api-keys β†’ see all connected apps β†’ revoke any one with a single click. OAuth tokens can also be revoked programmatically via POST /oauth/revoke (RFC 7009 compliant).

Is the MCP server open source?

Not yet β€” but architecture is fully documented here. OAuth 2.0 endpoints follow RFC 6749 + RFC 7591 + RFC 7636 (PKCE) standards. Build your own MCP wrapper against /api/v1 endpoints.

Ready to ship?

Sign up for a free 7-day trial. Connect Claude or Gemini in 5 minutes. Tell your AI to handle social media.

Get Free Trial β†’