Agents

Agent Kit

Install and use the official Taisly Agent Kit package, CLI, skill file, and local MCP server.

For ordinary AI-agent connections, start with Taisly MCP. Remote MCP uses OAuth and does not require this package or an API key. If that connection exists, use it directly.

This page is for optional developer and local-file workflows. Taisly Agent Kit is the JSON-first package for AI agents that publish short-form videos through Taisly.

It includes:

  • A CLI for local and scripted workflows.
  • A local stdio MCP server.
  • Agent setup and check-in commands.
  • Structured commands for platforms, post validation, publishing, status, and reposts.

Install

Install Agent Kit
npm install -g @taisly/agent
taisly auth:status
  1. For a local package connection, run taisly setup --agent <agent-slug>, approve the returned browser URL, then run taisly checkin --agent <agent-slug>. A manually configured TAISLY_API_KEY is an alternative for developer workflows.
  2. Run taisly auth:status.
  3. Run taisly platforms:list or taisly integrations:list.
  4. Run taisly platforms:schema --platform <platform> for each selected destination platform.
  5. Run taisly posts:validate with the requested settings.
  6. Confirm destination accounts, caption, schedule, and requested settings with the user.
  7. Run taisly posts:create.
  8. Store the returned historyId.
  9. Run taisly posts:status --id <historyId>.

Common commands

taisly auth:status
taisly platforms:list
taisly integrations:list
taisly platforms:schema --platform TikTok
taisly platforms:schema --platform YouTube
taisly posts:validate --video ./launch.mp4 --platforms <platform_id> --description "Launch day"
taisly posts:create --video ./launch.mp4 --platforms <platform_id> --description "Launch day"
taisly posts:create --json ./campaign.json
taisly posts:list --page 1
taisly posts:status --id <historyId>
taisly reposts:list
taisly reposts:create --from <platform_id> --to <platform_id_1,platform_id_2>

Posting settings

Discover supported controls with taisly platforms:schema --platform <platform> for each selected platform. Group options by platform name and pass them through --settings or a settings object in a --json input file. For example:

taisly posts:create \
  --video ./video.mp4 \
  --platforms your_tiktok_platform_id,your_youtube_platform_id \
  --description "Product walkthrough" \
  --settings '{"TikTok":{"status":"PUBLIC_TO_EVERYONE"},"YouTube":{"title":"Product walkthrough","status":"unlisted"}}'

Use the latest @taisly/agent release for CLI, SDK, or local MCP. For remote MCP, refresh or reconnect your existing connection.

Use the same settings when validating and creating a post, and include them in the user's posting confirmation. These options work for immediate and scheduled posts. See Supported settings by platform.

Local MCP

Use local MCP when an agent can launch local commands and needs access to files on your machine.

npx -y @taisly/agent mcp

Example Claude Code setup:

claude mcp add --transport stdio taisly -- npx -y @taisly/agent mcp

Safety rules

Agent safety

Never invent platform IDs, never print API keys, and do not create a live post until the user has confirmed the video, caption, destination, and schedule.

On this page