ViralNote MCP server

@viralnote/mcp-server

A Model Context Protocol server for the ViralNote social media API.

Plug it into Claude Desktop, Claude Code, Cursor, or any other MCP-aware host and your agent can schedule posts, manage media, and read analytics across X, Instagram, Facebook, TikTok, LinkedIn, YouTube, Pinterest, Bluesky, Threads, and Reddit — as native MCP tool calls. No glue code.

Install

Claude Desktop / Claude Code / Cursor

Add to your MCP config (~/Library/Application Support/Claude/claudedesktopconfig.json on macOS, similar on other platforms):

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

Restart your MCP host. The ViralNote tools will be available immediately.

This repo includes a root .mcp.json (Open Plugins standard) so tools like Cursor Directory can auto-detect the MCP server from the GitHub URL.

Cursor Marketplace

Once the plugin is published on Cursor Marketplace, you can install it directly from Cursor:

1. Open Cursor and go to Settings → Plugins
2. Search for "ViralNote" in the Marketplace
3. Click Install
4. In Plugins → Configure, set your VIRALNOTEAPIKEY
5. Get your API key from dashboard.viralnote.app or viralnote.app/developers/auth

The ViralNote tools will be immediately available in your Cursor environment.

Local install

npm install -g @viralnote/mcp-server

Then reference viralnote-mcp directly in your MCP config:

{
  "mcpServers": {
    "viralnote": {
      "command": "viralnote-mcp",
      "env": { "VIRALNOTE_API_KEY": "vnd_..." }
    }
  }
}

Configuration

Tools exposed

For most users, the HTTP MCP server at https://viralnote.app/api/mcp/mcp is simpler than installing this stdio package — see https://viralnote.app/developers/mcp for the HTTP config snippet. Use this stdio package when your MCP client doesn't support HTTP transport.

The underlying REST endpoints and request/response shapes are documented at viralnote.app/developers/docs.

Example agent prompts

"Show me my last 5 scheduled posts."

Tool: list_posts with { status: "scheduled", limit: 5 }.

Shortened. The full README is on GitHub.