Blck Alpaca

Acesso somente leitura à base de conhecimento da Blck Alpaca: SEO, GEO, agentes de IA, automação de marketing.

Documentação

Base de Conhecimento Blck Alpaca MCP

Servidor MCP público para a base de conhecimento Blck Alpaca: SEO, GEO (otimização de mecanismos generativos), agentes de IA e automação de marketing. Somente leitura, sem autenticação, em alemão, inglês e eslovaco.

Listado no registro oficial de MCP como at.blckalpaca/knowledge-base.

Este repositório contém apenas metadados. O servidor é executado como parte de blckalpaca.at e seu código-fonte não é publicado aqui.

Endpoint

POST https://blckalpaca.at/mcp

Transporte: HTTP Streamable. Nenhuma sessão é criada — não há Mcp-Session-Id e nenhum stream GET. Cada chamada é um único POST.

Instalação

Claude Code:

claude mcp add --transport http blckalpaca-knowledge-base https://blckalpaca.at/mcp

Qualquer cliente que leia um arquivo de configuração:

{
  "mcpServers": {
    "blckalpaca-knowledge-base": {
      "type": "http",
      "url": "https://blckalpaca.at/mcp"
    }
  }
}

Revisões de protocolo

A mesma URL atende a duas gerações, para que clientes baseados em SDKs mais antigos continuem funcionando.

Revisão	Ponto de entrada do cliente	Cabeçalhos obrigatórios
`2026-07-28`	`server/discover`, `tools/list`, `tools/call` diretamente	`MCP-Protocol-Version`, `Mcp-Method`; em `tools/call` também `Mcp-Name`
`2025-11-25`, `2025-06-18`, `2025-03-26`	`initialize`, depois `notifications/initialized`	nenhum

Uma versão desconhecida retorna o erro JSON-RPC -32022 com a lista completa em data.supported.

Ferramentas

Ferramenta	Finalidade	Obrigatório	Opcional
`search_knowledge_base`	Pesquisa de texto completo no título do artigo, definição curta e palavra-chave principal. Retorna URL e uma tripla de caminho para o texto completo.	`query` (string, mínimo 2 caracteres)	`locale` (`de`\|`en`\|`sk`, padrão `de`), `limit` (inteiro 1–25, padrão 8)
`list_knowledge_categories`	Estrutura da base de conhecimento: todas as categorias com seus tópicos, cada um com slug e URL. Ponto de entrada quando nenhum termo de pesquisa é conhecido.	—	`locale`
`list_knowledge_topic_articles`	Todos os artigos publicados de um tópico.	`categorySlug`, `topicSlug`	`locale`
`get_knowledge_article`	Artigo completo em Markdown, além de definição curta, principais conclusões, estatísticas com fontes e FAQ.	`categorySlug`, `topicSlug`, `articleSlug`	`locale`

Os slugs são localizados. O slug da categoria e do tópico deve vir do mesmo idioma da solicitação; se não corresponderem, a resposta explica o motivo. Conteúdo que não esteja traduzido para o idioma solicitado é omitido em vez de ser silenciosamente substituído por alemão.

A tripla de caminho retornada por search_knowledge_base e list_knowledge_topic_articles pode ser passada diretamente para get_knowledge_article.

Limite de taxa

240 solicitações por hora e por IP. Cada resposta carrega RateLimit e RateLimit-Policy (rascunho do IETF) além da tripla legada RateLimit-Limit / -Remaining / -Reset. Acima do limite, o servidor responde com HTTP 429 e JSON-RPC -32603 com data.retryAfterSeconds, além de um cabeçalho Retry-After.

Uso do conteúdo

Artigos podem ser citados e resumidos com atribuição à Blck Alpaca e um link para a URL do artigo retornada pela ferramenta.

Contato

office@blckalpaca.at — Blck Alpaca OG, Viena, Áustria