Referência de tools

O servidor MCP do Logaco oferece 10 ferramentas (tools). Não precisas de as chamar tu: o assistente escolhe a ferramenta certa a partir do teu pedido. Esta página serve para saberes o que ele consegue fazer e o que cada ferramenta precisa.

Logótipos e empresasCopiar ligação

search_companiesCopiar ligação

Pesquisa empresas, marcas e organizações de Moçambique com logótipos no Logaco, pelo nome ou por um nome alternativo (sem ligar a acentos), pelo sector ou pela província. Também devolve related: empresas que correspondem à pesquisa pelo significado, mesmo sem a palavra no nome (por exemplo, «companhia aérea» encontra as companhias aéreas).

Acesso: funciona sem conta. Com conta ou com um token, precisa da permissão Ler logótipos e empresas (read:logos).

Exemplo de pedido ao assistente: «Que empresas de telecomunicações têm logótipo no Logaco?»

Exemplo

{
  "query": "exemplo"
}

{
  "total": 1,
  "page": 1,
  "totalPages": 1,
  "companies": [
    {
      "slug": "empresa-exemplo",
      "name": "Empresa Exemplo",
      "sector": "Telecomunicações",
      "province": "Maputo",
      "logoCount": 2,
      "currentLogo": {
        "slug": "empresa-exemplo",
        "preview": "https://…/empresa-exemplo.png"
      },
      "page": "https://logaco.com/company/empresa-exemplo"
    }
  ]
}

search_logosCopiar ligação

Pesquisa logótipos pelo título ou pelo nome da empresa (sem ligar a acentos). Os logótipos actuais aparecem primeiro. Devolve o identificador de cada logótipo (slug), os formatos disponíveis e uma pequena pré-visualização. Depois, o assistente usa get_logo com o slug.

Acesso: funciona sem conta. Com conta ou com um token, precisa da permissão Ler logótipos e empresas (read:logos).

Exemplo de pedido ao assistente: «Procura o logótipo do BCI.»

Exemplo

{
  "query": "exemplo"
}

{
  "total": 1,
  "page": 1,
  "totalPages": 1,
  "logos": [
    {
      "slug": "empresa-exemplo",
      "title": "Empresa Exemplo",
      "company": {
        "slug": "empresa-exemplo",
        "name": "Empresa Exemplo"
      },
      "isCurrent": true,
      "formats": [
        "SVG",
        "PNG",
        "PDF"
      ],
      "preview": "https://…/empresa-exemplo.png",
      "page": "https://logaco.com/logo/empresa-exemplo"
    }
  ],
  "note": "Os logótipos são marcas registadas das respectivas empresas — usa-os de acordo com as regras de cada marca."
}

get_logoCopiar ligação

Mostra um logótipo pelo slug ou pelo id. Sem format, devolve só a informação do logótipo (variantes e formatos disponíveis) e não conta para a quota: é o primeiro passo. Com format (e, se quiseres, variant), devolve uma ligação para descarregar o ficheiro, válida durante 1 hora, e conta para a tua quota de downloads.

Acesso: funciona sem conta. Com conta ou com um token, precisa da permissão Ler logótipos e empresas (read:logos).

Exemplo de pedido ao assistente: «Dá-me o logótipo da Vodacom em SVG.»

Exemplo: sem format: informação do logótipo

{
  "logo": "empresa-exemplo"
}

{
  "slug": "empresa-exemplo",
  "title": "Empresa Exemplo",
  "company": {
    "slug": "empresa-exemplo",
    "name": "Empresa Exemplo"
  },
  "isCurrent": true,
  "era": {
    "from": null,
    "to": null,
    "label": null
  },
  "formats": [
    "SVG",
    "PNG",
    "PDF"
  ],
  "variants": [
    {
      "name": "Horizontal",
      "kind": "TYPE",
      "formats": [
        "SVG",
        "PNG"
      ]
    }
  ],
  "preview": "https://…/empresa-exemplo.png",
  "page": "https://logaco.com/logo/empresa-exemplo",
  "note": "Os logótipos são marcas registadas das respectivas empresas — usa-os de acordo com as regras de cada marca."
}

