Tools reference
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 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:discoveryfor a buyer looking for a solution without naming your site,reputationfor 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 |