Agents + API

Build agents that run social media on autopilot.

One-click MCP connect (OAuth — listed in the official MCP registry), an open-source skill, and a REST API. Drop ViralNote into your agent and it learns 15 tools immediately. MIT-licensed, no vendor lock-in.

Install the skill REST API docs →

In production

What an agent run looks like.

Scheduled content engine

YOU (WEEKLY)

Pull the latest 3 posts from my blog's RSS and schedule one per day to Instagram, LinkedIn, and X.

AGENT

Scheduled 3 posts:

Tuesday 9am — “Building public roadmaps”
Thursday 9am — “What we learned shipping MCP”
Friday 11am — “Three patterns for AI-driven content”

Cross-platform reposter

YOU

Watch my Instagram for new posts. Whenever I publish one, repost the same caption + photo to LinkedIn within an hour.

AGENT

Watching @yourbrand. I'll repost matching content within 60 minutes of each Instagram publish.

Performance monitor

YOU

Tell me when any post hits 10K impressions.

AGENT

Polling every 30 minutes. Will DM you when a post crosses the threshold.

Install the skill.

The skill teaches your agent the ViralNote API surface — 15 tools, error handling, common workflows. MIT-licensed.

terminal

npx skills add viralnote/viralnote-skill

Or use the REST API directly

curl

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

Full OpenAPI spec at viralnote.app/developers/docs.

OpenClaw

Native MCP + ClawHub skill.

OpenClaw 2026.3.22+ speaks MCP natively. Connect all 15 ViralNote tools via HTTP, or install the MIT skill for REST API workflows.

MCP (15 tools, 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

MCP via stdio npm package

terminal

openclaw mcp add viralnote \
  --command npx \
  --arg -y \
  --arg @viralnote/mcp-server \
  --env VIRALNOTE_API_KEY=vnd_...

Skill (REST API)

terminal

clawhub install @viralnote/viralnote
# or: openclaw skills install @viralnote/viralnote

Set VIRALNOTE_API_KEY=vnd_... in your OpenClaw environment. Get a key at dashboard.viralnote.app/developers/auth.

Deeper agent patterns: Using our API with OpenClaw. MCP setup: /mcp. Marketplace: Smithery.

Hermes Agent

MCP client + autonomous runs.

Hermes Agent connects to remote HTTP MCP servers and local stdio packages. Add ViralNote under mcp_servers in ~/.hermes/config.yaml, then start a new session — all 15 tools appear in the agent's tool list.

HTTP MCP (recommended)

config.yaml

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

Stdio via npm

config.yaml

# ~/.hermes/config.yaml
mcp_servers:
  viralnote:
    command: npx
    args: ["-y", "@viralnote/mcp-server"]
    env:
      VIRALNOTE_API_KEY: vnd_...

Get a key at dashboard.viralnote.app/developers/auth. Restart Hermes after editing config. Docs: Hermes MCP guide.

MCP setup: /mcp. Also works with OpenClaw.

Use cases