Exemplo: com format: ligação para descarregar

{
  "logo": "empresa-exemplo",
  "format": "SVG"
}

{
  "downloadUrl": "https://…/empresa-exemplo.svg?…",
  "filename": "empresa-exemplo.svg",
  "format": "SVG",
  "expiresAt": "2026-10-14T10:00:00.000Z",
  "quota": {
    "unlimited": false,
    "used": 1,
    "limit": 5,
    "remaining": 4,
    "resetAt": "2026-10-15T09:00:00.000Z"
  },
  "note": "Os logótipos são marcas registadas das respectivas empresas — usa-os de acordo com as regras de cada marca."
}

get_brand_colorsCopiar ligação

Mostra as cores oficiais de uma empresa (as do logótipo actual), se o Logaco as tiver registadas. Pode devolver uma lista vazia quando as cores ainda não foram calculadas; nesse caso o assistente deve dizê-lo e não inventar cores.

Acesso: funciona sem conta. Com conta ou com um token, precisa da permissão Ler logótipos e empresas (read:logos).

Exemplo de pedido ao assistente: «Quais são as cores da marca da Vodacom?»

Exemplo

{
  "company": "empresa-exemplo"
}

{
  "company": {
    "slug": "empresa-exemplo",
    "name": "Empresa Exemplo"
  },
  "colors": [
    {
      "hex": "#6725D0",
      "name": "Violeta-escuro"
    },
    {
      "hex": "#F2A900",
      "name": "Laranja"
    }
  ],
  "cached": true,
  "message": null
}

CoresCopiar ligação

generate_paletteCopiar ligação

Gera uma paleta de cores harmoniosa, calculada em OKLCH. Podes partir de uma cor base (por exemplo, a cor de uma marca), que fica sempre em primeiro lugar. É o mesmo cálculo do gerador de paletas.

Acesso: funciona sem conta e com qualquer token.

Exemplo de pedido ao assistente: «Cria uma paleta complementar de 5 cores a partir de #6725D0.»

Exemplo (resposta real)

{
  "mode": "complementary",
  "count": 5,
  "baseColor": "#6725D0"
}

{
  "mode": "complementary",
  "colors": [
    {
      "hex": "#6725D0",
      "name": "Violeta-escuro"
    },
    {
      "hex": "#413E00",
      "name": "Verde-oliva"
    },
    {
      "hex": "#8E75C2",
      "name": "Roxo-médio"
    },
    {
      "hex": "#E4EF94",
      "name": "Creme"
    },
    {
      "hex": "#B9ABF7",
      "name": "Lilás"
    }
  ]
}

check_contrastCopiar ligação

Calcula o rácio de contraste WCAG 2.x entre a cor do texto (ou de um ícone) e a cor do fundo, e diz se passa os níveis AA e AAA em texto normal, texto grande e elementos de interface. É o mesmo cálculo do verificador de contraste.

Acesso: funciona sem conta e com qualquer token.

Exemplo de pedido ao assistente: «O texto branco sobre #6725D0 tem contraste suficiente?»

Exemplo (resposta real)

{
  "foreground": "#FFFFFF",
  "background": "#6725D0"
}

{
  "ratio": 7.63,
  "ratioText": "7,63:1",
  "normalText": {
    "AA": true,
    "AAA": true
  },
  "largeText": {
    "AA": true,
    "AAA": true
  },
  "uiComponents": true,
  "summary": "Excelente: passa AAA em todo o texto."
}

color_variantsCopiar ligação

Variantes de uma cor: uma escala 50–950 para design systems (parecida com a do Tailwind), tints (para o branco), shades (para o preto) e tons (para o cinzento). É o mesmo cálculo de criar variantes.

Acesso: funciona sem conta e com qualquer token.

Exemplo de pedido ao assistente: «Cria uma escala 50–950 a partir de #6725D0.»

Exemplo (resposta real)

{
  "color": "#6725D0",
  "kind": "scale"
}

