MCP Tools
The hosted core profile contains the following tools. A connection’s available tools and exact input schemas come from tools/list; inspect them before calling a tool.
Tool catalog
| Tool | Operation | Purpose |
|---|---|---|
brands_list | Read | List brands |
brands_get | Read | Read a brand |
topics_list | Read | List topics |
topics_get | Read | Read a topic |
prompts_list | Read | List prompts |
prompts_get | Read | Read a prompt |
answers_list | Read | List answers |
answers_get | Read | Read an answer |
get_visibility_report | Read | Retrieve visibility reports |
get_citations_report | Read | Retrieve citation reports |
get_sentiment_report | Read | Retrieve sentiment reports |
get_query_fanouts_report | Read | Retrieve query fanout reports |
get_web_search_results_report | Read | Retrieve web search result reports |
search_tools | Read | Search additional read-only tools |
get_tool_schema | Read | Read a discovered tool schema |
execute_tool | Read | Execute a discovered read-only tool |
prompts_create | Preview | Preview prompt creation |
create_issue | Write | Create an issue |
Discover workspace data
Start with brands_list, then use topics_list or prompts_list. List responses provide IDs to pass to the corresponding detail tools. topics_list accepts an optional brand_id; prompts_list accepts an optional topic_id.
{ "limit": 20 }Example input for brands_list. Hosted OAuth determines the workspace.
When a response includes a next cursor, pass it to the next request instead of treating the first page as the complete result.
Retrieve reports
Use get_visibility_report for mentions and visibility, get_citations_report for cited sources, and get_sentiment_report for sentiment. Their schemas define supported metrics, dimensions, filters, and date ranges.
Retrieve visibility and citation reports for the same period. Explain the difference between brand mentions and citations, and identify the source data for each conclusion.
Find additional read-only tools
- Use
search_toolsto search by purpose. - Use
get_tool_schemato inspect the selected tool’s inputs. - Use
execute_toolwith the discovered name and valid arguments.
This discovery path is read-only. It does not discover or execute write tools. Available additional tools depend on the connection profile.
Preview and write operations
In the hosted preview surface, prompts_create validates and previews prompt creation. A persisted creation requires write authorization and a tool surface that permits it. create_issue creates a workspace Issue and requires write permissions.
Check the tool’s required fields and annotations, confirm the target workspace and changes, and do not treat a preview as a persisted resource.