Use Social Studio with Grok Bot

Set it up

1. 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. 2

   Connect at least one social account

   Link TikTok, Instagram, Threads or Bluesky in the Social Studio.
3. 3

   Connect Grok Bot

   Pick one. Function calling is the recommended way for Grok Bot.

   Give Grok Bot the tools as functions

   Recommended

   TypeScript

   Copy

   // The model API is OpenAI-compatible; the tools are plain HTTP.
   import OpenAI from "openai"
   
   const llm = new OpenAI({ baseURL: "https://api.x.ai/v1", apiKey: process.env.XAI_API_KEY })
   const spec = await (await fetch("https://www.creative-tim.com/ui/api/social/openapi.json")).json()
   
   // Each OpenAPI operation becomes one function the model can call.
   const tools = Object.entries(spec.paths).map(([path, op]: [string, any]) => ({
     type: "function" as const,
     function: {
       name: op.post.operationId,
       description: op.post.description,
       parameters: op.post.requestBody.content["application/json"].schema,
     },
   }))
   
   const messages: any[] = [{ role: "user", content: "Make 3 TikTok ideas about home coffee, then draft the first one." }]
   for (;;) {
     const res = await llm.chat.completions.create({ model: "YOUR_GROK_MODEL", messages, tools })
     const msg = res.choices[0].message
     messages.push(msg)
     if (!msg.tool_calls?.length) break
     for (const call of msg.tool_calls) {
       const out = await fetch(`https://www.creative-tim.com/ui/api/social/tools/${call.function.name}`, {
         method: "POST",
         headers: { Authorization: `Bearer ${process.env.CREATIVE_TIM_API_KEY}`, "Content-Type": "application/json" },
         body: call.function.arguments,
       })
       messages.push({ role: "tool", tool_call_id: call.id, content: await out.text() })
     }
   }
   console.log(messages.at(-1).content)

   • Keep your Creative Tim key in CREATIVE_TIM_API_KEY, never in the prompt.
   • Return the whole assistant message (including its reasoning fields) to the model on the next turn, as the model's API requires.

   Connect any MCP client

   Option 2

   1. 1In your agent's MCP or tools settings, add a remote server with the URL above.
   2. 2Send your key as a Bearer token in the Authorization header.
   3. 3If the client only supports local (stdio) servers, bridge it with: npx -y mcp-remote https://www.creative-tim.com/ui/api/mcp --header "Authorization:Bearer sk-ct-YOUR_KEY"

   Settings

   Copy

   URL:           https://www.creative-tim.com/ui/api/mcp
   Transport:     Streamable HTTP (stateless, JSON responses)
   Authorization: Bearer sk-ct-YOUR_KEY