# Tools

> Every tool of the MCP server with its permission and effect. Each tool has a page with its input and its hints.

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