Blck Alpaca Knowledge Base MCP

Public MCP server for the Blck Alpaca knowledge base: SEO, GEO (generative engine

optimization), AI agents and marketing automation. Read-only, no authentication,

German, English and Slovak.

Listed in the official MCP Registry

as `at.blckalpaca/knowledge-base`.

This repository holds metadata only. The server runs as part of blckalpaca.at and its

source is not published here.

Endpoint

POST https://blckalpaca.at/mcp

Transport: Streamable HTTP. No session is created — there is no `Mcp-Session-Id` and no

GET stream. Every call is a single POST.

Install

Claude Code:

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

Any client that reads a config file:

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

Protocol revisions

The same URL serves two generations, so clients built on older SDKs keep working.

An unknown version gets JSON-RPC error `-32022` with the full list under `data.supported`.

Tools

Slugs are localized. Category and topic slug must come from the same locale as the

request; if they do not match, the response says why. Content that is not translated into

the requested language is omitted rather than silently replaced with German.

The path triple returned by `search_knowledge_base` and `list_knowledge_topic_articles`

can be passed straight into `get_knowledge_article`.

Rate limit

240 requests per hour and IP. Every response carries `RateLimit` and `RateLimit-Policy`

(IETF draft) plus the legacy `RateLimit-Limit` / `-Remaining` / `-Reset` triple. Over the

limit the server answers HTTP 429 and JSON-RPC

`-32603` with `data.retryAfterSeconds`, plus a `Retry-After` header.

Using the content

Articles may be quoted and summarized with attribution to Blck Alpaca and a link to the

article URL returned by the tool.

Links

• Developer documentation: DE · EN · SK
• OpenAPI spec of the surrounding REST API: https://blckalpaca.at/openapi.json
• Server card: https://blckalpaca.at/.well-known/mcp/server-card.json
• Smithery: https://smithery.ai/server/blckalpaca/knowledge-base
• Manifest: `server.json`

Contact

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