Referência

Toolsets e modo somente leitura

Carregue só as ferramentas MCP do Emailit de que você precisa com toolsets, ou oculte todas as ferramentas de escrita com o modo somente leitura, por opções na URL ou cabeçalhos.

Atualizado em 2 de out. de 2026

Alguns clientes carregam um número limitado de ferramentas, e listas de ferramentas menores deixam os assistentes mais rápidos e precisos. Passe opções na URL do servidor ou como cabeçalhos para escolher o que o servidor expõe.

Opção	Parâmetro de consulta	Cabeçalho	Valores
Toolsets	`toolsets`	`X-MCP-Toolsets`	Nomes de toolsets separados por vírgula, ou `all`
Modo somente leitura	`read_only`	`X-MCP-Readonly`	`true`, `1`, `yes` ou `on`

Quando os dois são definidos, os cabeçalhos têm prioridade sobre os parâmetros de consulta.

Exemplos

Text

https://api.emailit.com/mcp?toolsets=emails,domains,events
https://api.emailit.com/mcp?read_only=true
https://api.emailit.com/mcp?toolsets=emails,domains&read_only=true

A última URL dá ao assistente acesso de leitura apenas a e-mails e domínios: ele pode consultar entregas e registros DNS, mas não pode enviar nem alterar nada.

Toolsets

Toolset	Abrange
`emails`	Enviar, listar, ler, reagendar, cancelar, tentar de novo e encaminhar e-mails
`domains`	Domínios de envio e verificação de DNS
`dmarc`	Relatórios DMARC agregados e forenses e estatísticas
`templates`	Templates, versões e publicação
`api_keys`	Chaves de API
`audiences`	Listas de contatos e os inscritos delas
`contacts`	Contatos, ações em massa e exportação
`suppressions`	A lista de supressão
`webhooks`	Webhooks, testes, segredos e novas tentativas
`campaigns`	Campanhas
`automations`	Automações, execuções e estatísticas
`forms`	Formulários de inscrição
`verification`	Verificação de e-mails e listas de verificação
`events`	O fluxo de eventos do workspace

O toolset workspace (get-current-workspace, list-workspaces, switch-workspace, create-workspace) é sempre incluído. Nomes de toolsets desconhecidos são ignorados; se nenhum dos nomes for válido, todos os toolsets são carregados.

Modo somente leitura

O modo somente leitura mantém as ferramentas do tipo Leitura e oculta tudo o que cria, atualiza, exclui, envia ou chama uma URL externa. switch-workspace continua disponível porque só altera o workspace padrão da conexão. Veja o tipo de cada ferramenta na referência de ferramentas.

O modo somente leitura é um bom padrão para assistentes de análise e para experimentar um cliente novo.