Blck Alpaca

Acceso de solo lectura a la base de conocimientos de Blck Alpaca: SEO, GEO, agentes de IA, automatización de marketing.

Documentación

Base de conocimiento Blck Alpaca MCP

Servidor MCP público para la base de conocimiento de Blck Alpaca: SEO, GEO (optimización para motores generativos), agentes de IA y automatización de marketing. Solo lectura, sin autenticación, en alemán, inglés y eslovaco.

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

Este repositorio contiene únicamente metadatos. El servidor se ejecuta como parte de blckalpaca.at y su código fuente no se publica aquí.

Endpoint

POST https://blckalpaca.at/mcp

Transporte: HTTP Streamable. No se crea ninguna sesión — no hay Mcp-Session-Id ni flujo GET. Cada llamada es un único POST.

Instalación

Claude Code:

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

Cualquier cliente que lea un archivo de configuración:

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

Revisiones de protocolo

La misma URL sirve a dos generaciones, por lo que los clientes construidos sobre SDKs más antiguos siguen funcionando.

Revisión	Punto de entrada del cliente	Encabezados requeridos
`2026-07-28`	`server/discover`, `tools/list`, `tools/call` directamente	`MCP-Protocol-Version`, `Mcp-Method`; en `tools/call` también `Mcp-Name`
`2025-11-25`, `2025-06-18`, `2025-03-26`	`initialize`, luego `notifications/initialized`	ninguno

Una versión desconocida recibe el error JSON-RPC -32022 con la lista completa bajo data.supported.

Herramientas

Herramienta	Propósito	Requerido	Opcional
`search_knowledge_base`	Búsqueda de texto completo sobre el título del artículo, definición breve y palabra clave principal. Devuelve la URL más un triple de ruta para el texto completo.	`query` (cadena, mínimo 2 caracteres)	`locale` (`de`\|`en`\|`sk`, predeterminado `de`), `limit` (entero 1–25, predeterminado 8)
`list_knowledge_categories`	Estructura de la base de conocimiento: todas las categorías con sus temas, cada uno con slug y URL. Punto de entrada cuando no se conoce ningún término de búsqueda.	—	`locale`
`list_knowledge_topic_articles`	Todos los artículos publicados de un tema.	`categorySlug`, `topicSlug`	`locale`
`get_knowledge_article`	Artículo completo en Markdown, más definición breve, conclusiones clave, estadísticas con fuentes y preguntas frecuentes.	`categorySlug`, `topicSlug`, `articleSlug`	`locale`

Los slugs están localizados. El slug de categoría y de tema deben provenir de la misma configuración regional que la solicitud; si no coinciden, la respuesta explica el motivo. El contenido que no está traducido al idioma solicitado se omite en lugar de reemplazarse silenciosamente con alemán.

El triple de ruta devuelto por search_knowledge_base y list_knowledge_topic_articles se puede pasar directamente a get_knowledge_article.

Límite de velocidad

240 solicitudes por hora y dirección IP. Cada respuesta incluye RateLimit y RateLimit-Policy (borrador de IETF) más el triple heredado RateLimit-Limit / -Remaining / -Reset. Al superar el límite, el servidor responde con HTTP 429 y JSON-RPC -32603 con data.retryAfterSeconds, además de un encabezado Retry-After.

Uso del contenido

Los artículos pueden citarse y resumirse con atribución a Blck Alpaca y un enlace a la URL del artículo devuelta por la herramienta.

Enlaces

Documentación para desarrolladores: DE · EN · SK
Especificación OpenAPI de la API REST circundante: https://blckalpaca.at/openapi.json
Tarjeta del servidor: https://blckalpaca.at/.well-known/mcp/server-card.json
Smithery: https://smithery.ai/server/blckalpaca/knowledge-base
Manifiesto: server.json

Contacto

office@blckalpaca.at — Blck Alpaca OG, Viena, Austria