Tools

These tools are generated from the same register as the REST API. A connection only sees the tools its permissions allow.

Tool	What it does	Permission	Effect	REST operationId
`add_conversation_note`	Create conversation note	`inbox:write`	Write (no outside effect)	`create_conversation_note`
`apply_landing_page_ops`	Edit landing page draft	`landing:write`	Write (no outside effect)	`apply_landing_page_ops`
`control_newsletter`	Control newsletter send	`newsletters:send`	Send (reaches other people)	`control_newsletter`
`export_contacts`	Create contact export	`contacts:read`	Write (no outside effect)	`create_contact_export`
`get_account_overview`	Get account overview	`account:read`	Read	`get_account_overview`
`get_ai_reply_settings`	Get AI reply settings	`ai:settings_read`	Read	`get_ai_reply_settings`
`get_automation`	Get automation	`automations:read`	Read	`get_automation`
`get_automation_catalog`	Get automation catalog	`automations:read`	Read	`get_automation_catalog`
`get_business_profile`	Get business profile	`settings:read`	Read	`get_business_profile`
`get_contact`	Get contact	`contacts:read`	Read	`get_contact`
`get_conversation`	Get conversation	`inbox:read`	Read	`get_conversation`
`get_landing_catalog`	Get landing catalog	`landing:read`	Read	`get_landing_catalog`
`get_landing_page`	Get landing page	`landing:read`	Read	`get_landing_page`
`get_newsletter`	Get newsletter	`newsletters:read`	Read	`get_newsletter`
`get_send_status`	Get send	`sends:read`	Read	`get_send`
`list_automation_runs`	List automation runs	`automations:read`	Read	`list_automation_runs`
`list_automations`	List automations	`automations:read`	Read	`list_automations`
`list_conversations`	List conversations	`inbox:read`	Read	`list_conversations`
`list_followup_sequences`	List follow-up sequences	`followups:read`	Read	`list_followup_sequences`
`list_knowledge_documents`	List knowledge documents	`knowledge:read`	Read	`list_knowledge_documents`
`list_learned_answers`	List learned answers	`ai:settings_read`	Read	`list_learned_answers`
`list_media`	List media	`media:read`	Read	`list_media`
`list_newsletters`	List newsletters	`newsletters:read`	Read	`list_newsletters`
`list_templates`	List templates	`templates:read`	Read	`list_templates`
`plan_newsletter_send`	Preview newsletter send	`newsletters:read`	Read	`get_newsletter_send_preview`
`publish_landing_page`	Publish landing page	`landing:publish`	Send (reaches other people)	`publish_landing_page`
`run_automation`	Start automation run	`automations:run`	Send (reaches other people)	`create_automation_run`
`save_automation`	Create automation	`automations:write`	Write (no outside effect)	`create_automation`, `update_automation`
`save_contact`	Create contact	`contacts:write`	Write (no outside effect)	`create_contact`, `update_contact`
`save_followup_sequence`	Create follow-up sequence	`followups:write`	Write (no outside effect)	`create_followup_sequence`, `update_followup_sequence`
`save_learned_answer`	Create learned answer	`ai:settings`	Write (no outside effect)	`create_learned_answer`, `update_learned_answer`
`save_newsletter`	Create newsletter	`newsletters:write`	Write (no outside effect)	`create_newsletter`, `update_newsletter`
`save_template`	Create template	`templates:write`	Write (no outside effect)	`create_template`, `update_template`
`search_contacts`	Search contacts	`contacts:read`	Read	`search_contacts`
`search_knowledge`	Search knowledge	`knowledge:read`	Read	`search_knowledge`
`send_newsletter`	Send newsletter	`newsletters:send`	Send (reaches other people)	`send_newsletter`
`send_optin_confirmations`	Create opt-in confirmations	`sends:create`	Send (reaches other people)	`create_optin_confirmations`
`send_template_message`	Send template message	`sends:create`	Send (reaches other people)	`send_template_message`
`send_test_newsletter`	Send test newsletter	`newsletters:test`	Send (reaches other people)	`send_test_newsletter`
`send_text_message`	Send text message	`sends:create`	Send (reaches other people)	`send_text_message`
`set_automation_status`	Set automation status	`automations:write`	Write (no outside effect)	`set_automation_status`
`submit_templates`	Submit templates	`templates:submit`	Send (reaches other people)	`create_template_submissions`
`tag_contacts`	Tag contacts	`contacts:write`	Write (no outside effect)	`tag_contacts`
`unsubscribe_contact`	Unsubscribe contact	`contacts:unsubscribe`	Write (no outside effect)	`unsubscribe_contact`
`update_ai_reply_settings`	Update AI reply settings	`ai:settings`	Write (no outside effect)	`update_ai_reply_settings`
`update_business_profile`	Update business profile	`settings:write`	Write (no outside effect)	`update_business_profile`
`update_conversation`	Update conversation	`inbox:write`	Write (no outside effect)	`update_conversation`
`upload_file`	Upload media file	`media:write`	Write (no outside effect)	`create_media`

The hints on each tool page are the MCP annotations: readOnlyHint (the tool only reads), destructiveHint (it can overwrite or remove data), idempotentHint (a repeat has no extra effect) and openWorldHint (it reaches people or systems outside SmartChat).

Permission and effect are two different things. A permission says which calls a key may make. An effect says what a call does. The REST call create_contact_export needs the permission contacts:read, because it reads your contacts. It still creates a new file with their names, phone numbers and email addresses. That is why MCP marks the tool export_contacts as a write tool (readOnlyHint is false). A key with only the level Read can therefore start an export. See permissions.