Codex config

UGC video MCP server for Codex

Codex stores the server in ~/.codex/config.toml, then opens a browser so you can sign in to UGC Pilot and approve the scopes.

105: live tools
OAuth: PKCE sign-in
HTTP: hosted server

Start Creating Copy the setup

Server URL

https://mcp.getugcpilot.com/mcp

First prompt

Use UGC Pilot to check my connection, plan, credits, and available generation options. Do not generate anything yet.

Copy-paste setup

Add the server to Codex

Codex

Codex page

Put this in ~/.codex/config.toml, or in .codex/config.toml for a trusted project. Then sign in.

~/.codex/config.toml

[mcp_servers.ugc-pilot]
url = "https://mcp.getugcpilot.com/mcp"
scopes = [
  "account:read",
  "brand:read",
  "assets:read",
  "assets:write",
  "generation:write",
  "jobs:read",
  "creative:write",
  "jobs:write"
]

codex mcp add ugc-pilot --url https://mcp.getugcpilot.com/mcp
codex mcp login ugc-pilot --scopes account:read,brand:read,assets:read,assets:write,generation:write,jobs:read,creative:write,jobs:write

Official guide: Codex MCP

OAuth

Each person approves their own account.

1The client requests the Streamable HTTP server and receives the protected-resource metadata.
2It starts an authorization-code flow with a S256 code challenge. UGC Pilot advertises dynamic client registration and client ID metadata documents.
3You sign in to UGC Pilot and approve the scopes on the consent screen. The token stays in the client.
4Later calls use that grant. account:write is a separate consent for account-default updates and is left out of the default setup.

Server URL: https://mcp.getugcpilot.com/mcp
Transport: Streamable HTTP
Issuer: https://mcp.getugcpilot.com
Protected resource: https://mcp.getugcpilot.com/.well-known/oauth-protected-resource
Authorization server: https://mcp.getugcpilot.com/.well-known/oauth-authorization-server
Consent screen: https://mcp.getugcpilot.com/oauth/authorize
Code challenge: S256
Client registration: Dynamic registration and client ID metadata documents

account:read
brand:read
assets:read
assets:write
generation:write
jobs:read
creative:write
jobs:write
account:write optional

Tool groups

105 tools, grouped by the job they do.

Names come from the registered server catalog. Some writes stay behind a live capability check. Open the reference for the description and scope of every tool.

Full tool reference

Account, plan, brand, and media

Identify the connected account, read the plan and credits, load the business profile, and retrieve owned images and videos.

get_profile · get_entitlements · get_saas_brand

Upload media

Reserve an upload, confirm the finished file, and delete an owned asset.

create_upload · confirm_upload · delete_asset

Generate images and video

Queue image and short-video jobs against the account plan, then read job status.

generate_image · generate_video · get_job

Finish a video

Compose hook text, trims, volume, framing, a demo clip, and optional subtitles on owned footage.

get_video_finishing_capabilities · finish_video · get_video_finish

Demo clips

register_demo · list_demos · get_demo

Recover uploads

Find an interrupted upload, list recent reservations, and renew one that is still valid.

get_upload · list_uploads · renew_upload

Operations

List owned work, read one operation, and cancel or retry it when the contract allows.

list_operations · get_operation · cancel_operation

Edit drafts

Open, list, read, and save the same video edit draft used in the studio.

list_edit_drafts · get_edit_draft · update_edit_draft

Export edits

Check export support, export one saved revision, and read that export.

get_edit_export_capabilities · export_edit_draft · get_edit_export

Speech and audio

Read audio readiness, list voices, generate speech, and manage private recordings.

get_audio_capabilities · list_audio_voices · list_audio_assets

Attach audio to video

Import an eligible recording onto a video edit and read that import.

import_audio_for_video · get_audio_video_import

References and remix

Browse reviewed references and remix their text into a new draft.

get_reference_capabilities · list_references · get_reference

Creative asset groups

Browse owned image and video groups and change membership when the write gate is open.

