Apps de IA (MCP)
Tools da conta
Todas as tools do servidor da conta. A lista que seu app vê depende das permissões que você concedeu.
- 75 tools
- 10 grupos
https://g.sendcorex.com/mcp/accountDomínios
10domain_listListar domínios de envio
Lista todos os domínios de envio da conta (leve, sem checagem de DNS ao vivo).
Só leituradomain:readdomain_getObter domínio e checar DNS
Retorna um domínio com os registros DNS a publicar e checa o DNS ao vivo: marca o domínio como validado assim que Return-Path (CNAME) e DKIM estão publicados, e promove uma chave DKIM de 2048 bits pendente quando o novo registro TXT dela fica visível.
Só leituradomain:readdomain_list_freeListar domínios gratuitos compartilhados
Lista os domínios compartilhados que podem ser usados para criar um remetente sem ter um domínio (passe um deles como domain em sender_create).
Só leituradomain:readdomain_send_dns_instructionsEnviar instruções de DNS por email
Envia por email, para qualquer endereço, os registros DNS (SPF, DKIM, Return-Path, DMARC) necessários para um domínio, ex.
Altera dadosdomain:readdomain_addAdicionar domínio de envio
Adiciona um domínio de envio à conta e gera a chave DKIM dele; o domínio começa não validado até os registros DNS retornados serem publicados (depois verifique com domain_get).
Altera dadosdomain:createdomain_start_dkim_upgradeIniciar upgrade do DKIM para 2048 bits
Começa a trocar uma chave DKIM de 1024 bits por uma de 2048 bits em um novo seletor; a chave antiga continua assinando até o novo registro TXT (dns_records.dkim_pending) ser publicado, e depois disso domain_get promove a nova automaticamente.
Altera dadosdomain:createdomain_cancel_dkim_upgradeCancelar upgrade do DKIM
Cancela um upgrade de DKIM para 2048 bits pendente e descarta a chave pendente; a chave atual continua em uso.
Pede confirmaçãodomain:createdomain_update_descriptionDefinir descrição do domínio
Define ou limpa a descrição em texto livre (nota interna) de um domínio; uma string vazia ou null limpa.
Altera dadosdomain:createdomain_request_remediationPedir revisão de blocklist
Envia um pedido de revisão manual para um domínio que domain_add rejeitou como BLACKLISTED; depois de aprovado, domain_add pode ser tentado de novo.
Altera dadosdomain:createdomain_deleteExcluir domínio de envio
Exclui permanentemente um domínio, suas chaves DKIM e TODOS os remetentes dele; isso não pode ser desfeito.
Pede confirmaçãodomain:delete
Remetentes
6sender_listListar remetentes
Lista todos os remetentes (endereços de envio) da conta.
Só leiturasender:readsender_getObter remetente
Retorna um remetente pelo sender_id, com os mesmos campos de um item de sender_list (incluindo a reputação).
Só leiturasender:readsender_createCriar remetente
Cria o remetente username@domain em um domínio validado da conta, ou em um domínio compartilhado de domain_list_free.
Altera dadossender:createsender_updateAtualizar remetente
Altera o from_name e/ou o reply_to de um remetente (pelo menos um deve ser enviado; username e domain não podem mudar).
Altera dadossender:updatesender_update_descriptionDefinir descrição do remetente
Define ou limpa a descrição em texto livre (nota interna) de um remetente; uma string vazia ou null limpa.
Altera dadossender:updatesender_deleteExcluir remetente
Exclui um remetente permanentemente; isso não pode ser desfeito.
Pede confirmaçãosender:delete
Templates
8template_listListar templates
Lista os templates de email da conta (atualizados mais recentemente primeiro), com filtro opcional por tipo (unlayer, custom ou html).
Só leituratemplate:readtemplate_getObter template
Obtém um template pelo template_id (html_<uuid>, unlayer_<number> ou custom_<uuid>), incluindo o conteúdo.
Só leituratemplate:readtemplate_renderRenderizar template
Renderiza um template substituindo os placeholders {{variable}} pelos valores informados (com escape HTML no html, brutos no subject e no text) para pré-visualizar o que será enviado.
Só leituratemplate:readtemplate_list_versionsListar versões do template
Lista as versões salvas de um template (cada atualização guarda uma versão; só as 10 últimas são mantidas).
Só leituratemplate:readtemplate_createCriar template HTML
Cria um novo template do tipo html a partir do seu próprio HTML (máx. 512 KB; conteúdo inseguro é rejeitado).
Altera dadostemplate:createtemplate_updateAtualizar template HTML
Atualiza um template do tipo html: envie pelo menos um entre name, html, text ou subject (text/subject null os limpa).
Pede confirmaçãotemplate:updatetemplate_restore_versionRestaurar versão do template
Restaura um template do tipo html para uma versão anterior, sobrescrevendo o conteúdo atual.
Pede confirmaçãotemplate:updatetemplate_deleteExcluir template HTML
Exclui permanentemente um template do tipo html (templates Unlayer e Custom só podem ser excluídos no dashboard: TEMPLATE_READ_ONLY).
Pede confirmaçãotemplate:delete
Logs de email
2logs_listListar logs de email
Busca nos logs de emails enviados da conta (API, SMTP e campanhas; warmup excluído), mais recentes primeiro, com filtros combinados por AND; a janela padrão são os últimos 60 dias.
Só leituralogs:readlogs_getObter logs de email por id
Busca logs de email pelo id do email (UUID), até 50 por chamada ou 10 com include_content=true (adiciona content.html, o HTML enviado).
Só leituralogs:read
Bounces e reclamações
2feedback_listListar eventos de feedback
Lista eventos de bounce, reclamação e email descartado da conta, mais antigos primeiro (retenção de 90 dias), para sincronizar supressões: guarde next_cursor e passe na próxima chamada (has_more=true significa que há mais prontos agora).
Só leiturafeedback:readfeedback_get_emailObter feedback de um email
Obtém os eventos de feedback de um email enviado pelo email_id: no máximo um bounce, uma reclamação e um evento de descarte.
Só leiturafeedback:read
Contadores
5counters_get_totalsObter totais de todos os tempos
Obtém os contadores de envio de todos os tempos da conta, somando API, SMTP e campanhas.
Só leituracounters:readcounters_get_monthObter contadores do mês
Obtém os contadores de envio de um mês do calendário (UTC); por padrão, o mês atual.
Só leituracounters:readcounters_get_monthsObter contadores por mês
Obtém os contadores de envio por mês (UTC) para um intervalo de meses, mais o total do período; omita from/to para um intervalo aberto (todos os meses).
Só leituracounters:readcounters_get_dailyObter contadores por dia
Obtém os contadores de envio por dia em um intervalo de datas (ambas inclusivas, máx. 400 dias), com os dias cortados no fuso horário IANA informado (padrão UTC).
Só leituracounters:readcounters_get_hourlyObter contadores por hora
Obtém os contadores de envio por hora UTC entre dois instantes (no máx. 7 dias de distância).
Só leituracounters:read
Contatos
30contacts_getObter contatos por email
Busca até 100 contatos pelo endereço de email exato.
Só leituracontact:readcontacts_queryConsultar contatos
Busca/filtra contatos com um filtro 'where' e ordenação opcional, paginado (limit 1–1000, padrão 50).
Só leituracontact:readcontacts_countContar contatos
Conta os contatos que batem com um filtro 'where' (o mesmo filtro de contacts_query), parando em 'max' (padrão 100000).
Só leituracontact:readcontacts_list_eventsListar eventos do contato
Lista a linha do tempo de atividade de um contato (envio, abertura, clique, bounce, reclamação, descadastro), mais recentes primeiro, paginada (limit 1–1000, padrão 50).
Só leituracontact:readcontacts_get_statsObter totais de contatos
Contadores de contatos da conta inteira sem varredura: retorna {total, status: {status: n}, lists: {list_id: {total, ok, opened, clicked}}, tags: {tag: n}}.
Só leituracontact:readcontacts_list_fieldsListar campos personalizados
Lista as definições de campos personalizados de contato da conta (key, name, type, options, created_at, updated_at).
Só leituracontact:readcontacts_define_fieldDefinir campo personalizado
Cria um campo personalizado de contato, ou atualiza o name/options de um existente (o type não pode mudar).
Altera dadoscontact:createcontacts_delete_fieldExcluir campo personalizado
Exclui a definição de um campo personalizado e apaga os valores dele de todos os contatos em segundo plano (irreversível).
Pede confirmaçãocontact:deletecontacts_list_listsListar listas de contatos
Lista todas as listas de contatos, mais antigas primeiro.
Só leituracontact:readcontacts_get_listObter lista de contatos
Obtém uma lista com as estatísticas dos membros {total, ok, opened, clicked}.
Só leituracontact:readcontacts_list_membersListar membros da lista
Pagina os membros de uma lista: cada membro tem email, sendable, subscribed, added_at e, com hydrate true, o contato completo.
Só leituracontact:readcontacts_create_listCriar lista de contatos
Cria uma lista de contatos (o id é gerado, a não ser que list_id seja informado).
Altera dadoscontact:createcontacts_update_listAtualizar lista de contatos
Atualiza os atributos de uma lista; só os args informados mudam, e null/"" limpa um atributo opcional.
Altera dadoscontact:updatecontacts_delete_listExcluir lista de contatos
Exclui uma lista: ela some na hora e as associações dela são removidas dos contatos em segundo plano (os contatos em si são mantidos).
Pede confirmaçãocontact:deletecontacts_list_segmentsListar segmentos
Lista os segmentos salvos (segment_id, name, where, sort, created_at, updated_at).
Só leituracontact:readcontacts_get_segmentObter segmento
Obtém a definição de um segmento salvo (segment_id, name, where, sort, created_at, updated_at).
Só leituracontact:readcontacts_run_segmentExecutar segmento
Retorna os contatos que batem agora com um segmento salvo (o where + sort dele), paginado como contacts_query (limit 1–1000, padrão 50).
Só leituracontact:readcontacts_save_segmentSalvar segmento
Cria um segmento salvo, ou substitui o name/where/sort de um existente quando segment_id é informado (omitir sort o limpa).
Altera dadoscontact:createcontacts_delete_segmentExcluir segmento
Exclui a definição de um segmento salvo (os contatos não são afetados).
Pede confirmaçãocontact:deletecontacts_upsertCriar ou atualizar contatos
Cria ou atualiza até 500 contatos pelo email; só os atributos informados mudam (null limpa um atributo ou campo do perfil).
Altera dadoscontact:createcontact:updatecontacts_updateAtualizar contatos existentes
Igual a contacts_upsert, mas nunca cria: emails sem contato falham com NOT_FOUND.
Altera dadoscontact:updatecontacts_add_tagsAdicionar tags aos contatos
Adiciona tags a até 500 contatos existentes.
Altera dadoscontact:updatecontacts_remove_tagsRemover tags dos contatos
Remove tags de até 500 contatos existentes.
Pede confirmaçãocontact:updatecontacts_add_to_listsAdicionar contatos às listas
Adiciona até 500 contatos existentes a uma ou mais listas (como membros inscritos).
Altera dadoscontact:updatecontacts_remove_from_listsRemover contatos das listas
Remove até 500 contatos existentes de uma ou mais listas (desfaz a associação; para mantê-la mas parar de enviar, use contacts_set_list_subscription).
Pede confirmaçãocontact:updatecontacts_set_list_subscriptionDefinir inscrição na lista
Inscreve ou descadastra até 500 contatos dentro de uma lista (a associação é mantida; membros descadastrados não recebem envios dessa lista).
Altera dadoscontact:updatecontacts_set_statusDefinir status do contato
Define o status global de até 500 contatos (subscribed, unsubscribed, bounced, complained, blocked); só contatos subscribed recebem envios.
Altera dadoscontact:updatecontacts_set_fieldsDefinir valores de campos personalizados
Define valores de campos personalizados em até 500 contatos (os mesmos valores para todos).
Altera dadoscontact:updatecontacts_unset_fieldsLimpar valores de campos personalizados
Remove valores de campos personalizados (pela key) de até 500 contatos; as definições dos campos continuam.
Pede confirmaçãocontact:updatecontacts_deleteExcluir contatos
Exclui permanentemente até 500 contatos (perfil, campos, tags, associações a listas).
Pede confirmaçãocontact:delete
Preferências de tracking
5privacy_get_preferencesObter preferências de tracking do destinatário
Retorna a preferência de tracking de aberturas/cliques que um destinatário escolheu (pela página de privacidade, pelo dashboard ou pela API).
Só leituraprivacy:readprivacy_get_manyObter preferências de tracking de vários destinatários
Consulta em lote as preferências de tracking de aberturas/cliques de 1 a 100 destinatários.
Só leituraprivacy:readprivacy_get_historyObter histórico de preferências do destinatário
Retorna o histórico de mudanças das preferências de tracking de um destinatário, mais recentes primeiro.
Só leituraprivacy:readprivacy_list_changesListar mudanças de preferências de tracking
Feed incremental de todas as mudanças de preferência de destinatários da conta (mais antigas primeiro, últimos 90 dias), para sincronizar com um CRM.
Só leituraprivacy:readprivacy_set_preferencesDefinir preferências de tracking do destinatário
Registra a escolha de tracking de aberturas e/ou cliques de um destinatário (source "api"); um campo omitido mantém o valor atual, e pelo menos um entre track_opens/track_clicks é obrigatório.
Altera dadosprivacy:write
Validação de email
5validator_validate_emailValidar um endereço de email
Valida por completo um endereço de email (sintaxe, domínio/MX, descartável, erro de digitação e checagem de entregabilidade SMTP ao vivo); custa 1 crédito de validação (resultados em cache dentro de 5 min também são cobrados) e pode levar até ~40s.
Altera dadostools:validatevalidator_validate_emailsValidar um lote de emails
Valida por completo até 50 endereços de email em uma chamada (as mesmas checagens de validator_validate_email, incluindo SMTP); pode levar até ~110s.
Altera dadostools:validatevalidator_list_validationsListar validações anteriores
Lista o histórico de validações de email da conta, mais recentes primeiro, com filtro opcional por um endereço de email; grátis (sem créditos).
Só leituratools:validatevalidator_check_disposableChecar domínio de email descartável
Verifica se um endereço de email ou domínio pertence a um provedor de email descartável/temporário (checagens de DNS e reputação, sem SMTP); passe email ou domain (pelo menos um).
Altera dadostools:validatevalidator_list_disposable_checksListar checagens de descartável anteriores
Lista o histórico de checagens de descartável da conta, mais recentes primeiro; grátis (sem créditos).
Só leituratools:validate
Enviar email
2email_sendEnviar email transacional
Envia um email transacional pela Email API da Sendcorex (igual ao POST /v3.0/send): validação, anti-spam, créditos (1 por destinatário) e limite diário, tracking, listas de contatos, agendamento.
Pede confirmaçãoemail:sendemail_cancel_scheduledCancelar email agendado
Cancela um email agendado com email_send + scheduled_at, antes de ele ser enviado.
Altera dadosemail:send