{
  "color": "#6725D0",
  "name": "Violeta-escuro",
  "scale": [
    {
      "step": 50,
      "hex": "#F5F4FE",
      "isBase": false
    },
    {
      "step": 100,
      "hex": "#E9E6FD",
      "isBase": false
    },
    {
      "step": 200,
      "hex": "#D8D2FD",
      "isBase": false
    },
    {
      "step": 300,
      "hex": "#C0B2FF",
      "isBase": false
    },
    {
      "step": 400,
      "hex": "#A289F8",
      "isBase": false
    },
    {
      "step": 500,
      "hex": "#8A61F1",
      "isBase": false
    },
    {
      "step": 600,
      "hex": "#763BE5",
      "isBase": false
    },
    {
      "step": 700,
      "hex": "#6725D0",
      "isBase": true
    },
    {
      "step": 800,
      "hex": "#5526A9",
      "isBase": false
    },
    {
      "step": 900,
      "hex": "#452A83",
      "isBase": false
    },
    {
      "step": 950,
      "hex": "#2B1E50",
      "isBase": false
    }
  ]
}

A tua contaCopiar ligação

list_my_palettesCopiar ligação

Lista as paletas e os gradientes guardados na tua conta Logaco, dos mais recentes para os mais antigos, e quantas paletas já usaste do limite da conta.

Acesso: precisa de conta: liga o assistente pelo endereço com conta ou usa um token com a permissão Ler as minhas paletas (read:palettes).

Exemplo de pedido ao assistente: «Mostra as minhas paletas guardadas no Logaco.»

Exemplo

{}

{
  "total": 1,
  "page": 1,
  "totalPages": 1,
  "quota": {
    "used": 1,
    "max": 100
  },
  "palettes": [
    {
      "id": "…",
      "name": "Campanha",
      "type": "PALETTE",
      "colors": [
        "#6725D0",
        "#F2A900"
      ],
      "company": null,
      "isPublic": false
    }
  ]
}

save_paletteCopiar ligação

Guarda uma paleta de 2 a 10 cores na tua conta Logaco, se quiseres ligada a uma empresa. O assistente só deve guardar quando lhe pedires. Cada conta guarda até 100 paletas.

Acesso: precisa de conta: liga o assistente pelo endereço com conta ou usa um token com a permissão Guardar paletas (write:palettes).

Exemplo de pedido ao assistente: «Guarda estas cores no Logaco com o nome «Campanha».»

Exemplo

{
  "name": "Campanha",
  "colors": [
    "#6725D0",
    "#F2A900"
  ]
}

{
  "id": "…",
  "name": "Campanha",
  "colors": [
    "#6725D0",
    "#F2A900"
  ],
  "company": null,
  "message": "Paleta guardada na conta Logaco."
}

propose_logoCopiar ligação

Envia um logótipo para a equipa do Logaco rever: o de uma empresa que ainda não está no Logaco, ou uma nova versão de um logótipo que já existe. Nada é publicado antes de uma pessoa aprovar. O ficheiro vai como código SVG em svg ou em base64 em fileBase64 (PNG, JPEG, WEBP ou SVG, até 2 MB), só um dos dois. O assistente só deve usar esta tool quando lhe pedires para enviar um logótipo. Cada conta pode enviar até 10 propostas em 24 horas.

Acesso: precisa de conta: liga o assistente pelo endereço com conta ou usa um token com a permissão Propor logótipos (write:proposals).

Exemplo de pedido ao assistente: «Envia este SVG ao Logaco como o logótipo da Empresa Exemplo.»

Exemplo

{
  "companyName": "Empresa Exemplo",
  "svg": "<svg …>…</svg>"
}

{
  "id": "…",
  "status": "PENDING",
  "companyName": "Empresa Exemplo",
  "company": null,
  "file": {
    "filename": "logo.svg",
    "format": "SVG",
    "size": 2048,
    "contentType": "image/svg+xml"
  },
  "message": "Proposta enviada — fica pendente até ser revista pela equipa do Logaco."
}

Mensagens de erroCopiar ligação

Quando uma ferramenta não pode responder, o assistente recebe uma mensagem em português e, normalmente, explica-ta. As mais comuns:

O que o servidor diz ao assistenteCopiar ligação

Quando se liga, o assistente recebe estas instruções gerais (em inglês, porque os modelos as seguem melhor):