https://api.so-me.studio/mcp) e podem ser chamadas
por qualquer agente autenticado com a sua X-API-Key.
As 205 ferramentas estão disponíveis no único endpoint MCP público — não existe uma superfície
MCP de administração separada. Ferramentas como
create_tenant, delete_tenant e list_tenants são ferramentas
comuns do espaço de trabalho, restritas ao usuário autenticado.Os controllers admin/mcp-tool-costs e api-access/mcp são rotas do painel protegidas por JWT,
usadas para ver/editar os custos em créditos e os logs de uso de cada ferramenta — elas não expõem ferramentas
MCP adicionais.Cada chamada de ferramenta consome créditos do plano e conta para o seu limite de requisições por minuto. Consulte
os custos em tempo de execução com
list_mcp_tools e o seu saldo restante com
get_mcp_usage. Faixas de crédito: 1 ler/listar/obter, 2 escrever/alterar/excluir,
3 análises, 5 texto com IA, 8 imagem com IA, 10 ações compostas com IA.Enums comuns
Estes valores de enum são reutilizados em muitas ferramentas.platform (PLATFORM_ENUM)
platform (PLATFORM_ENUM)
TWITTER, INSTAGRAM, LINKEDIN, FACEBOOK, TIKTOK, YOUTUBE, THREADS, DRIBBBLE,
PINTEREST, WHATSAPP, LINKEDIN_PAGEstatus (STATUS_ENUM)
status (STATUS_ENUM)
POSTED, SCHEDULED, PENDING, FAILED, PENDING_APPROVAL, REJECTEDpostType (POST_TYPE_ENUM)
postType (POST_TYPE_ENUM)
TEXT, IMAGE, MULTIPLE_IMAGES, VIDEO, CAROUSEL, REEL, STORYOs padrões de paginação são consistentes entre as ferramentas de listagem:
page tem padrão 1, limit tem padrão
20 (máx. 100), a menos que uma ferramenta documente outro esquema (por exemplo, baseado em cursor ou offset).Publicações (11 ferramentas)
Fluxo de publicação
As ferramentas de escrita aceitam três campos opcionais além detext, fileIds e scheduledAt: threadParts, firstComment e tiktok. As descrições das ferramentas explicam o que cada campo faz; esta seção traz a ordem de operações recomendada para um agente que publica em nome de um usuário.
1
Verifique a mídia primeiro
Quando a mídia foi gerada, editada ou escolhida pelo agente, chame
validate_post_media com os
targets pretendidos antes de create_post ou schedule_post. Ele retorna, por destino, a
largura, a altura, a duração, o codec e a taxa de quadros medidos, os limites configurados e uma string fix
para cada divergência. Aplique a correção e valide de novo quando o agente tiver produzido o arquivo; mostre o
relatório e deixe o usuário decidir quando foi ele quem enviou o arquivo. Envie apenas valores medidos — toda
propriedade omitida volta como needs_review em vez de aprovada. get_media_rules retorna a
tabela completa por plataforma, que é a forma mais barata de já gerar a mídia no tamanho certo.2
Confirme os uploads
presign_media_upload reserva arquivos da biblioteca e retorna URLs PUT. Cada PUT deve enviar um
cabeçalho Content-Type igual ao mimetype declarado, ou o armazenamento responde 403. O upload só está
completo depois que os bytes são armazenados: chame get_media_file com verifyUpload: true antes de
anexar o arquivo a uma publicação.3
TikTok: pergunte ao criador, nunca adivinhe
O TikTok rejeita qualquer publicação sem nível de privacidade, e só o criador pode escolhê-lo. Chame
get_tiktok_creator_info para a conta de destino, ofereça ao usuário apenas os valores retornados em
privacy_level_options (uma conta privada não pode escolher PUBLIC_TO_EVERYONE), sugira
PUBLIC_TO_EVERYONE para uma conta pública, pergunte se os comentários são permitidos e então envie
{ privacyLevel, allowComments, allowDuet, allowStitch } no objeto tiktok. Uma publicação sem
tiktok.privacyLevel é rejeitada com TIKTOK_PRIVACY_LEVEL_REQUIRED; um nível que o criador não pode
usar retorna TIKTOK_PRIVACY_LEVEL_NOT_ALLOWED. Um aviso TIKTOK_SETTING_FORCED significa que o criador
desativou comentários, duetos ou stitch em toda a conta — repita isso ao usuário.4
Encadeamentos e primeiros comentários
threadParts cria um encadeamento de várias publicações somente no X, Threads, Bluesky e Mastodon: text é
a publicação inicial e threadParts[0] é a primeira resposta. A publicação além da inicial é feita com o melhor esforço;
informe metaData.threadPartWarning se ele estiver definido e nunca republique a publicação inicial. firstComment publica um
comentário sob a publicação (sob a última parte de um encadeamento) no Facebook, Instagram, X, LinkedIn,
Página do LinkedIn, Threads, YouTube, TikTok, Bluesky e Mastodon (o TikTok exige que o acesso a comentários da conta
esteja ativado em Contas). Verifique capabilities.firstComment em list_accounts antes de
prometer isso — um destino sem suporte ainda publica e retorna um aviso FIRST_COMMENT_UNSUPPORTED.
Leia firstCommentStatus na publicação antes de dizer que o comentário está no ar.Comentários da publicação (5 ferramentas)
Rascunhos (6 ferramentas)
Contas (3 ferramentas)
Mídia (13 ferramentas)
Caixa de entrada (18 ferramentas)
Aprovações (4 ferramentas)
Equipes (6 ferramentas)
Links na bio (19 ferramentas)
Conteúdo com IA (10 ferramentas)
Vídeo com IA / UGC (9 ferramentas)
Análises (26 ferramentas)
Multiplataforma e por publicação
Análises por plataforma
days tem padrão 7 (janela de análise retroativa) em todas as ferramentas de análises.Melhor horário para publicar (3 ferramentas)
Notificações (5 ferramentas)
Conhecimento / RAG (6 ferramentas)
Em
create_knowledge, fileId é obrigatório para os tipos de origem pdf/image/text_file, e
body é obrigatório para note.Canva (4 ferramentas)
Modelos (3 ferramentas)
Ajuda e suporte (5 ferramentas)
WhatsApp (6 ferramentas)
Auxiliares de integração (9 ferramentas)
Resolvem destinos específicos de cada plataforma (quadros, canais, subreddits, locais) antes de publicar.Webhooks (10 ferramentas)
As
categories de webhook aceitam: post, inbox, account, subscription, ai, team, support.
O filtro status de entrega aceita: pending, success, retrying, failed.
TWITTER,INSTAGRAM,LINKEDIN,LINKEDIN_PAGE,FACEBOOK,TIKTOK,YOUTUBE,THREADS,WHATSAPP,DRIBBBLE,PINTEREST