Pular para o conteúdo principal
O servidor MCP do Social media studio expõe 205 ferramentas, agrupadas abaixo por área. Todas as ferramentas listadas abaixo estão registradas no endpoint MCP padrão (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.
TWITTER, INSTAGRAM, LINKEDIN, LINKEDIN_PAGE, FACEBOOK, TIKTOK, YOUTUBE, THREADS, WHATSAPP, DRIBBBLE, PINTEREST
TWITTER, INSTAGRAM, LINKEDIN, FACEBOOK, TIKTOK, YOUTUBE, THREADS, DRIBBBLE, PINTEREST, WHATSAPP, LINKEDIN_PAGE
POSTED, SCHEDULED, PENDING, FAILED, PENDING_APPROVAL, REJECTED
TEXT, IMAGE, MULTIPLE_IMAGES, VIDEO, CAROUSEL, REEL, STORY
Os 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 de text, 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)

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.

Planos, faturamento e uso (6 ferramentas)

Indicações (2 ferramentas)

Chaves de API (3 ferramentas)

Tenants / Espaços de trabalho (4 ferramentas)

Perfil e preferências (5 ferramentas)

Organização (2 ferramentas)

Introspecção do MCP (2 ferramentas)

Exemplos de uso