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
npm install -g @taisly/agent
taisly auth:statusRecommended workflow
- For a local package connection, run
taisly setup --agent <agent-slug>, approve the returned browser URL, then runtaisly checkin --agent <agent-slug>. A manually configuredTAISLY_API_KEYis an alternative for developer workflows. - Run
taisly auth:status. - Run
taisly platforms:listortaisly integrations:list. - Run
taisly platforms:schema --platform <platform>for each selected destination platform. - Run
taisly posts:validatewith the requested settings. - Confirm destination accounts, caption, schedule, and requested settings with the user.
- Run
taisly posts:create. - Store the returned
historyId. - 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 mcpExample Claude Code setup:
claude mcp add --transport stdio taisly -- npx -y @taisly/agent mcpSafety 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.
Discovery links
- npm: @taisly/agent
- GitHub: github.com/taisly/agent
- MCP Registry: io.github.taisly/agent
- Glama: glama.ai/mcp/servers/taisly/agent