--- title: Tools reference description: The read and write tools of the Sommet MCP server, what each one returns or changes, its inputs, and the order in which an assistant calls them. --- Every tool goes through the same checks as the dashboard: you only reach workspaces you are a member of, and plan limits apply. Call `list_workspaces` first, then pass a `workspaceId` to the other tools. `weeks` is optional on the tools that accept it. It takes `1`, `4` or `12` and defaults to `4`. The window ends with the latest collection week. | Tool | Access | Does | | ------------------------- | ------ | -------------------------------------------- | | `list_workspaces` | Read | Lists your workspaces | | `get_visibility_overview` | Read | Mention and citation rates, sentiment, trend | | `list_ai_answers` | Read | Pages through the collected answers | | `get_ai_answer` | Read | Full text of one answer | | `get_cited_sources` | Read | Domains and pages assistants cite | | `get_competitors` | Read | Brands named next to you | | `get_ai_bot_traffic` | Read | AI bot visits over 30 days | | `list_actions` | Read | Recommended actions | | `get_question_panel` | Read | Tracked questions and their IDs | | `add_questions` | Write | Adds questions to the weekly panel | | `update_question` | Write | Rewords a question or changes its intent | | `remove_questions` | Write | Stops asking questions | | `update_action_status` | Write | Sets the status of a Google fix | ## Read tools ### list_workspaces Lists the websites (workspaces) you can read, with their IDs and domains. **Inputs:** none. ### get_visibility_overview Visibility of the site in AI answers over a window: mention and citation rates, sentiment, and their weekly trend, per assistant. | Input | Type | | | ------------- | ---------------- | -------- | | `workspaceId` | UUID | Required | | `weeks` | `1`, `4` or `12` | Optional | ### list_ai_answers Pages through every completed AI answer collected for your questions, all weeks, newest week first, with whether each one mentions or cites the site and the competitors it names. It also returns the collection weeks. | Input | Type | | | ------------- | --------------------- | ----------------------------------------------------------------------------------- | | `workspaceId` | UUID | Required | | `week` | date, `yyyy-mm-dd` | Optional. Only answers of this collection week. Every week by default. | | `surface` | `chatgpt` or `gemini` | Optional. Only answers from this assistant. | | `cited` | boolean | Optional. `true` for answers that cite the site, `false` for those that do not. | | `mentioned` | boolean | Optional. `true` for answers that mention the site, `false` for those that miss it. | | `question` | text | Optional. Only answers to questions containing this text. | | `limit` | 1 to 50 | Optional. Page size. | | `offset` | integer ≥ 0 | Optional | ### get_ai_answer Full text of one answer, with its citations and how it was collected. | Input | Type | | | ------------- | ---- | --------------------------------- | | `workspaceId` | UUID | Required | | `answerId` | UUID | Required. From `list_ai_answers`. | ### get_cited_sources Domains and pages AI assistants cite when they answer your questions. | Input | Type | | | ------------- | ---------------- | -------- | | `workspaceId` | UUID | Required | | `weeks` | `1`, `4` or `12` | Optional | ### get_competitors Brands AI assistants name next to the site, with share of voice and average rank. | Input | Type | | | ------------- | ---------------- | -------- | | `workspaceId` | UUID | Required | | `weeks` | `1`, `4` or `12` | Optional | ### get_ai_bot_traffic How often each assistant's bots requested the site over the last 30 days, and which log source is connected. | Input | Type | | | ------------- | ---- | -------- | | `workspaceId` | UUID | Required | ### list_actions Recommended actions to improve AI visibility: - the web searches behind answers that miss the site, with its Google position when Search Console is connected; - third-party pages those answers cite next to competitors, with a draft email asking to be listed; - Google fixes from the latest search audit. A done fix has its impact and `indexing`: whether Google read the page again since the change, or does not index it. | Input | Type | | | ------------- | ---- | -------- | | `workspaceId` | UUID | Required | ### get_question_panel The questions Sommet asks AI assistants every week for the site, with their IDs, plus the market, language and assistants of the panel. | Input | Type | | | ------------- | ---- | -------- | | `workspaceId` | UUID | Required | ## Write tools The write tools need the `sommet:write` scope. A [read-only connection](/docs/mcp#read-only-connections) does not list them. ### add_questions Adds questions to the weekly panel, after the existing ones. Your plan limits how many questions are active. Returns the updated panel. | Input | Type | | | ------------- | ----------------------------------------- | -------- | | `workspaceId` | UUID | Required | | `questions` | 1 to 100 objects with `text` and `intent` | Required | - `text`: the question as a buyer would ask an AI assistant, in the panel language, 500 characters at most. - `intent`: `discovery` for a buyer looking for a solution without naming your site, `reputation` for a question about your site or brand by name. ### update_question Rewords a question or changes its intent. Answers already collected keep the wording they were asked with. Returns the updated panel. | Input | Type | | | ------------- | --------------------------- | ------------------------------------ | | `workspaceId` | UUID | Required | | `questionId` | UUID | Required. From `get_question_panel`. | | `text` | string | Optional | | `intent` | `discovery` or `reputation` | Optional | ### remove_questions Stops asking questions in the weekly panel. Their answers so far stay in the history. Returns the updated panel. | Input | Type | | | ------------- | -------------- | ------------------------------------ | | `workspaceId` | UUID | Required | | `questionIds` | 1 to 100 UUIDs | Required. From `get_question_panel`. | ### update_action_status Sets the status of a Google fix from `list_actions`. Marking it `done` starts measuring its effect on clicks and positions, and Sommet checks once a day that Google read the page again (`indexing` in `list_actions`). | Input | Type | | | ------------------ | -------------------------------------------- | ------------------------------ | | `workspaceId` | UUID | Required | | `recommendationId` | UUID | Required. From `list_actions`. | | `status` | `open`, `in_progress`, `done` or `dismissed` | Required |