ViralNote
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 / platform
get_postRead one post incl. per-platform results
create_postCreate draft or scheduled post
update_postEdit a draft or scheduled post
delete_postDelete draft or scheduled
publish_postPublish a draft now
list_mediaList media library items
import_mediaImport by URL (200MB) or base64 (3MB)
delete_mediaDelete a media item
list_social_accountsList connected social accounts
list_analyticsPer-platform metrics on published posts
list_post_resultsPer-platform delivery success/failure
list_webhooksList webhook subscriptions
create_webhookSubscribe to events (post.published, etc.)
delete_webhookUnsubscribe

Works with

Claude DesktopClaude CodeCursorWindsurfChatGPTCline

and any MCP-compatible client