> ## Documentation Index
> Fetch the complete documentation index at: https://docs.semantika.pt/llms.txt
> Use this file to discover all available pages before exploring further.

# Tools MCP

> O assistente começa por list_brands. As outras tools usam brand_id ou action_id.

O assistente usa estas tools depois de ligares o MCP. Começa **sempre** por `list_brands`.

Com Claude ou ChatGPT, vê as marcas dos workspaces que autorizaste. Com um token `sem_mcp_…`, só o workspace onde o token foi criado.

## list\_brands

Lista as marcas, com o `brand_id` de cada uma. Sem parâmetros.

Usa esta tool primeiro: as outras (excepto `get_action`) precisam de um `brand_id` daqui.

## get\_visibility

Visibilidade da marca nos motores de IA: Share of Voice, taxa de citação, taxa de menção, sentimento, e o detalhe por motor.

| Parâmetro  | Obrigatório | O que é                             |
| ---------- | ----------- | ----------------------------------- |
| `brand_id` | Sim         | ID da marca (vem de `list_brands`). |

## list\_actions

Ações recomendadas para a marca, por prioridade.

| Parâmetro  | Obrigatório | O que é                                                       |
| ---------- | ----------- | ------------------------------------------------------------- |
| `brand_id` | Sim         | ID da marca.                                                  |
| `status`   | Não         | `ready`, `queued`, `in_progress`, `completed` ou `dismissed`. |
| `limit`    | Não         | Máximo de ações. Por defeito 10, máximo 50.                   |
| `sort_by`  | Não         | `priority` (defeito), `impact` ou `effort`.                   |

Cada ação traz um ID para `get_action`.

## get\_action

Detalhe de uma ação: descrição, justificação, passos, impacto estimado e fontes.

| Parâmetro   | Obrigatório | O que é                             |
| ----------- | ----------- | ----------------------------------- |
| `action_id` | Sim         | ID da ação (vem de `list_actions`). |

## get\_report

Resumo da análise mais recente: score e, se existir, o brief gerado.

| Parâmetro  | Obrigatório | O que é      |
| ---------- | ----------- | ------------ |
| `brand_id` | Sim         | ID da marca. |

## list\_prompts

Prompts que estás a monitorizar, com visibilidade, sentimento e citações.

| Parâmetro  | Obrigatório | O que é      |
| ---------- | ----------- | ------------ |
| `brand_id` | Sim         | ID da marca. |

## Ordem típica

1. `list_brands` → escolhe um `brand_id`
2. `get_visibility` e/ou `get_report` e/ou `list_prompts`
3. `list_actions` → escolhe um `action_id`
4. `get_action`

Como ligar: [Claude.ai](/mcp-reference/claude), [ChatGPT](/mcp-reference/chatgpt), [token](/mcp-reference/token).


## Related topics

- [MCP da Semantika](/mcp-reference/overview.md)
- [Ligar o ChatGPT](/mcp-reference/chatgpt.md)
- [FAQ da Semantika: produto, planos, dados e conta](/help/faq.md)
- [Ligar o Claude.ai](/mcp-reference/claude.md)