name: taisly-social-media-posting description: Free AI-first short-form video publishing to TikTok, Instagram Reels, YouTube Shorts, X, and Facebook from AI agents through Taisly. version: 0.2.7 metadata: publicName: Taisly Social Media Posting Skill requirements: binaries: - taisly openclaw: requires: bins: - taisly primaryEnv: TAISLY_API_KEY envVars: - name: TAISLY_API_KEY required: false description: Optional Taisly API key. The browser setup flow can create a local credential instead. homepage: https://github.com/taisly/agent install: - kind: node package: "@taisly/agent" bins: - taisly

Taisly Social Media Posting Skill

Use this skill when a user asks an AI agent to publish, schedule, or repost short-form video content through Taisly. The package is free to install and designed for AI-first posting workflows that can start without building platform integrations from scratch.

Rules

• Always discover platforms before posting.
• Ask for explicit confirmation before publishing to live social accounts unless the user already gave exact destination accounts, video file, caption, and schedule.
• If MCP tools are available, prefer them over shell commands; otherwise use the JSON-first CLI.
• For MCP publishing, call taisly_posts_create only with confirmed: true after explicit user approval.
• Never invent platform IDs.
• Never expose or print TAISLY_API_KEY.
• If Taisly returns a current-plan or limit error, explain agent.message when present and provide the returned agent.paymentLinks when available. Do not attempt payment without explicit user confirmation.
• Prefer scheduled posts when the user gives a future time.
• Save the returned historyId so status can be checked later.
• Supported local video extensions are .mp4, .mov, .avi, .mkv, .webm, .flv, .mpeg, and .mpg.

Environment

Prefer the browser setup flow when the user has not configured Taisly yet:

taisly setup --agent <agent-slug>
# Ask the user to open the returned loginUrl and finish authentication.
taisly checkin --agent <agent-slug>

Use a short slug for the current agent, for example claude-code, codex, cursor, windsurf, openclaw, hermes-agent, cline, or aider.

The checkin command stores a local Taisly agent credential for later CLI and MCP calls.

Manual API key fallback:

export TAISLY_API_KEY="taisly_..."

Remote MCP endpoint:

https://app.taisly.com/mcp

Remote MCP can publish only from public videoUrl values. Use the local MCP server or CLI when the video is a local file path available to the agent.

Commands

taisly auth:status
taisly setup --agent <agent-slug>
taisly checkin --agent <agent-slug>
taisly platforms:list
taisly integrations:list
taisly platforms:schema --platform TikTok
taisly posts:validate --video ./video.mp4 --platforms platform_id_1,platform_id_2 --description "Caption"
taisly posts:create --video ./video.mp4 --platforms platform_id_1,platform_id_2 --description "Caption" --scheduled "2026-06-14T09:00:00+07:00"
taisly posts:create --json ./campaign.json
taisly posts:list --page 1
taisly posts:status --id <historyId>
taisly reposts:create --from <platform_id> --to <platform_id_1,platform_id_2>
taisly mcp

All commands return JSON.

MCP Tools

When the MCP server is connected, use these tools instead of shell commands:

• taisly_agent_setup_start
• taisly_agent_checkin
• taisly_auth_status
• taisly_platforms_list
• taisly_platform_schema
• taisly_platform_connect_start
• taisly_platform_connect_check
• taisly_posts_validate
• taisly_posts_create
• taisly_posts_status
• taisly_posts_list
• taisly_reposts_list
• taisly_reposts_create

Posting Workflow

1. If Taisly is not connected yet, run taisly_agent_setup_start or taisly setup --agent <agent-slug> and give the user the returned login URL.
2. Wait for the user to finish browser login, then run taisly_agent_checkin or taisly checkin --agent <agent-slug>.
3. Run taisly auth:status.
4. Run taisly platforms:list.
5. If a requested platform is missing and a connect tool is available, run taisly platforms:connect:start --platform <name>, give the user the returned connectUrl, wait for browser approval, then run taisly platforms:connect:check --platform <name>. Supported connect slugs are instagram, tiktok, youtube, x, and facebook.
6. Match the user's requested platforms to connected platform IDs.
7. Run taisly platforms:schema --platform <name> for constraints.
8. Run taisly posts:validate.
9. Confirm destination accounts and caption with the user.
10. Run taisly posts:create.
11. Report the returned historyId, scheduled date, and per-platform initial statuses.

