Protocols and CLI ยท by Creative Tim
AI Agents CLI
Use Social Studio with AI Agents CLI
Every tool is also a plain HTTP endpoint. That makes Social Studio scriptable from a shell, a cron job or any language, with the same safety rules as the MCP server.
AI Agents CLI
Asks for ideas and drafts
Social tools
MCP or HTTP, one API key
You approve
Review link, then Publish
Your feeds
TikTok, Reels, Threads, Bluesky
The one rule
An agent prepares and a person publishes. AI Agents CLI can create drafts, but it cannot publish to TikTok, and it cannot approve anything on your behalf. You open the review link, check the post and click Publish.
What AI Agents CLI can do
Check the rules
Limits and approval rules for a network, before you make the video
social_get_requirementsGenerate ideas
Video ideas with hook, script, video prompt, caption and hashtags
social_generate_ideasImport a video
Host a video from a link in your own storage
social_import_videoUpload a file
Upload a video file directly
social_get_upload_urlCreate a draft
Create a post draft. TikTok drafts come with a review link for you
social_create_draftList your posts
Your posts and their status
social_list_postsTrack status
One post: processing, published (with link) or failed (with the reason)
social_get_post_status
Set it up
- 1
Create a Creative Tim API key
Create one here. It starts with
sk-ct-. Keep it in your client's secret settings, never in a prompt. - 2
- 3
Connect AI Agents CLI
Call the tools over HTTP
Terminalexport CREATIVE_TIM_API_KEY=sk-ct-YOUR_KEY # What does TikTok need from a video? curl -s -X POST https://www.creative-tim.com/ui/api/social/tools/social_get_requirements \ -H "Authorization: Bearer $CREATIVE_TIM_API_KEY" \ -H "Content-Type: application/json" \ -d '{"provider":"tiktok"}' # Host a video you already have a link to curl -s -X POST https://www.creative-tim.com/ui/api/social/tools/social_import_video \ -H "Authorization: Bearer $CREATIVE_TIM_API_KEY" \ -H "Content-Type: application/json" \ -d '{"url":"https://example.com/my-video.mp4"}' # Create the draft (returns a reviewUrl for you to open) curl -s -X POST https://www.creative-tim.com/ui/api/social/tools/social_create_draft \ -H "Authorization: Bearer $CREATIVE_TIM_API_KEY" \ -H "Content-Type: application/json" \ -d '{"provider":"tiktok","videoUrl":"<hosted url from the step above>","caption":"My caption #hashtag"}'- The full machine-readable description is at https://www.creative-tim.com/ui/api/social/openapi.json.
Try it
Paste this into AI Agents CLI and fill in the blanks:
Use the Creative Tim social tools. First check the requirements for TikTok. Then give me 5 video ideas for <my niche>. For the one I pick, import this video <video URL>, and create a TikTok draft with the caption. Give me the review link.- Step 1
AI Agents CLI tells you the draft is waiting and gives you a link.
- Step 2
Open it, review the post, publish.
- Step 3
Posts then show their status (processing, published with a link, or failed with TikTok's own reason) in the Social Studio.
Questions
Can AI Agents CLI publish to TikTok for me?
No. AI Agents CLI can create a draft with the video and caption and give you a review link. You open it, check the settings TikTok allows for your account, and click Publish. TikTok requires the creator to approve each post, so no agent can do it for you.
Which networks can AI Agents CLI prepare posts for?
TikTok, Instagram Reels, Threads and Bluesky. For networks other than TikTok, your own copilot or autopilot setting decides whether a draft waits for your approval or is scheduled directly.
What does it cost?
Posting and drafting are free. Generating ideas or video in Creative Tim uses credits from your plan.
Where does my API key go?
In the client's secret or header settings, never in a prompt. You can create and revoke keys on the API Keys page at any time.