> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cognizo.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Tools
> All 42 tools the Cognizo MCP server exposes.
The server exposes **42 tools**: 38 generated from the public API — one per
operation, named after its operation id — and 4 hand-written workflow tools
that chain calls together.
You don't need to memorise these; the model picks them. The list is here so
you can tell what it did, and approve or block individual tools in clients
that support it.
## Workflow tools
Shortcuts for the questions people actually ask. Each takes a single
`brand_id` and returns the already-joined result, so the model spends one
round-trip instead of three.
| Tool | Returns | Ask it like |
| ------------------------- | ------------------------------------------------------ | ------------------------------------------------ |
| `weekly_visibility_pulse` | Visibility, share of voice and sentiment for one brand | *"How is Acme doing this week?"* |
| `competitor_radar` | The brand's tracked competitors, ready to rank | *"Who are we up against and how do we compare?"* |
| `citation_gap_report` | The domains cited in the brand's space | *"Where should we be earning citations?"* |
| `prompt_coverage_audit` | Tracked prompts with their visibility | *"Which prompts are we losing?"* |
Workflow tools use the API's default window — the **last 30 days** — and no
filters. For a specific period, region or provider, the model should reach for
the generated tools below, which take the full
[filter set](/guides/pagination-filtering).
## Generated tools
Every tool takes the same parameters as the underlying endpoint: path ids as
plain arguments, and the query parameters (`page`, `page_size`, `sort`,
`filter[…]`) as optional ones.
### Brands
| Tool | What it does |
| -------------- | --------------------------------------------------------- |
| `list_brands` | List the brands your organization owns |
| `get_brand` | Get one brand |
| `create_brand` | Create (or reactivate) a brand |
| `update_brand` | Partially update a brand — blank values keep the old data |
| `delete_brand` | Soft-delete a brand |
### Brand metrics
| Tool | What it does |
| -------------------------- | ---------------------------------------------------- |
| `get_brand_visibility` | Brand-level visibility (aggregate + time series) |
| `get_brand_share_of_voice` | Brand-level share of voice (aggregate + time series) |
| `get_brand_sentiment` | Brand-level sentiment (aggregate + time series) |
### Topics
| Tool | What it does |
| --------------------- | --------------------------------------------------- |
| `list_brand_topics` | A brand's topics with metrics and prompt counts |
| `get_brand_topic` | One topic with extended metrics |
| `create_brand_topics` | Bulk-create topics (reactivates soft-deleted names) |
| `update_brand_topic` | Rename or soft-delete a topic |
| `delete_brand_topic` | Soft-delete a topic and deactivate its prompts |
### Prompts
| Tool | What it does |
| ---------------------------------------- | ------------------------------------------------------- |
| `list_brand_prompts` | A brand's prompts with their metrics |
| `create_brand_prompts` | Bulk-add prompts to a brand |
| `update_brand_prompts` | Bulk-edit prompts (move topic, soft delete, reactivate) |
| `get_brand_prompt_region` | One prompt's metrics row in one region |
| `get_brand_prompt_region_visibility` | Prompt-level visibility (aggregate + time series) |
| `get_brand_prompt_region_share_of_voice` | Prompt-level share of voice |
| `get_brand_prompt_region_sentiment` | Prompt-level sentiment |
### Citations
| Tool | What it does |
| -------------------------------------- | ----------------------------------------------- |
| `list_brand_citations_domains` | Most-cited domains |
| `get_brand_citations_domains_overview` | Domain-level share overview + type breakdown |
| `list_brand_citations_pages` | Most-cited pages |
| `get_brand_citations_pages_overview` | Page-level share overview + page-type breakdown |
| `get_brand_citations_overview` | Summary stats, distributions, top growing |
| `get_brand_citations_summary` | Citation summary by domain type |
| `get_brand_citations_citation_share` | Owned-citation share time series |
| `get_brand_citations_mention_share` | Brand-mention share time series |
### Competitors
| Tool | What it does |
| ------------------------- | ------------------------------------ |
| `list_brand_competitors` | List tracked competitors |
| `create_brand_competitor` | Track a competitor directly |
| `update_brand_competitor` | Update a tracked competitor's domain |
| `delete_brand_competitor` | Untrack a competitor |
### Ads & advertisers
| Tool | What it does |
| --------------------------- | ------------------------------------------------- |
| `list_brand_ads` | Distinct creatives running on the brand's prompts |
| `get_brand_ads_breakdown` | Ad-visibility breakdown by dimension |
| `get_brand_ad` | One ad, with its copy |
| `list_brand_advertisers` | Advertisers running ads on the brand's prompts |
| `get_brand_advertiser` | Advertiser summary |
| `list_brand_advertiser_ads` | Ads a specific advertiser ran |
## Reading the results
Tools return the API's `data` payload. That means the
[metric units](/guides/metrics) apply verbatim — including the trap that
`sentiment` is a 1–100 average rather than a percentage. If an assistant
reports sentiment as "62%", it has mislabelled the unit; the number itself is
right.
## Writes
Eleven of these tools mutate data: `create_brand`, `update_brand`,
`delete_brand`, `create_brand_topics`, `update_brand_topic`,
`delete_brand_topic`, `create_brand_prompts`, `update_brand_prompts`, and the
three competitor writes. Deletes are soft — the row drops out of the lists but
its history is kept, and an archived prompt can still be read directly.
An assistant holding your key can call the write tools. If that's not what you
want, use a client that asks before each tool call, or one that lets you
disable tools individually.