Skip to content
UGC API

MCP server

UGC API has a remote MCP server, so an AI assistant can post and schedule UGC for you. Ask in plain words, review what it plans, and it publishes through the same API, credits and rules as your code.

Updated

Connect

  • Server URL: https://ugcapi.dev/mcp (Streamable HTTP).
  • Claude: Settings → Connectors → Add custom connector, paste the URL, then sign in and click Allow. Or install the UGC API plugin from the Claude directory.
  • ChatGPT, Cursor and others: add a remote MCP server with the same URL. They register themselves and send you through sign-in.
  • Sign-in: OAuth 2.1 with PKCE. You sign in with your UGC API email code and approve the app on our consent screen. Tokens last an hour and refresh automatically; disconnect any time from the app.

Tools

ToolWhat it doesChanges things
get_account_overviewCredits, posts published this month, connected accounts per platformNo
list_accountsConnected social accounts and their idsNo
get_creator_infoWho a post goes out as and the privacy choices TikTok allowsNo
create_connect_linkA link to connect a TikTok, Instagram, Facebook Page or YouTube accountCreates a link
upload_media_from_urlCopies a public video or image into UGC API storageStores a file
publish_postPublishes one post to one or more accounts, now or at a timePublishes; uses credits
preview_campaignThe schedule and credits for many posts over many accountsNo
create_campaignSchedules that campaignSchedules; reserves credits
list_posts, get_postPosts with filters, and one post's results and URLsNo
cancel_post, cancel_campaignStops what hasn't gone out and refunds itCancels
retry_postResends failed resultsPublishes; uses credits
list_campaigns, get_statsCampaign progress, and results by status, platform and dayNo

Safeguards

  • The assistant is told to confirm accounts, caption and time with you before publishing, and to preview campaigns first.
  • For TikTok it must show the creator nickname and ask you to choose the privacy level. A TikTok post without a privacy choice is refused.
  • Everything else works like the API: credits are reserved per result and refunded on failure or cancel. See create a post and campaigns.

Try it

  • "Which accounts do I have connected, and how many credits are left?"
  • "Post https://example.com/clip.mp4 to my TikTok and as an Instagram Reel plus Story. Caption: Morning routine in 19 seconds #ugc"
  • "Plan these 12 videos across my two TikTok accounts, one a day at 10:00 New York time from Monday. Show me the plan before scheduling."
  • "What failed this week and why?"

FAQ

Can the assistant post without asking me?

Its instructions say to confirm before publishing, and Claude asks before using tools that make changes unless you allowed them. Review the plan it shows you.

Can I attach a video in the chat?

Not directly. The server needs a public https URL. Upload the file to the dashboard composer, or host it and paste the link.

Does it cost extra?

No. Posts made through MCP use the same credits as the API: $10 per 1,000 posts.

Related