Automate TikTok posting with MCP and your own AI agent.

Postnero is a TikTok MCP server for creating drafts, converting carousels to video, scheduling approved posts, and checking delivery. Free includes API and MCP access, the basic editor, ten scheduled posts per calendar month, and one account.

Start free with your agent

From one idea to a reviewed TikTok draft

  1. Connect and check. Create a key in Settings. Ask your agent to run list_tiktok_accounts and get_tiktok_creator_info. An empty account list means you need to connect TikTok.
  2. Make the carousel. Provide owned photos and a short brief. Have the agent prepare an editable carousel and its exact slide render. Review the rendered images in Postnero.
  3. Choose the format. Keep the photo carousel or call create_video_from_carousel with its render ID. Check list_video_jobs until the MP4 is ready, then watch it.
  4. Approve and schedule. Review the caption, time zone, date, audience, interactions, disclosures, and video consent. Only then have the agent schedule that exact version.
  5. Confirm delivery. Use list_posts_page and get_publish_status. A scheduled receipt is not a published TikTok.
“Use my four product photos to prepare one TikTok photo carousel. Keep claims limited to the facts in my brief. Make a silent video version at three seconds per slide. Show both previews and the proposed settings. Wait for my approval before scheduling either version.”

The example creates two reviewable drafts. Scheduling both uses two Free posting slots. Your agent’s subscription or model usage is separate; Postnero does not generate original footage.

See a carousel example · Plan the video duration · Download a starter brief

Connect with a prompt

Paste this prompt into your agent. It will use Postnero directly, without manual MCP setup.

Requires an agent that can make authenticated HTTP requests. Chat-only agents may need a connector or additional tool access.

The prompt contains no secret. Your agent will ask for the key separately.

Preview setup prompt
Connect to my Postnero account using the REST API. Do not ask me to configure MCP manually.

1. Read https://postnero.com/skill.md for the service instructions. Use https://postnero.com as the only API origin.
2. Ask me for my Postnero API key using your secure credential input or secret store. I can create one at https://postnero.com/settings#api-keys. Never print the key, put it in a URL, commit it, or send it to any other host. Use your secure credential storage if available; ask before persisting it. Do not put the key in shell command history or logs.
3. Use your HTTP/API tool or execution environment to make GET https://postnero.com/tiktok/accounts with Authorization: Bearer <my key>. Do not follow redirects with credentials. This is a read-only connection check.
4. Only after a successful response, confirm that access works and show the connected account names. If the list is empty, direct me to https://postnero.com/settings#tiktok. If authentication fails, ask for a valid key; do not repeatedly retry it.
5. If you cannot make authenticated HTTP requests, say so clearly and explain the minimum connector or tool permission needed. Do not claim to be connected just because you read these instructions. A prompt cannot enable tools you do not have.

Stop after verifying access. Do not create, schedule, publish, delete, or disconnect anything. For future posting, show me the exact content, account, audience, disclosures, and schedule and obtain my approval first.
Create your private key in Settings

Optional: manual MCP setup

  1. Create your free account.
  2. Open Settings, connect TikTok, and create an API key.
  3. Keep the key private. Never commit it to a repository or paste it into a public chat.
Server
https://postnero.com/mcp
Connection
Streamable HTTP
Authentication
Authorization: Bearer ck_…

Codex

Shared MCP config

Codex CLI and the Codex IDE extension use the MCP servers configured on your Codex host.

OpenAI MCP documentation
  1. Open ~/.codex/config.toml on the computer running Codex.
  2. Make your private key available as POSTNERO_API_KEY in the environment of the Codex process, then add the configuration below.
  3. Restart the client, then type /mcp to confirm that Postnero and its tools are connected.
[mcp_servers.postnero]
url = "https://postnero.com/mcp"
bearer_token_env_var = "POSTNERO_API_KEY"

Claude Code

One terminal command

Add Postnero at user scope so the connection is available in every Claude Code project on your computer.

Claude Code MCP documentation
  1. Open Terminal and replace the example key in the command below.
  2. Run both commands. Claude Code stores the server in your user configuration.
  3. Open Claude Code and ask it to list your Postnero accounts or scheduled posts.
claude mcp add --scope user --transport http postnero https://postnero.com/mcp --header "Authorization: Bearer ck_your_key_here"
claude mcp list

Cursor

Global MCP config

Use Cursor's global configuration so Postnero is available to the Agent in every workspace.