get_asset_group_capabilities · list_asset_groups · get_asset_group

Library

Read saved carousel and slideshow library items, and save or archive them when writes are enabled.

get_library_capabilities · list_library_items · get_library_item

Account defaults

Read account defaults and recover settings receipts. Default updates use a separate account:write consent.

get_account_settings_capabilities · get_account_settings · initialize_account_timezone

Business context

Read the business profile and recover context receipts. Draft and profile writes require their consent and rollout gate.

get_business_context_capabilities · get_business_context · save_business_context_draft

Business onboarding

Read saved onboarding progress and receipts. Requested onboarding changes require their consent and rollout gate.

get_business_onboarding_capabilities · get_business_onboarding · mutate_business_onboarding

Business logos

Read logo upload readiness and reservations. Upload and verification require their consent and rollout gate.

get_business_logo_upload_capabilities · create_business_logo_upload · get_business_logo_upload

Scheduling

Read owned connections and schedules. Schedule creation requires explicit confirmation, consent and its rollout gate.

get_scheduling_capabilities · list_social_connections · list_schedules

Saved social analytics

Read owner-scoped saved analytics snapshots with the required consent and verified identity. Reads do not refresh providers.

get_analytics_capabilities · get_instagram_account_analytics · get_instagram_content_analytics

Example prompts

Prompts that match the released tool contracts.

A production read on 15 October 2026 confirmed account reads, generation capability reporting, video-finishing capabilities, and edit-export capabilities. Ask the agent to read those capabilities before a paid generation.

Check the connection

“Use UGC Pilot to check my connection, plan, credits, and available generation options. Do not generate anything yet.”

get_profile · get_entitlements · get_capabilities

Create a product image

“Use UGC Pilot to generate one vertical product image of my skincare bottle on a bathroom shelf.”

generate_image · get_job

Animate that image

“Animate that image into one five-second vertical video with a slow camera push-in. Return the finished video link.”

generate_video · get_job · get_asset

Edit and export a revision

“Open this video in Edit, trim the first half-second, save the hook text, and export that saved revision.”

open_edit_draft · update_edit_draft · export_edit_draft · get_edit_export

Finish a hook and a demo

“Use my hook clip and demo clip, put the hook text on screen, and finish the video.”

get_video_finishing_capabilities · finish_video · get_video_finish

Questions

Where is the UGC Pilot MCP server?

The hosted server is https://mcp.getugcpilot.com/mcp. The transport is Streamable HTTP. Sign-in is OAuth with PKCE on https://mcp.getugcpilot.com. Put the URL in the client configuration and approve access in the browser. Do not paste an API key or access token into the chat.

How many tools does the server expose?

The public tool reference lists 105 tools, grouped by the job they perform, with each name, description, and OAuth scope. A client can keep an older cached list until you start a new conversation.

What does a connected agent do with my account?

It reads the signed-in account, plan, and credits, then creates images, short videos, speech, edit drafts, and exports when you ask. Generation uses that account's UGC Pilot plan and credits. You download the finished file and share it from the channel you already manage.

What goes in ~/.codex/config.toml?

Add a [mcp_servers.ugc-pilot] table with url = "https://mcp.getugcpilot.com/mcp" and the eight setup scopes. Leave bearer tokens out of the file. Run codex mcp login ugc-pilot if Codex has not already opened the consent screen.

Why does a new Codex thread miss the tools?

An open thread can keep the tool list it discovered at the start. Save the config, complete OAuth, then start a new thread and ask UGC Pilot to call get_profile. Re-authenticate when the sign-in expires or a requested scope is missing.

Keep going

MCP server

The hosted server, OAuth flow, and tool groups.

Claude setup

Custom connector steps for Claude on the web and desktop.

Connect your AI

Choose Claude, Codex, ChatGPT, or Claude Code.

Tool reference

All 105 tools, copied from the registry.

Pricing

Trial credits and the Starter and Growth plans.

Founder guides

Message, format, and review routines for the product.