Referência de ferramentas MCP do WordPress.com
Este texto foi traduzido usando IA. Se você deseja ver o texto original em inglês, clique aqui.
Este documento fornece um mapeamento completo das ferramentas MCP disponíveis para desenvolvedores WordPress.com. Este é um documento vivo e será atualizado conforme novas ferramentas forem adicionadas ou as existentes forem modificadas.
Para schemas exatos de entrada e saída, chame a própria ferramenta — toda facade STRAP expõe action: list (catálogo de operações) e action: describe (JSON Schema completo por operação). Os schemas evoluem, então sempre trate a resposta ao vivo do describe como a fonte da verdade.
Como as ferramentas MCP do WordPress.com são organizadas
O servidor MCP do WordPress.com expõe dois tipos de ferramentas:
- Ferramentas facade STRAP — Uma única ferramenta MCP que agrupa uma família de operações relacionadas em um único ponto de entrada. As facades usam uma interface uniforme baseada em ações (
action: list | describe | execute) para que agentes de IA descubram o que está disponível, busquem schemas de parâmetros e executem operações por meio de uma única ferramenta. Isso mantém o catálogo de ferramentas pequeno e previsível. - Ferramentas independentes — Ferramentas de propósito único que recebem parâmetros diretamente. Usadas para operações que não se encaixam em uma família maior (por exemplo, listar os sites do usuário, gerar uma URL de checkout).
⚠️ Protocolo de segurança: Todas as operações de escrita, atualização e exclusão exigem confirmação do usuário. O agente deve (1) descrever exatamente o que planeja fazer, (2) pedir confirmação explícita ao usuário e (3) incluir a confirmação do usuário como user_confirmed: true nos params de execução. Operações de escrita nunca são executadas automaticamente. Exclusões permanentes (termos de taxonomia) exigem adicionalmente confirm_permanent_delete: true.
Interface baseada em ações (facades STRAP)
Toda ferramenta facade STRAP aceita as mesmas três entradas de nível superior:
action(enum:list/describe/execute): O que o agente deseja fazer.list— Descobrir as operações disponíveis nesta ferramenta. Retorna nomes de operações, descrições curtas e motivos de operações desabilitadas.describe— Obter o JSON Schema completo (parâmetros, tipos, campos obrigatórios) de uma operação.execute— Executar uma operação.operation: O nome da operação no formatoresource.action(por exemplo,posts.create,theme.presets).params: Parâmetros específicos da operação. Operações de escrita devem incluiruser_confirmed: true.
A maioria das facades também requer wpcom_site (um ID de site ou URL). A facade wpcom-mcp-account é a exceção — ela opera sobre o usuário autenticado.
Todas as operações suportam um parâmetro opcional include_fields para limitar quais campos são retornados. Use-o para manter as respostas eficientes em termos de contexto.
Ferramentas da facade STRAP
Criação de Conteúdo ( wpcom-mcp-content-authoring )
Crie, leia, atualize e exclua conteúdo em um site WordPress.com — posts, páginas, comentários, mídia, categorias, tags, padrões de blocos e pesquisa de conteúdo.
💡 Sequência recomendada: Chame wpcom-mcp-site-editor-context primeiro (theme.active, theme.presets) para que o conteúdo use slugs de preset alinhados ao tema (ex.: "primary", "large") em vez de cores e tamanhos fixos no código.
Operações disponíveis
| Operação | Descrição |
|---|---|
posts.list | Listar posts com filtros opcionais (status, autor, pesquisa, taxonomia, intervalo de datas, ordenação, paginação). |
posts.get | Obter um post único por ID ou slug. Busca em páginas como fallback se o slug não corresponder a um post. |
posts.create | Criar um novo post — cria como rascunho por padrão. Escrita. |
posts.update | Atualizar um post existente. Apenas os campos fornecidos são alterados. Se o status for publish, as alterações entram no ar imediatamente. Escrita. |
posts.delete | Mover um post para a lixeira. Pode ser restaurado pelo painel do WordPress em até 30 dias. Escrita. |
pages.list | Listar páginas com filtros opcionais (página pai, status, pesquisa, ordenação, paginação). |
pages.get | Obter uma única página por ID ou slug. |
pages.create | Criar uma nova página — cria como rascunho por padrão. Suporta estruturas hierárquicas e templates de página. Escrita. |
pages.update | Atualizar uma página existente. Apenas os campos fornecidos são alterados. Se o status for publish, as alterações entram no ar imediatamente. Escrita. |
pages.delete | Mover uma página para a lixeira. Pode ser restaurada pelo painel do WordPress em até 30 dias. Escrita. |
comments.list | Listar comentários com filtros opcionais (status, post, autor, pesquisa, intervalo de datas, paginação). |
comments.get | Obter um único comentário por ID. |
comments.create | Criar um comentário em um post. Comentários de usuários autenticados preenchem automaticamente os campos de autor. Escrita. |
comments.update | Atualizar um comentário existente. Se o status for approved, as alterações ficam visíveis imediatamente. Escrita. |
comments.delete | Mover um comentário para a lixeira. Escrita. |
media.list | Listar itens de mídia com filtros opcionais (tipo MIME, post, autor, pesquisa, intervalo de datas, paginação). |
media.get | Obter um único item de mídia por ID. |
media.create | Fazer upload de um novo item de mídia (imagem, vídeo, áudio, documento). Escrita. |
media.update | Atualizar metadados do item de mídia (não o arquivo). Alterações em alt_text e caption são atualizadas imediatamente em todos os locais onde a mídia é usada. Escrita. |
media.delete | Mover um item de mídia para a lixeira. Pode quebrar conteúdo que o referencia. Escrita. |
categories.list | Listar categorias com filtros opcionais. |
categories.get | Obter uma única categoria por ID. |
categories.create | Criar uma nova categoria. Suporta relacionamentos hierárquicos pai-filho. Escrita. |
categories.update | Atualizar uma categoria existente. Alterar o slug afeta as URLs de arquivo imediatamente e pode quebrar links. Escrita. |
categories.delete | Excluir permanentemente uma categoria — termos de taxonomia não possuem lixeira. Posts atribuídos são movidos para Sem categoria; categorias filhas se tornam de nível superior. Requer confirm_permanent_delete: true. |
tags.list | Listar tags com filtros opcionais. A pesquisa de tags não diferencia maiúsculas de minúsculas. |
tags.get | Obter uma única tag por ID. |
tags.create | Criar uma nova tag. Escrita. |
tags.update | Atualizar uma tag existente. Alterar o slug afeta as URLs de arquivo imediatamente. Escrita. |
tags.delete | Excluir permanentemente uma tag — removida de todos os posts associados. Requer confirm_permanent_delete: true. |
patterns.list | Listar padrões de blocos disponíveis no site (tema, core, diretório de padrões). |
patterns.get | Obter um único padrão de bloco por nome, incluindo sua marcação de bloco. |
synced-patterns.list | Listar os padrões sincronizados (reutilizáveis) do site. |
synced-patterns.get | Obter um único padrão sincronizado por ID, incluindo sua marcação de bloco. |
content-search | Pesquisa de texto livre em todo o conteúdo do site (posts, páginas, outros tipos de post). |
⚠️ Operações destrutivas (posts.delete, pages.delete, comments.delete, media.delete, categories.delete, tags.delete) exigem que o agente busque e apresente o item sendo excluído (título, autor, quantidade de posts afetados) antes de solicitar confirmação.
💡 Dica: Ao criar páginas, use patterns.list → patterns.get para buscar padrões de blocos e compor páginas completas a partir de múltiplos padrões. Após cada criação ou atualização, verifique o campo _content_warnings da resposta — o WordPress pode remover blocos ou HTML durante o salvamento.
Contexto do Editor do Site ( wpcom-mcp-site-editor-context )
Consulte o contexto de design do site — predefinições do tema, estilos aplicados e tipos de blocos registrados. Complemento somente leitura da Criação de Conteúdo. Use-o antes de criar ou atualizar conteúdo para que a marcação utilize tokens alinhados ao tema em vez de valores fixos no código.
Essa fachada usa action: list | describe | get (não execute, já que nunca realiza gravações).
💡 Sequência recomendada: theme.active → theme.presets → (opcionalmente) blocks.allowed → depois crie conteúdo via wpcom-mcp-content-authoring.
Operações disponíveis
| Operação | Descrição |
|---|---|
theme.active | Obtém o slug da folha de estilos e o nome do tema ativo. Use o valor de stylesheet ao buscar theme.presets ou theme.styles. |
theme.presets | Obtém os tokens de design do site — paleta de cores, tamanhos de fonte, famílias de fontes, gradientes, escala de espaçamento. Resolve automaticamente a folha de estilos do tema ativo se omitida. |
theme.styles | Obtém os estilos aplicados do site a partir do theme.json — substituições em nível de bloco e tipografia/cores em nível de elemento. Complementa theme.presets: predefinições são quais tokens existem; estilos são como eles são aplicados. |
blocks.allowed | Lista os tipos de blocos registrados no site com nome, título, descrição, categoria e variações de estilo. Aplique uma variação de estilo como is-style-{name}. |
💡 Dica: Referencie slugs de predefinições na marcação de blocos — por exemplo, has-primary-color ou has-large-font-size — em vez de estilos inline com valores hexadecimais ou em pixels, para que o conteúdo se adapte quando os tokens de design do site mudarem.
⚠️ Importante: O fato de um bloco estar registrado não garante que sua marcação sobreviva inalterada ao pipeline de salvamento da REST API. Após cada criação ou atualização via wpcom-mcp-content-authoring, verifique o campo _content_warnings. Se a marcação foi removida, use alternativas de blocos mais simples ou pergunte ao usuário como proceder.
Account ( wpcom-mcp-account )
Gerencie a conta WordPress.com do usuário autenticado — perfil, notificações, conquistas, domínios, conexões, segurança e moeda. Opera no usuário que faz a chamada; nenhum parâmetro wpcom_site é necessário.
Operações disponíveis
| Operação | Descrição |
|---|---|
profile.get | Perfil básico (nome de usuário, e-mail, nome de exibição, avatar, idioma, fuso horário), opcionalmente com preferências, estatísticas, informações da conta e dados sociais/de atividade. |
profile.update | Atualizar campos do perfil (nome de exibição, bio, idioma, etc.). Escrita. |
notifications.get | Preferências de notificação em e-mail, push, timeline e outros canais. Inclui lista de dispositivos e teste de entrega. |
notifications.update | Atualizar configurações de notificação. Escrita. |
inbox.get | Caixa de entrada de notificações do usuário (mensagens, alertas, menções, curtidas, seguidores). Filtrar por tipo, não lidas, intervalo de tempo. |
achievements.get | Emblemas conquistados, feitos, progresso de gamificação e vitrine de troféus. |
domains.list | Listar os domínios do usuário autenticado em todos os sites. |
domains.get | Detalhes do domínio: capacidades de gerenciamento, configuração DNS, DNSSEC, status SSL, estado de manutenção. |
domains.dns_records | Registros DNS (A, AAAA, ALIAS, CAA, CNAME, MX, NS, SRV, TXT) para um único domínio. |
domains.set_primary | Definir um domínio personalizado como o domínio principal de um site. Escrita. |
connections.get | Conexões com redes sociais e serviços de terceiros (listar, obter detalhes, testar integridade). |
security.get | Status de segurança: 2FA, senhas de aplicativo, sessões ativas, histórico de login, idade da conta. |
currency.preview | Visualizar o impacto da alteração da moeda da conta (não efetiva a mudança). |
currency.change | Alterar a moeda da conta. Escrita. |
Site ( wpcom-mcp-site )
Gerencie um site WordPress.com — configurações, estatísticas, plugins, registro de atividade, temas e configuração de módulos Jetpack. Requer wpcom_site (ID do site ou URL).
Operações disponíveis
| Operação | Descrição |
|---|---|
settings.get | Configurações gerais, de escrita, leitura, discussão, mídia, links permanentes e privacidade. |
settings.update | Atualizar configurações do site. Escrita. |
statistics.get | Totais do site — posts publicados, páginas, assinantes — além de visualizações, visitantes, posts publicados e páginas publicadas opcionais para um intervalo de datas. NÃO inclui posts mais acessados, referenciadores, dados geográficos ou detalhamentos por URL. |
plugin.list | Plugins instalados com status, versão, disponibilidade de atualização e permissões. |
activity.get | Entradas do registro de atividade (posts, comentários, atualizações de plugins, backups, ações de usuários). Ordem cronológica reversa. Padrão dos últimos 6 meses. Filtrar por activity_group e activity_action. |
theme.list | Temas instalados no site. |
theme.set | Alternar o tema ativo. Escrita. |
monitor.status / monitor.activate / monitor.deactivate | Verificações de tempo de atividade do Jetpack Monitor. Ativar/desativar são escritas. |
newsletter.status / newsletter.get_settings | Status e configurações do Jetpack Newsletter. |
account-protection.status / account-protection.activate / account-protection.deactivate | Jetpack Account Protection. Ativar/desativar são escritas. |
manage-site.status / manage-site.launch / manage-site.set-visibility | Ciclo de vida do site — status de “em breve”, lançamento, visibilidade. Escritas. |
💡 Dica para activity.get: combine activity_group (ex.: ["plugin"]) e activity_action (ex.: ["activated", "deactivated"]) para refinar investigações. Faça a chamada sem filtros primeiro para descobrir o que está disponível para um determinado site.
Ferramentas independentes
Listar sites do usuário ( wpcom-user-sites )
Lista os sites acessíveis do usuário autenticado no WordPress.com e em sites auto-hospedados conectados ao Jetpack. Use esta ferramenta para descobrir IDs de sites antes de chamar ferramentas com escopo de site. Suporta paginação, pesquisa, filtros de status e privacidade, ordenação e métricas opcionais do site.
Pesquisar disponibilidade de domínio ( wpcom-domain-purchase )
Pesquise domínios disponíveis e gere links de checkout para registro no WordPress.com. Retorna domínios correspondentes com preços e URLs de checkout pré-configuradas.
Atualizar registros DNS ( wpcom-domain-update-dns-records )
Adicione ou remova registros DNS (A, AAAA, ALIAS, CAA, CNAME, MX, NS, SRV, TXT) de um único domínio personalizado que você gerencia.
⚠️ Operação destrutiva. Uma configuração incorreta de DNS pode quebrar e-mails e sites. Sempre busque os registros atuais (via wpcom-mcp-account → domains.dns_records) e descreva as diferenças antes de solicitar confirmação.
Restaurar registros DNS padrão ( wpcom-domain-restore-default-dns-records )
Restaura os registros A padrão do WordPress.com (IPs do apex) ou o CNAME padrão www para um único domínio personalizado. Controlado pela configuração “Atualizar registros DNS”.
Atualizar nameservers ( wpcom-domain-update-nameservers )
Define os nameservers para um único domínio personalizado. Requer que o chamador gerencie o site ao qual o domínio está conectado. Aceita entre 2 e 13 hostnames de nameserver válidos.
⚠️ Alterar os nameservers transfere o controle do DNS para fora do WordPress.com. E-mails, sites e outros serviços podem parar de funcionar se os novos nameservers não estiverem configurados para servir os mesmos registros.
Definir serviço de e-mail externo ( wpcom-domain-set-mail-service )
Configure registros DNS em um domínio para um serviço de e-mail externo: Google Workspace, iCloud Mail, Office 365 ou Zoho Mail.
⚠️ Sobrescreve os registros MX e registros DNS relacionados já existentes no domínio. O fluxo de e-mails existente para assim que os novos registros forem propagados.
Gerar URL de checkout ( wpcom-checkout-url )
Gere uma URL de checkout pré-configurada do WordPress.com para um ou mais produtos (nova compra) ou para a renovação de uma assinatura. A URL leva o usuário ao checkout do WordPress.com — o pagamento acontece no navegador, não por meio desta ferramenta.
Listar planos do WordPress.com ( wpcom-plans-list )
Liste os planos do WordPress.com com preços e listas de recursos por nível. Somente leitura; útil para apresentar as opções de plano antes de gerar uma URL de checkout.
Resumo do protocolo de segurança
Todas as operações de escrita/exclusão seguem um fluxo de confirmação obrigatório. O agente deve descrever a ação, obter a aprovação explícita do usuário e passar essa aprovação como user_confirmed: true nos params de execução.
| Comportamento | Leitura | Criação | Atualização | Exclusão (lixeira) | Exclusão (permanente) |
|---|---|---|---|---|---|
| Confirmação necessária | ❌ | ✅ | ✅ | ✅ | ✅ |
| Reversível | N/A | N/A | Parcialmente (valores anteriores perdidos) | ✅ Dentro de 30 dias | ❌ Permanente |
| Status padrão (conteúdo) | N/A | rascunho | Sem alteração | lixeira | Removido completamente |
| Flag adicional | — | — | — | — | confirm_permanent_delete: true |
Exclusões permanentes (termos de taxonomia como categorias e tags) também exigem confirm_permanent_delete: true nos params.
Formas aceitas de user_confirmed: o booleano true (preferido), ou uma das strings "true", "yes", "on", "1". Frases de aprovação em formato livre como "yes do it" são rejeitadas — o agente deve traduzir a aprovação do usuário em uma dessas formas aceitas.
Última atualização: junho 19, 2026
Recursos para desenvolvedores do WordPress.com 