For MCP, follow the same sequence with taisly_auth_status, taisly_platforms_list, taisly_platform_connect_start, taisly_platform_connect_check, taisly_platform_schema, taisly_posts_validate, taisly_posts_create, and taisly_posts_status.

Error Handling

• TAISLY_API_KEY_MISSING: ask the user to create or provide an API key.
• SETUP_SESSION_MISSING: run taisly setup --agent <agent-slug>, ask the user to open the returned login URL, then run taisly checkin --agent <agent-slug>.
• PLATFORMS_REQUIRED: ask which connected accounts should receive the post.
• VIDEO_REQUIRED: ask for a local video path.
• LIMIT: tell the user the current plan limit has been reached. Use agent.message and agent.paymentLinks when present, ask them to upgrade in Taisly before retrying, and do not open or use payment links without explicit confirmation.
• POST_NOT_FOUND_IN_RECENT_HISTORY: tell the user the post was created but a dedicated status endpoint is not available yet; check Taisly History.

What Not To Do

• Do not post to every connected account unless the user explicitly asks.
• Do not retry posts:create blindly after a timeout; ask the user or check History first.
• Do not use unsupported file types.

Taisly Agent Kit

Free AI-first social media posting for short-form video. Taisly Agent Kit is a JSON-first SDK, CLI, Agent Skill, and MCP server that lets AI agents, developer tools, and automation workflows publish videos to TikTok, Instagram Reels, YouTube Shorts, X, Facebook, and other connected social platforms through Taisly.

Use it when your agent can create content, write captions, or prepare a campaign, but still needs a reliable video publishing API to put that content online. The package is free to install and designed to get an agent from idea to published video without building every platform integration yourself.

Website | Agent Kit | API Docs | npm | GitHub | MCP Registry | Glama | Guide

Languages

Read this guide in: English, Español, Deutsch, Français, Português, ไทย, 中文, Bahasa Indonesia, Русский, Nederlands, 한국어, 日本語, العربية, Türkçe, Polski.

Why developers use it

• Build AI agent social media posting into Codex, Claude Code, Cursor, OpenClaw, and custom automation tools.
• Automate video publishing from one local file to multiple connected social accounts.
• Give agents a safe JSON workflow: discover accounts, validate payloads, create posts, and check status.
• Add TikTok API posting automation, Instagram Reels automation, YouTube Shorts publishing, and cross-platform social media automation without building every platform integration yourself.
• Start free, then upgrade only when the publishing workflow grows.

Taisly handles the connected accounts and posting execution. Your agent handles planning, caption writing, campaign logic, or workflow orchestration.

Free AI-first posting

• Install the package for free.
• Create or connect a Taisly account from your AI agent.
• Let the agent authenticate, connect social accounts, validate videos, and publish through a JSON-first workflow.
• Upgrade later when you need higher-volume publishing, larger account sets, or automatic repost workflows.

No credit card is required to get started. Paid plans are for teams and workflows that need more scale.

Agent Skill

This package includes the Taisly Social Media Posting Skill in SKILL.md. Use it with Claude Code, Codex, Cursor, OpenClaw, and other agents when you want the agent to understand the safe posting workflow before it touches live social accounts.

Recommended skill workflow:

auth -> platforms -> validate -> confirm -> create -> status

The skill tells agents to discover connected accounts, validate the post, ask for explicit user confirmation, create the post, and save the returned historyId for status checks.

Codex plugin

This package includes a Codex plugin manifest in .codex-plugin/plugin.json. The plugin bundles the Taisly Social Media Posting skill and the official remote MCP server:

https://app.taisly.com/mcp

Use the plugin when you want Codex to discover both the posting workflow instructions and the Taisly MCP tools from one package.

Install

npm install -g @taisly/agent

Or run it without a global install:

npx @taisly/agent help

Start the stdio MCP server:

npx @taisly/agent mcp

For local development inside this repository:

node packages/agent/src/cli.js help

Authentication

The easiest flow is to let your AI agent open the browser login for you. Use any short agent slug, for example claude-code, codex, cursor, windsurf, openclaw, hermes-agent, cline, or aider.

Help me set up Taisly Agent Kit.

1. Install the CLI: npm i -g @taisly/agent
2. Run taisly setup --agent <agent-slug> and send me the login URL so I can finish authentication.
3. Wait for me to finish login in the browser.
4. Run taisly checkin --agent <agent-slug>.
5. Tell me if Taisly is connected and ready. If not, tell me what failed.

If you cannot install or run the Taisly CLI in this environment, stop and tell me to open Taisly Settings instead.

