Servidor MCP do catálogo Grünig-SignTronic

Verificação de disponibilidade — devolve 'pong' e o ambiente ativo. Não recebe argumentos.

Devolve: Um texto curto, p. ex. pong (production).

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "ping",
    "arguments": {}
  }
}

Pesquisa ou lista produtos Grünig-SignTronic ativos no idioma pedido. Com «query», a pesquisa faz-se por substring sem distinção entre maiúsculas e minúsculas em todo o texto do produto — nome, descrição curta e completa, características, vantagens, aplicações e especificações — pelo que também correspondem números de modelo e termos técnicos (p. ex. «1270», «UV-LED»). SEM «query» lista em vez de pesquisar: «{ lang, category }» responde assim a «que produtos pertencem a esta categoria» e «{ lang }» lista o catálogo. «category» aceita um slug OU um nome de categoria em qualquer dos idiomas do catálogo (ver list_categories). Devolve resumos compactos (slug, nome, descrição curta, categoria, URL canónico); para detalhes completos, usar get_product.

Devolve: { count, results: [{ slug, name, shortDescription, category, url }] }.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_products",
    "arguments": {
      "lang": "en",
      "category": "screen-preparation"
    }
  }
}

Devolve os detalhes completos de um único produto ativo no idioma pedido: descrições, características, vantagens, aplicações, especificações, documentos e slugs de produtos relacionados. Resolução através de «slug», «id» ou «name» — «name» é o nome de exibição («G-COAT 746»); todos os três sem distinção entre maiúsculas e minúsculas, «name» também como substring. Se nada corresponder, a resposta traz «suggestions» com os produtos reais mais próximos — voltar a consultar com um desses em vez de adivinhar.

Devolve: { found, truncated, product } — truncated: true significa que um campo atingiu o limite de comprimento. found: false (mais suggestions), se desconhecido ou inativo.

É obrigatório pelo menos um de slug, id ou name.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_product",
    "arguments": {
      "name": "G-COAT 746",
      "lang": "en"
    }
  }
}

Lista todas as categorias de produto ativas no idioma pedido (slug, nome, descrição, productCount). «productCount» é o número de produtos ativos na categoria — esta lista é, por isso, o mapa do catálogo: começar aqui e depois passar um slug ou um nome como «category» a search_products para listar os produtos dessa categoria.

Devolve: { count, results: [{ slug, name, description, productCount }] }.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_categories",
    "arguments": {
      "lang": "en"
    }
  }
}

Lista as vagas abertas como resumos compactos no idioma pedido. Opcionalmente filtrável por tipo de vaga. Para detalhes completos, usar get_job.

Devolve: { count, results: [{ slug, title, type, … }] }.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_jobs",
    "arguments": {
      "lang": "en"
    }
  }
}

Devolve os detalhes completos de uma única vaga aberta no idioma pedido: descrição, requisitos, vantagens e tipo de vaga. Resolução através de «slug», «id» ou «name» (o título do anúncio) — todos sem distinção entre maiúsculas e minúsculas, «name» também como substring. Uma falha traz «suggestions» com as vagas abertas mais próximas do que foi pedido.

Devolve: { found, truncated, job } — truncated: true significa que um campo atingiu o limite de comprimento. found: false (mais suggestions), se desconhecida ou encerrada.

É obrigatório pelo menos um de slug, id ou name.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_job",
    "arguments": {
      "name": "Automation Engineer",
      "lang": "en"
    }
  }
}

Lista os distribuidores como resumos ao nível da empresa no idioma pedido (nome, endereço, e-mail, website, coordenadas). Opcionalmente filtrável por país. Os contactos ao nível da pessoa NÃO estão incluídos aqui — usar get_distributor.

Devolve: { count, results: [{ companyName, address, email, url, coordinates }] }.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_distributors",
    "arguments": {
      "lang": "en"
    }
  }
}

Devolve os detalhes completos de um único distribuidor no idioma pedido — incluindo a pessoa de contacto indicada (e-mail/telefone/telemóvel), que só é divulgada aqui e nunca na lista global. Resolução através de «slug», «id» ou «name» (o nome da empresa) — todos sem distinção entre maiúsculas e minúsculas, «name» também como substring. Uma falha traz «suggestions» com os parceiros mais próximos.

Devolve: { found, truncated, distributor } incluindo um objeto contact; truncated: true significa que um campo atingiu o limite de comprimento.

É obrigatório pelo menos um de slug, id ou name.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_distributor",
    "arguments": {
      "name": "Example Graphics",
      "lang": "en"
    }
  }
}

Devolve um documento legal (p. ex. aviso legal, política de privacidade, termos) no idioma pedido. «page» aceita a chave da página ou o slug do URL, sem distinção entre maiúsculas e minúsculas; uma falha traz «suggestions» com as páginas publicadas nesse idioma. É sempre vinculativa a versão alemã; «document.lang» indica o idioma do texto devolvido.

Devolve: { found, document: { page, urlSlug, lang, summary, body, truncated } } — found: false mais suggestions em caso de falha.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_legal_document",
    "arguments": {
      "page": "imprint",
      "lang": "en"
    }
  }
}

Lista as notícias mais recentes no idioma pedido (título, excerto, tags, data). Opcionalmente filtrável por tag. São divulgados apenas excertos — nunca o HTML completo do artigo.

Devolve: { count, results: [{ title, excerpt, tags, publishedAt }] }.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_news",
    "arguments": {
      "lang": "en"
    }
  }
}