Cursor MCP documentation
  1. Open ~/.cursor/mcp.json. Create the file if it does not exist.
  2. Merge in the Postnero server below and replace the example key.
  3. Restart Cursor, open Agent, and confirm that Postnero appears under Available Tools.
{
  "mcpServers": {
    "postnero": {
      "url": "https://postnero.com/mcp",
      "headers": {
        "Authorization": "Bearer ck_your_key_here"
      }
    }
  }
}

Gemini CLI

One terminal command

Add Postnero at user scope with Gemini CLI's native Streamable HTTP transport.

Gemini CLI MCP documentation
  1. Open Terminal and replace the example key in the command below.
  2. Run both commands to add Postnero and check the connection.
  3. Start Gemini CLI and ask it to list your Postnero accounts or posts.
gemini mcp add --scope user --transport http --header "Authorization: Bearer ck_your_key_here" postnero https://postnero.com/mcp
gemini mcp list

Windsurf

Cascade MCP config

Connect Postnero to Cascade through Windsurf's global remote MCP configuration.

Windsurf MCP documentation
  1. In Cascade, open the MCPs menu and choose Configure. This opens ~/.codeium/windsurf/mcp_config.json.
  2. Merge in the server below and replace the example key.
  3. Save, refresh the MCP list, and confirm that the Postnero tools are available.
{
  "mcpServers": {
    "postnero": {
      "serverUrl": "https://postnero.com/mcp",
      "headers": {
        "Authorization": "Bearer ck_your_key_here"
      }
    }
  }
}

VS Code Chat

Secure key prompt

Use Postnero from the local Chat view in VS Code without hardcoding your key in the configuration file.

VS Code MCP documentation
  1. Open the Command Palette and run MCP: Open User Configuration.
  2. Add the configuration below. When the server starts, paste your Postnero key into the secure prompt.
  3. Approve the server trust prompt, then find Postnero under Configure Tools in Chat.
{
  "inputs": [
    {
      "type": "promptString",
      "id": "postnero-key",
      "description": "Postnero API key",
      "password": true
    }
  ],
  "servers": {
    "postnero": {
      "type": "http",
      "url": "https://postnero.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:postnero-key}"
      }
    }
  }
}

GitHub Copilot coding agent

Repository MCP settings

Connect Postnero to GitHub's cloud coding agent with a repository Agents secret.

GitHub Copilot MCP documentation
  1. In your GitHub repository, open Settings, then Copilot, then MCP servers.
  2. Add an Agents secret named COPILOT_MCP_POSTNERO_KEY and use your Postnero key as its value.
  3. Save the configuration below. Only enable it for a repository you trust because the coding agent can use allowed tools autonomously.
{
  "mcpServers": {
    "postnero": {
      "type": "http",
      "url": "https://postnero.com/mcp",
      "headers": {
        "Authorization": "Bearer ${COPILOT_MCP_POSTNERO_KEY}"
      },
      "tools": ["*"]
    }
  }
}

Using another agent?

Any agent that supports a remote Streamable HTTP MCP server with bearer authentication can connect to the same endpoint. Agents that make normal web requests can use the Postnero REST API.

Read the API referenceDownload the Postnero skill

ChatGPT and clients that require OAuth

Postnero currently uses a private API key in an HTTP header. Native MCP OAuth and a Postnero ChatGPT integration have not been released. Do not assume that ChatGPT web or desktop shares a Codex connection. Choose one of the documented clients that supports authenticated HTTP, or use the REST API from your own agent.

Before you start

Is Postnero’s TikTok MCP connection free?

Yes. The Free plan includes MCP and REST API access, a basic carousel editor, ten scheduled posts per calendar month and one connected account. Your own agent or model may charge separately. Pro adds advanced editor tools and higher posting allowances.

Does connecting an agent automatically publish anything?

No. A connection gives the agent tools it can use. Tell it to prepare drafts and wait for approval of the exact preview and publishing settings. Do not give broad unattended instructions until you have reviewed the workflow and your account’s limits.

What if my MCP client reports an authentication error?

Confirm the server URL is https://postnero.com/mcp and the client sends Authorization: Bearer followed by your private key. In Codex, the configured environment variable must be available to the process running Codex. Never put a key in the server URL. Replace a revoked key in Settings.

Can Postnero use my ChatGPT or Claude subscription to generate footage?

Postnero does not include a model or original footage generation. A compatible agent can write copy or prepare assets using its own available tools. Postnero’s video features are MP4 upload and silent carousel-to-video conversion.

Connect once. Then ask your agent to post.

Start free