cutedyno

JSON CLI and MCP server for CuteDyno. Schedule and publish to Instagram, TikTok, LinkedIn, Facebook, and YouTube — from shell scripts or AI agents.

npm install -g cutedyno

CLI quickstart

export CUTEDYNO_API_KEY=cdyn_live_...
cutedyno auth:status
cutedyno accounts:list
cutedyno posts:create -c "Hello" -a acct_1 --now

Every data command prints JSON to stdout. Errors print JSON to stderr and exit 1.

Full docs: cutedyno.com/docs/cli

Common commands

| Command | Purpose | | --- | --- | | auth:status | Check API key configuration | | profiles:list | List profiles | | accounts:list | Connected social accounts | | policy:get | Posting policy and limits | | media:upload ./clip.mp4 | Upload a local file (scripts) | | media:upload-session | Create a browser upload link (agents) | | media:upload-session:get --id | Poll an upload session | | analytics:get | Live account metrics | | analytics:history --from --to | Timeseries and top content | | posts:create --json ./post.json | Create a post | | posts:publish --id | Publish a draft | | mcp | Start the stdio MCP server |

Media for AI agents

AI clients cannot read files from the user's computer. Create a hosted upload session instead:

SESSION=$(cutedyno media:upload-session --profile "$PROFILE")
echo "$SESSION" | jq -r '.uploadUrl'   # send user here

# After they upload and click Done:
cutedyno media:upload-session:get --id "$(echo "$SESSION" | jq -r '.id')" --profile "$PROFILE"

For local scripts with files on disk, use media:upload instead.

MCP

Hosted (recommended for cloud agents):

{
  "mcpServers": {
    "cutedyno": {
      "url": "https://api.cutedyno.com/mcp",
      "headers": { "Authorization": "Bearer cdyn_live_..." }
    }
  }
}

Stdio (local):

{
  "mcpServers": {
    "cutedyno": {
      "command": "npx",
      "args": ["-y", "cutedyno", "mcp"],
      "env": { "CUTEDYNO_API_KEY": "cdyn_live_..." }
    }
  }
}

List all 32 tools:

npx -y cutedyno mcp --tools

Docs: cutedyno.com/docs/mcp

Skills

npx skills add cutedyno/cutedyno-agent

Environment

| Variable | Required | Default | | --- | --- | --- | | CUTEDYNO_API_KEY | yes (or cutedyno auth:set) | — | | CUTEDYNO_API_URL | no | https://api.cutedyno.com |

Library

Embed the MCP server in your own Node process:

import { createCuteDynoMcpServer } from 'cutedyno';
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';

const server = createCuteDynoMcpServer({ apiKey: process.env.CUTEDYNO_API_KEY! });
await server.connect(new StdioServerTransport());

For typed REST calls, use @cutedyno/node.