Model Context Protocol
ViralNote MCP — your AI's social media tool.
15 tools. HTTP + stdio transports. Works with every MCP-compatible client. Plug ViralNote into Claude, Cursor, or your own MCP host in under a minute.
In the chat
What your AI client sees.
List accounts
YOU
List all my connected social accounts.
AI
You have 5 connected: Instagram @yourbrand, X @yourhandle, LinkedIn Your Name, TikTok @yourbrand, Pinterest Your Boards.
Create scheduled post
YOU
Create a draft post with caption “New feature: import from Canva” for Instagram, LinkedIn, and X — scheduled for tomorrow at 9am.
AI
Created post_abc123 (status: scheduled). Goes out Tomorrow 9:00 AM to all three. You can edit it any time before then.
Check publish results
YOU
Show me the per-platform results for post_abc123.
AI
- ✓ Instagram — posted, 240 likes, 17 comments
- ✓ LinkedIn — posted, 89 reactions, 4 comments
- ✗ X — failed (rate limit). Will auto-retry in 5 minutes.
Setup in under a minute.
1
Get an API key
ViralNote dashboard → Settings → API keys → Create key
2
Connect your AI
Claude Code (~/.claude/settings.json)
settings.json
{
"mcpServers": {
"viralnote": {
"type": "http",
"url": "https://dashboard.viralnote.app/api/mcp/mcp",
"headers": { "Authorization": "Bearer vnd_..." }
}
}
}Claude Desktop (via mcp-remote bridge)
claude_desktop_config.json
{
"mcpServers": {
"viralnote": {
"command": "npx",
"args": [
"mcp-remote",
"https://dashboard.viralnote.app/api/mcp/mcp",
"--header",
"Authorization: Bearer vnd_..."
]
}
}
}Stdio (any client)
mcp.json
{
"mcpServers": {
"viralnote": {
"command": "npx",
"args": ["-y", "@viralnote/mcp-server"],
"env": { "VIRALNOTE_API_KEY": "vnd_..." }
}
}
}3
Restart your client
Tools become available immediately. Try: “List my connected social accounts.”
15 tools
Every tool included.
list_postsList your posts; filter by status / platformget_postRead one post incl. per-platform resultscreate_postCreate draft or scheduled postupdate_postEdit a draft or scheduled postdelete_postDelete draft or scheduledpublish_postPublish a draft nowlist_mediaList media library itemsimport_mediaImport by URL (200MB) or base64 (3MB)delete_mediaDelete a media itemlist_social_accountsList connected social accountslist_analyticsPer-platform metrics on published postslist_post_resultsPer-platform delivery success/failurelist_webhooksList webhook subscriptionscreate_webhookSubscribe to events (post.published, etc.)delete_webhookUnsubscribeWorks with
Claude DesktopClaude CodeCursorWindsurfChatGPTCline
and any MCP-compatible client
