Visão geral do endpoint MCP do uPubly — transporte, autenticação e capacidades.
O uPubly expõe um servidor MCP (Model Context Protocol) para que agentes operem a plataforma em nome do usuário.
POST https://api.upubly.com/mcpTransporte Streamable HTTP (stateless). Cada request carrega a própria autenticação — não há sessão de servidor.
Authorization: Bearer <access_token>O token é o JWT do uPubly emitido pelo fluxo OAuth 2.1 + PKCE
(veja OAuth). Sem token ou com token inválido o endpoint
responde 401 com WWW-Authenticate apontando para o metadata de descoberta
(RFC 9728) — clients MCP resolvem o fluxo sozinhos a partir daí.
| Domínio | Tools |
|---|---|
| Publicações | post_accounts_list, post_list, post_create, post_delete |
| Storage | storage_request_upload, storage_complete_upload, storage_usage, media_upload_from_url |
| Marca (brain) | brand_get, brand_update_identity, brand_update_visual_identity, brand_update_memory, brand_add_document |
| Billing | plans_list, payment_link_create, credits_balance |
| UGC — geração | ugc_models_list, ugc_estimate, ugc_job_create, ugc_job_get, ugc_jobs_list, ugc_job_cancel, ugc_job_delete |
| UGC — avatares | ugc_avatar_options, ugc_avatar_randomize, ugc_avatars_list, ugc_avatar_get, ugc_avatar_create_upload, ugc_avatar_create_generated, ugc_avatar_update, ugc_avatar_delete, ugc_avatar_images_list, ugc_avatar_image_add, ugc_avatar_image_set_base, ugc_avatar_image_delete, ugc_avatar_sheets_list, ugc_avatar_sheet_generate |
| UGC — cenários | ugc_scenes_list, ugc_scene_create, ugc_scene_update, ugc_scene_delete |
| UGC — auxiliares | ugc_templates_list, ugc_projects_list |
Referência completa: Tools · UGC · Avatares · Geração de vídeo.
workspace_id é opcional em todas as tools de workspace — omitido, usa
o workspace default do usuário; informado, é validado contra a titularidade.isError com a mensagem — nunca
como erro de protocolo.structuredContent (objeto) + content[].text (JSON
pretty) — ambos equivalentes.