The setup command stores a local Taisly agent credential, so later CLI and MCP commands can run without manually copying an API key.

Manual fallback: create an API key in Taisly Settings, then set:

export TAISLY_API_KEY="taisly_..."

Advanced: by default, the browser setup stores the local credential in ~/.taisly/config.json. Most users should not change this. Set TAISLY_CONFIG_HOME=/path/to/dir only for CI, tests, or isolated agent profiles that need a separate credential store.

Quick start

List the connected social accounts available to the API key:

taisly auth:status
taisly platforms:list

Connect a social account from an AI-agent flow:

taisly platforms:connect:start --platform instagram
# Open the returned connectUrl and finish authorization in the browser.
taisly platforms:connect:check --platform instagram
taisly platforms:list

Supported connect slugs: instagram, tiktok, youtube, x, facebook.

Validate a local video before publishing:

taisly posts:validate \
  --video ./launch.mp4 \
  --platforms platform_id_1,platform_id_2 \
  --description "Launch day"

Publish now:

taisly posts:create \
  --video ./launch.mp4 \
  --platforms platform_id_1,platform_id_2 \
  --description "Launch day"

Schedule for later:

taisly posts:create \
  --video ./launch.mp4 \
  --platforms platform_id_1,platform_id_2 \
  --description "Launch day" \
  --scheduled "2026-06-14T09:00:00+07:00"

Check the returned post:

taisly posts:status --id <historyId>

Every command prints JSON so agents can parse results without scraping terminal text.

MCP server

Taisly is published in the official MCP Registry as:

io.github.taisly/agent

Display name: Taisly Social Media Posting

Remote MCP endpoint:

https://app.taisly.com/mcp

The remote MCP server uses streamable HTTP and OAuth. Remote MCP tools can publish only from public videoUrl values because they cannot read local files from your machine.

Codex remote MCP setup:

codex mcp add taisly --url https://app.taisly.com/mcp
codex mcp login taisly

Claude Code remote MCP setup:

claude mcp add --transport http taisly https://app.taisly.com/mcp

Then ask Claude Code to verify the connection. If OAuth is needed, Claude Code can guide the browser login from the session. You can also authenticate explicitly with claude mcp login taisly if you want to complete the OAuth flow from the shell before using tools.

Taisly Agent Kit also includes a local stdio MCP server in the same package. Use local MCP when your agent needs to read local video files:

{
  "mcpServers": {
    "taisly": {
      "command": "npx",
      "args": ["@taisly/agent", "mcp"]
    }
  }
}

If you already use a manual API key, you can still pass TAISLY_API_KEY in the MCP server env block.

Codex local MCP setup:

codex mcp add taisly -- npx @taisly/agent mcp

Claude Code local MCP setup:

claude mcp add taisly -- npx @taisly/agent mcp

Then ask the agent:

Use the local Taisly MCP server you just added and run the Taisly agent setup start tool with agentId: "<agent-slug>".

Send me the login URL and wait for me to finish in the browser.
Then run the Taisly agent checkin tool with agentId: "<agent-slug>".
After checkin, run the Taisly auth status tool.
Tell me if Taisly is connected and ready. If not, tell me what failed.

Available MCP tools:

• taisly_agent_setup_start
• taisly_agent_checkin
• taisly_auth_status
• taisly_platforms_list
• taisly_platform_schema
• taisly_platform_connect_start
• taisly_platform_connect_check
• taisly_posts_validate
• taisly_posts_create
• taisly_posts_status
• taisly_posts_list
• taisly_reposts_list
• taisly_reposts_create

taisly_posts_create requires confirmed: true. Set it only after the user explicitly approves the video, destination accounts, caption, and schedule.

JSON workflow for agents

Agents can write a payload file and pass it to the CLI:

{
  "video": "./launch.mp4",
  "platforms": ["platform_id_1", "platform_id_2"],
  "description": "Launch day. Short demo, big update.",
  "scheduled": "2026-06-14T09:00:00+07:00"
}

Then run:

taisly posts:validate --json ./campaign.json
taisly posts:create --json ./campaign.json

The video path must point to a real local file available to the agent. Supported local preflight extensions are .mp4, .mov, .avi, .mkv, .webm, .flv, .mpeg, and .mpg.

Commands

taisly auth:status
taisly setup --agent <agent-slug>
taisly checkin --agent <agent-slug>
taisly platforms:list
taisly integrations:list
taisly platforms:schema --platform TikTok
taisly posts:validate --video ./launch.mp4 --platform