Skip to content
← Back to integrations
MCP DOCUMENTATION

Your content workflow.
Connected to your AI.

Bring your Squiro workspace into the tools you already use. Prepare drafts, organize media, and manage your schedule—with your approval before publishing.

MCP server URL
https://mcp.getsquiro.com/mcp
Transport Streamable HTTPAuthentication OAuth 2.1Available tools 21 core tools
01 / GET CONNECTED

One workspace. One connection.

MCP lets an AI client use your existing Squiro account. It does not create a TikTok connection or expand your publishing permissions.

  1. Open your workspace. Sign in to Squiro. Connect a TikTok account in Accounts before preparing posts for it.
  2. Create an API key. In Squiro, open Settings and create a key. Copy it when shown; its full value is only displayed once.
  3. Connect your client. Add the server URL below using OAuth. In the browser’s Squiro consent page, paste your API key and approve the connection.
  4. Check the connection. Ask your agent to run check_connection before trying other tools.
Your key belongs on the consent page.

Never paste it into a chat, a server URL, or a client config file. The MCP endpoint accepts its OAuth access token, not a raw Squiro API key as a bearer token.

02 / YOUR TOOLS, YOUR CHOICE

Choose your client.

Every client connects to the same server. OAuth opens the Squiro consent page in your browser.

Claude Code

Verified with Squiro

Run this in your terminal, then open Claude Code.

Claude Code command
claude mcp add --transport http squiro https://mcp.getsquiro.com/mcp
  1. Run /mcp, choose squiro, and authenticate.
  2. Enter your Squiro API key on the browser consent page and approve.
  3. Ask Claude to run check_connection.

The default local scope keeps this connection out of the repository. Supported Claude Code sessions can show a publishing approval form in chat.

Claude Code MCP documentation ↗

Claude / claude.ai

Verified with Squiro
  1. Open Customize → Connectors → Add → Add custom connector.
  2. Name it Squiro and enter the MCP server URL. Use OAuth sign-in with the default client identity; no manually issued client secret is needed.
  3. Connect and enter your Squiro API key on the Squiro consent page.
  4. Enable the connector for the conversation and ask it to run check_connection.

Workspace accounts may require an administrator to add the connector first. Publishing approval happens in Squiro through the link returned by the tool.

Claude custom connector guide ↗

ChatGPT

Verified with Squiro
  1. Open ChatGPT Plugins, select the plus button, then Add custom MCP server.
  2. Enter Squiro as the name and add the public MCP URL, including /mcp. Configure OAuth authentication.
  3. Review the permissions and complete the creation flow. Enter your API key only on the Squiro consent page.
  4. Install the custom plugin, start a new conversation and select it using @. Ask it to run check_connection.

Custom MCP availability depends on your account and workspace policies. Use the returned Squiro link for publishing approval.

ChatGPT custom MCP setup guide ↗

Codex

Verified with Squiro
Codex commands
codex mcp add squiro --url https://mcp.getsquiro.com/mcp
codex mcp login squiro

Complete OAuth in your browser, entering your key only on the Squiro consent page. Then ask Codex to run check_connection. Publishing approval uses the Squiro link.

Codex MCP documentation ↗
Using another MCP client?

Add https://mcp.getsquiro.com/mcp as a remote Streamable HTTP server with OAuth discovery. Use the client’s browser sign-in flow. A client that accepts only a static API key cannot connect directly to this endpoint. In-chat publishing approval is currently restricted to supported Claude Code sessions; other clients receive a Squiro approval link.

03 / FROM DRAFT TO SCHEDULED

Your first scheduled post.

  1. Add your video. Upload it in Squiro, or use create_media_upload, send the file with the returned method and headers, then call complete_media_upload. The MCP server cannot read your local files itself.
  2. Prepare a draft. Use create_post with the account, uploaded video and optional caption. Nothing is published.
  3. Review the exact post. Call prepare_post_approval with the proposed time and zone. Review the account, full caption, video, settings and blockers.
  4. Approve and schedule. Use schedule_post with the preview’s version. Answer the supported Claude Code form, or open the returned Squiro link and choose Schedule with the intended time.
  5. Follow its progress. Use list_scheduled_posts and get_publish_status. After approval, Squiro handles sending the post even if the client disconnects, subject to account access and platform availability.
