Model Context Protocol

ViralNote MCP — your AI's social media tool.

15 tools. HTTP + stdio transports. Works with every MCP-compatible client. One-click OAuth connect: add dashboard.viralnote.app/api/mcp/mcp as a connector in Claude, sign in, approve — no API key needed. API keys still work for headless setups.

Connect in one click Tool reference →

Listed on

Cursor DirectoryAdd to Cursor →

Add to Cursor — stdio MCP plugin

SmitheryConnect on Smithery →

One-click HTTP MCP install

GlamaView on Glama →

Browse tools & in-browser inspector

PulseMCPView on PulseMCP →

Official classification · MCP server directory

MCP RegistryOfficial listing →

Official registry · io.github.viralnote/mcp-server

One click. No API key.

ViralNote supports OAuth sign-in for MCP. Add the server URL, sign in with your ViralNote account, approve — done. Manage or revoke connections anytime in Settings → Connected Apps.

Claude

Settings → Connectors → Add custom connector
Paste https://dashboard.viralnote.app/api/mcp/mcp
Sign in to ViralNote and click Approve

Cursor

Install from Cursor Directory (stdio via npm)
Set VIRALNOTE_API_KEY when prompted
Or paste the HTTP URL in Cursor Settings → MCP for OAuth/API key

ChatGPT

Settings → Apps & Connectors → enable Developer mode
Create a connector with the same URL and OAuth auth
Sign in to ViralNote and click Approve

Works with any OAuth-capable MCP client. Headless agent, CI job, or stdio setup instead? Use an API key below.

In the chat

What your AI client sees.

List accounts

YOU

List all my connected social accounts.

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.

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.

✓ Instagram — posted, 240 likes, 17 comments
✓ LinkedIn — posted, 89 reactions, 4 comments
✗ X — failed (rate limit). Will auto-retry in 5 minutes.

Prefer an API key?

Get an API key

ViralNote dashboard → Settings → API keys → Create key

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_..."
      ]
    }
  }
}

Cursor / stdio (any client)

mcp.json

{
  "mcpServers": {
    "viralnote": {
      "command": "npx",
      "args": ["-y", "@viralnote/mcp-server"],
      "env": { "VIRALNOTE_API_KEY": "vnd_..." }
    }
  }
}

Cursor users: install from Cursor Directory instead of hand-editing config.

OpenClaw (streamable HTTP — recommended)

terminal

openclaw mcp set viralnote '{
  "url": "https://dashboard.viralnote.app/api/mcp/mcp",
  "transport": "streamable-http",
  "headers": { "x-api-key": "vnd_..." }
}'
openclaw mcp reload

Or install the stdio package: openclaw mcp add viralnote --command npx ... — see /agents. Also on Smithery.

Hermes Agent (~/.hermes/config.yaml)

config.yaml

# ~/.hermes/config.yaml
mcp_servers:
  viralnote:
    url: https://dashboard.viralnote.app/api/mcp/mcp
    headers:
      x-api-key: vnd_...

Stdio via @viralnote/mcp-server also works — see /agents#hermes.

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

Plug in. Start posting.

Get an API key Full reference

Building autonomous agents instead?

Open-source skill + REST API →

Drop ViralNote into your agent. MIT-licensed.

Technical deep dive

Full MCP reference →

Per-tool schemas, error codes, transport details.

Cursor Directory

Add to Cursor →

Community plugin listing — stdio MCP via @viralnote/mcp-server.

Smithery marketplace

Connect via Smithery →

One-click HTTP MCP install for Claude, Cursor, and other clients.

Glama

Browse on Glama →

Tool schemas, README, and in-browser MCP inspector.