Tools do MCP

Todas as tools do servidor MCP, agrupadas por domínio. Argumentos em negrito são obrigatórios. Toda tool de escrita (write) aceita também dry_run e idempotency_key (veja as convenções).

Uma chave só enxerga as tools cujo escopo ela tem. Os escopos conversations:write, agents:run e agent_tools:execute só podem ser concedidos por um administrador da conta.

Contatos

Tool	Escopo	Tipo	Argumentos
contacts_search	contacts:read	leitura	query, email, phone, company, source, tag_ids, created_after, created_before, updated_after, updated_before, sort_by, sort_order, page, limit
contacts_get	contacts:read	leitura	contact_id
contacts_create	contacts:write	escrita	name, email, phone, company, title, location, linkedin_profile_url, source, custom_fields, tag_ids
contacts_update	contacts:write	escrita	contact_id, name, email, phone, company, title, location, linkedin_profile_url, custom_fields
contacts_add_tags	contacts:write	escrita	contact_id, tags, create_missing
contacts_remove_tags	contacts:write	escrita	contact_id, tags
contacts_add_note	contacts:write	escrita	contact_id, content

Oportunidades

Tool	Escopo	Tipo	Argumentos
opportunities_search	opportunities:read	leitura	query, pipeline_id, stage_id, owner_user_id, contact_id, campaign_id, company, created_after, created_before, updated_after, updated_before, sort_by, sort_order, page, limit
opportunities_get	opportunities:read	leitura	opportunity_id, include_history
opportunities_create	opportunities:write	escrita	contact_id, name, email, phone, company, title, pipeline_id, stage_id, value, score, notes, owner_user_id, sector_id, campaign_id, source, custom_fields, activate_agent_id, enroll_in_flow_id
opportunities_update	opportunities:write	escrita	opportunity_id, title, value, score, notes, owner_user_id, sector_id, expected_close_date, probability, custom_fields
opportunities_move_stage	opportunities:write	escrita	opportunity_id, stage_id, stage_name, pipeline_name, discard_reason_id, notes

Conversas (inbox)

Tool	Escopo	Tipo	Argumentos
conversations_list	conversations:read	leitura	contact_id, opportunity_id, status, created_after, created_before, updated_after, updated_before, last_message_after, last_message_before, page, limit
conversations_get	conversations:read	leitura	conversation_id, messages_limit
conversations_send_message	conversations:write	escrita	conversation_id, content, pause_ai
conversations_add_note	conversations:write	escrita	conversation_id, content
conversations_take_control	conversations:write	escrita	conversation_id, reason

Dados de referência

Tool	Escopo	Tipo	Argumentos
pipelines_list	pipelines:read	leitura	include_inactive
tags_list	tags:read	leitura
users_list	users:read	leitura	role, is_active

Relatórios

Tool	Escopo	Tipo	Argumentos
reports_funnel	reports:read	leitura	pipeline_id, sector_id
reports_sales_summary	reports:read	leitura	pipeline_id, sector_id, owner_user_id, from, to

Funcionários de IA

Tool	Escopo	Tipo	Argumentos
agents_list	agents:read	leitura	include_inactive
agents_chat_start	agents:run	escrita	agent_id, lead_simulation
agents_chat_send	agents:run	escrita	session_id, message, event
agents_chat_end	agents:run	escrita (destrutiva)	session_id
knowledge_search	knowledge:read	leitura	query, limit, type, agent_id, contact_id
agent_register_lead_source	agent_tools:execute	escrita	source, campaign, adset, creative, contact_id
agent_send_email	agent_tools:execute	escrita	subject, body, contact_id, agent_id
agent_transfer_to_human	conversations:write	escrita	reason, farewell_message, agent_id, conversation_id, contact_id
agent_schedule_meeting	agent_tools:execute	escrita	message_prefix, agent_id, conversation_id, contact_id
agent_check_availability	agent_tools:execute	leitura	skip_days, agent_id, conversation_id, contact_id
agent_book_meeting	agent_tools:execute	escrita	slot_id, title, agent_id, contact_id, conversation_id

Notas por tool

• contacts_search / opportunities_search — query é busca parcial em texto livre (nome, e-mail, empresa / título, contato). Combine updated_after com sort_by=updated_at para sincronização incremental.
• contacts_create — exige name e pelo menos um entre email, phone e linkedin_profile_url; contato com o mesmo e-mail devolve DUPLICATE_ERROR.
• contacts_update — custom_fields substitui o objeto inteiro; etiquetas são gerenciadas por contacts_add_tags / contacts_remove_tags.
• contacts_add_tags — nomes de etiqueta, sem diferenciar maiúsculas. Nome desconhecido devolve TAG_NOT_FOUND, a menos que create_missing: true (exige tags:write). Adicionar etiqueta dispara as mesmas automações do app (fluxos de e-mail, tracking).
• opportunities_create — passe contact_id para vincular um contato existente, ou name/email/phone/company para achar-ou-criar um (casado por e-mail). Sem pipeline_id/stage_id o negócio entra na primeira etapa do funil padrão da conta. Sem owner_user_id o rodízio da conta define o dono; o agente de entrada do funil é ativado como no app.
• opportunities_update — custom_fields faz merge. Mudança de etapa é por opportunities_move_stage.
• opportunities_move_stage — por stage_id ou por stage_name (o funil da própria oportunidade tem preferência; acrescente pipeline_name para desempatar, senão AMBIGUOUS). Grava histórico, marca ganho/perda e atualiza o Kanban em tempo real.
• conversations_list — status é um de ai_active, manual, closed; use archived: true|false para filtrar arquivadas.
• conversations_send_message — só texto; envia pelo canal da conversa (WhatsApp, LinkedIn, Instagram, e-mail, webchat). Por padrão pausa o funcionário de IA daquela conversa (pause_ai); ai_paused no resultado diz se pausou de fato, com pause_reason quando não (ex.: already_manual, no_agent).
• conversations_take_control — status manual, IA pausada, follow-ups agendados cancelados, evento control_taken registrado. Libere o controle pelo inbox.
• reports_* — mesmas definições dos relatórios do app: ativa = não perdida/descartada, ganha = ativa numa etapa de ganho.
• As tools de funcionários de IA estão descritas na página Funcionários de IA.

Resources

URI	Escopo	Conteúdo
getraze://account	qualquer chave conectada	Id, nome e tipo da conta, módulos habilitados e escopos da chave
getraze://pipelines	pipelines:read	Funis com etapas ordenadas
getraze://tags	tags:read	Etiquetas com contagem de uso
getraze://users	users:read	Membros da equipe
getraze://sectors	sectors:read	Setores (times)
getraze://agents	agents:read	Funcionários de IA com fluxo
getraze://tool-catalog	agents:read	As tools nativas que um funcionário de IA pode usar, com JSON Schema

Prompts

Prompt	Argumentos	O que faz
qualify_lead	contact_id, pipeline_name	Lê o contato, as conversas e as oportunidades e propõe etiquetas e mudança de etapa — sem executar
daily_pipeline_review	pipeline_id, owner_user_id	Funil + últimos 7 dias + negócios parados, com três ações sugeridas