# Build Social Media Agents with ViralNote

Drop ViralNote into an agent runtime and it can draft, schedule, publish, and measure posts across 10 networks. Three integration paths, all MIT-licensed on the client side:

1. **Agent skill** — `npx skills add viralnote/viralnote-skill` (https://github.com/viralnote/viralnote-skill). Teaches an LLM the REST API with request shapes and guardrails. Also on ClawHub: `clawhub install @viralnote/viralnote`.
2. **MCP server** — `https://dashboard.viralnote.app/api/mcp/mcp` (Streamable HTTP) or `@viralnote/mcp-server` (stdio). 32 tools. Setup: https://www.viralnote.app/mcp.md
3. **REST API** — base `https://dashboard.viralnote.app/api/v1`, OpenAPI at https://www.viralnote.app/openapi.json, reference at https://www.viralnote.app/developers/docs.

## Use cases

- **Scheduled content engines** — RSS-to-schedule pipelines on a daily or weekly cadence.
- **Cross-platform reposting** — mirror posts between platforms with per-platform tweaks.
- **Performance monitoring** — watch engagement thresholds and alert on failed publishes via webhooks.
- **Bulk content operations** — schedule months of content from a spreadsheet.
- **Multi-account orchestration** — manage many brand accounts from one agent.

## Minimal example

```bash
curl https://dashboard.viralnote.app/api/v1/posts -H "Authorization: Bearer vnd_..."
```

```bash
curl -X POST https://dashboard.viralnote.app/api/v1/posts \
  -H "x-api-key: vnd_..." -H "Content-Type: application/json" \
  -d '{"platforms":["twitter","linkedin"],"content":"Ship day.","status":"scheduled","scheduledFor":"2026-09-10T15:00:00Z"}'
```

## Safe testing

There is no separate sandbox host. To exercise the API without touching live audiences, create posts with `"status": "draft"` (nothing is sent to any network until you call publish or set a schedule) and use the 7-day trial account. Reads (`GET`) are always side-effect free.

## Guides

- MCP server for social media (Claude, Cursor, Smithery): https://www.viralnote.app/blog/mcp-server-social-media-schedule-claude-cursor.md
- MCP vs skill vs API: https://www.viralnote.app/blog/mcp-vs-skill-vs-api-viralnote-agent.md
- Three agent workflows: https://www.viralnote.app/blog/three-agent-workflows-social-media-scheduling.md
- OpenClaw setup: https://www.viralnote.app/blog/openclaw-viralnote-mcp-setup.md
- Scoped llms.txt for this area: https://www.viralnote.app/agents/llms.txt

---

Site index for agents: https://www.viralnote.app/llms.txt · Structured view: https://www.viralnote.app/agent.json · API: https://www.viralnote.app/openapi.json · Auth: https://www.viralnote.app/auth.md