04 / JUST ASK

Start with a conversation.

Your agent discovers the tools. You can describe the task in plain language.

Example prompt
Which TikTok accounts do I have connected?
Example prompt
Show my drafts for this project.
Example prompt
Prepare a draft using this uploaded video. Don’t schedule it yet.
Example prompt
Show everything scheduled for this week.
Example prompt
Help me schedule this draft for tomorrow at 10:00 in Europe/Istanbul.
Example prompt
Check the publishing status of this post.
05 / TOOL REFERENCE

21 tools. One clear workflow.

These core tools are available by default. IDs are Squiro UUIDs returned by other tools. Paginated lists accept a limit up to 100 and return a cursor for the next page; reuse it unchanged with the same filters.

Connection

Tool & purposeInputs
check_connection

Check Squiro readiness and which user the connection acts as. Start here.

Read
RequiredNone

Accounts

Tool & purposeInputs
list_accounts

List connected TikTok accounts, connection status and project.

Read
RequiredNoneOptionalprojectId
get_account

Read one account and the counts of data that disconnecting it would delete.

Read
RequiredaccountId
check_account

Check the connection with TikTok and update the account’s name and status.

Update · TikTok
RequiredaccountId

Projects

Tool & purposeInputs
list_projects

List project summaries, target markets and caption template counts.

Read
RequiredNone
get_project

Read project guidelines, audiences, markets, instructions and templates.

Read
RequiredprojectId

Media

Tool & purposeInputs
create_media_upload

Create a media asset and a short-lived upload URL. The client sends the file separately.

Create
RequiredfileName, contentType, sizeBytesOptionalprojectId
complete_media_upload

Mark an uploaded file ready after storage has received it.

Update
RequiredmediaId
list_media

Find uploaded files and whether they can be used in a draft. Does not return download links.

Read
RequiredNoneOptionalmediaId, status, kind, projectId, limit, cursor
delete_media

Delete a file. Refused while a draft uses it.

Delete
RequiredmediaId

Drafts

Tool & purposeInputs
create_post

Create a draft from one video. Does not publish or choose publishing settings.

Create draft
RequiredaccountId, mediaAssetIdOptionalcaption
update_post

Change a draft’s caption or video using its current version. Changes require fresh approval.

Update
RequiredaccountId, draftId, expectedVersionOptionalcaption, mediaAssetId
list_drafts

List drafts with status, version and settings still to choose.

Read
RequiredNoneOptionalstatus, accountId, projectId, planId, tag, hook, format, limit, cursor
get_draft

Read the current state of one draft.

Read
RequiredaccountId, draftId
delete_draft

Delete a draft. Cancel a scheduled post before deleting its draft.

Delete
RequiredaccountId, draftId

Approval & scheduling

Tool & purposeInputs
prepare_post_approval

Prepare the exact preview, available settings, blockers and draft version for review. Contacts TikTok.

Preview · TikTok
RequiredaccountId, draftIdOptionalscheduledAt + timeZone (provide both or neither)
schedule_post

Request approval and schedule the reviewed draft. Clients without the supported form receive a Squiro approval link instead.

Approve · Schedule
RequiredaccountId, draftId, scheduledAt, timeZone, expectedVersion
reschedule_post

Move a scheduled post after fresh approval of the new time, keeping its settings.

Approve · Update
RequiredaccountId, draftId, scheduledAt, timeZone, expectedVersion
cancel_scheduled_post

Cancel a scheduled post. Cannot cancel a post TikTok has already accepted.

Cancel
RequiredaccountId, draftId

Tracking

Tool & purposeInputs
list_scheduled_posts

List posts with a scheduled time, soonest first. Defaults to posts still waiting to be sent.

