{
  "markdown": "# @viralnote/mcp-server\n\n[![ViralNote MCP server](https://glama.ai/mcp/servers/viralnote/mcp-server/badges/card.svg)](https://glama.ai/mcp/servers/viralnote/mcp-server)\n\nA [Model Context Protocol](https://modelcontextprotocol.io) server for the **ViralNote** social media API.\n\nPlug 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.\n\n## Install\n\n### Claude Desktop / Claude Code / Cursor\n\nAdd to your MCP config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS, similar on other platforms):\n\n```json\n{\n  \"mcpServers\": {\n    \"viralnote\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@viralnote/mcp-server\"],\n      \"env\": {\n        \"VIRALNOTE_API_KEY\": \"vnd_...\"\n      }\n    }\n  }\n}\n```\n\nRestart your MCP host. The ViralNote tools will be available immediately.\n\nThis repo includes a root [`.mcp.json`](./.mcp.json) ([Open Plugins](https://open-plugins.com) standard) so tools like [Cursor Directory](https://cursor.directory/plugins/new) can auto-detect the MCP server from the GitHub URL.\n\n#### Cursor Marketplace\n\nOnce the plugin is published on Cursor Marketplace, you can install it directly from Cursor:\n\n1. Open Cursor and go to Settings → Plugins\n2. Search for \"ViralNote\" in the Marketplace\n3. Click Install\n4. In Plugins → Configure, set your `VIRALNOTE_API_KEY`\n5. Get your API key from [dashboard.viralnote.app](https://dashboard.viralnote.app) or [viralnote.app/developers/auth](https://viralnote.app/developers/auth)\n\nThe ViralNote tools will be immediately available in your Cursor environment.\n\n### Local install\n\n```bash\nnpm install -g @viralnote/mcp-server\n```\n\nThen reference `viralnote-mcp` directly in your MCP config:\n\n```json\n{\n  \"mcpServers\": {\n    \"viralnote\": {\n      \"command\": \"viralnote-mcp\",\n      \"env\": { \"VIRALNOTE_API_KEY\": \"vnd_...\" }\n    }\n  }\n}\n```\n\n## Configuration\n\n| Env var | Required | Default | Notes |\n|---|---|---|---|\n| `VIRALNOTE_API_KEY` | yes | — | Generate at [viralnote.app/developers/auth](https://viralnote.app/developers/auth). Grant `posts:read`, `posts:write`, plus `webhooks:*` if your agent should manage webhooks. |\n| `VIRALNOTE_API_BASE` | no | `https://viralnote.app/api/v1` | Override for staging/self-hosted instances. |\n\n## Tools exposed\n\n| Tool | Purpose |\n|---|---|\n| `list_posts` | List posts (filter by status/platform, paginated) |\n| `get_post` | Read one post including per-platform publish results |\n| `create_post` | Create a draft (`is_draft: true`) or scheduled post |\n| `update_post` | Update a draft or scheduled post |\n| `delete_post` | Delete (cancels if scheduled) |\n| `publish_post` | Publish a draft now |\n| `list_media` | List media library items |\n| `import_media` | Import by URL (200MB) or base64 data (3MB) |\n| `delete_media` | Delete a media item |\n| `list_social_accounts` | List connected social accounts |\n| `list_analytics` | Published posts with per-platform metrics |\n| `list_post_results` | Per-platform delivery results (success/error) |\n| `list_webhooks` | List webhook subscriptions |\n| `create_webhook` | Subscribe to events |\n| `delete_webhook` | Unsubscribe |\n\nFor 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.\n\nThe underlying REST endpoints and request/response shapes are documented at [viralnote.app/developers/docs](https://viralnote.app/developers/docs).\n\n## Example agent prompts\n\n> \"Show me my last 5 scheduled posts.\"\n> Tool: `list_posts` with `{ status: \"scheduled\", limit: 5 }`.\n\n> \"Schedule this caption to Instagram for tomorrow at 9am, attaching the photo I uploaded yesterday.\"\n> Tools: `list_media` → find item → `create_post` with `{ platforms: [\"instagram\"], caption, libraryItemId, scheduledFor, status: \"scheduled\" }`.\n\n> \"Pull this Dropbox link into my library, then publish it to X immediately.\"\n> Tools: `import_media` → `create_post` (draft) → `publish_post`.\n\n## Development\n\n```bash\ngit clone https://github.com/viralnote/mcp-server\ncd mcp-server\nnpm install\nnpm run build\nVIRALNOTE_API_KEY=vnd_... npm start\n```\n\nFor local iteration without rebuilding:\n\n```bash\nVIRALNOTE_API_KEY=vnd_... npm run dev\n```\n\n## License\n\nMIT — see `LICENSE`. Pull requests welcome.\n",
  "bytes": 4569,
  "sha": "a7e9a78c83842fbf2611334032a3ef49b37bb0a8c503a99c0ec6600742175a03",
  "repo_slug": "viralnote/mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_viralnote_mcp_server_47995e83/readme"
}