Read
RequiredNoneOptionalstatus (array), accountId, projectId, planId, from, to, limit, cursor
get_publish_status

Read publishing status, failure reasons and next steps. Refresh can contact TikTok for a submitting or processing post.

Read · Optional refresh
RequiredaccountId, draftIdOptionalrefresh
What about analytics tools?

The server also defines list_posts, get_post_analytics, get_analytics_summary and sync_analytics. These are disabled by default and are not part of the 21-tool core workflow. Only rely on tools your connected client actually discovers.

06 / YOU HAVE THE FINAL SAY

Review first. Then schedule.

create_post creates a draft. Your agent does not choose your privacy, interaction or disclosure settings on your behalf.

Supported Claude Code sessions can display an approval form. The form identifies the video but does not show a video preview; inspect the video in Squiro when needed. Other clients receive a link to Squiro. To keep the proposed time, choose Schedule and set that time there; Post now publishes immediately.

Caption or video edits require a fresh preview and approval. Moving a scheduled post requires approval of its new time. A stale expectedVersion is refused so changes are not overwritten. In-chat approval is an interim client flow, not a claim of TikTok audit compliance.

TikTok access is still limited.

Until production access and audit approval, only eligible private test accounts can post, with “Only me” visibility. Public publishing is not currently available.

Current limits

  • A draft publishes one video, up to 1 GB. Photo posts and carousels are not supported.
  • The media library accepts MP4, WebM and MOV videos up to 4 GB, and JPEG/WebP images up to 20 MB. Library storage support does not mean an asset can be published.
  • Schedule at least 2 minutes and at most 30 days ahead. Use ISO 8601 with seconds and an offset, plus an IANA time zone such as Europe/Istanbul. A written offset must match the zone at that time.
  • Chat-only clients cannot send local files through this integration yet. Upload in Squiro first. Shell-capable clients can send the file using the generated upload command.
  • Upload URLs expire after about 15 minutes. Approval form state expires after 10 minutes; request a new preview and form if needed.
07 / GET BACK ON TRACK

When something gets stuck.

The connection fails or returns 401

Confirm the exact /mcp URL and use OAuth, not your raw API key as a bearer token. Run check_connection. If the Squiro key expired or was revoked, create a new key and reconnect through the browser consent page.

TikTok asks me to reconnect

Open Accounts in Squiro and reconnect the affected TikTok account. Saved data can still be readable even when publishing needs a renewed connection.

The draft changed / version conflict

Read the draft again, request a fresh approval preview, and review the current version before editing or scheduling. Do not blindly retry with the old version.

Claude Code doesn’t show the approval form

If the server connected mid-session, open /mcp and reconnect Squiro, then try again. If a form expired or the stream dropped, request a new preview and approval. Other clients should follow the Squiro link.

The video is not ready

Finish sending the file to storage, then call complete_media_upload. Check that it is a ready video within the 1 GB publishing limit. If the upload URL expired, start a new upload.

My schedule time was refused

Choose a time 2 minutes to 30 days ahead. Include seconds and a UTC offset or Z, and provide a matching IANA time zone. Check daylight-saving offsets for the date.

A scheduled post failed

Ask for get_publish_status and follow the returned next step. A schedule is not a guarantee of publication: expired account access, platform limits or a public account during the current test stage can block it. If settings saved but scheduling failed, the draft may remain unscheduled; check its status before retrying.

08 / MANAGE ACCESS

Disconnect on your terms.

Open MCP connections, enter your Squiro API key on that page, and revoke one connection or all of them. This lets you end one client’s access without deleting its underlying Squiro key.

To end access for every connection using a key, revoke that key in Squiro Settings. Those connections are rejected on their next tool call. Removing a server from a client’s configuration does not always revoke server-side access, so use the connections page when you want to be sure.

Revocation may take up to about 60 seconds to propagate across locations. Disconnecting a client does not cancel already scheduled posts; cancel those separately in Squiro.

Need a hand? support@getsquiro.com