Kettlelogic MCP server

mcp-kettlelogic

A Model Context Protocol (MCP) server that exposes a Kettle Logic site's published content — whitepapers/playbooks ("insights") and industry pages — to any MCP-capable agent (Claude Desktop, IDEs, custom orchestrators).

It is a pure, read-only client of the public website: it fetches content live over HTTP and parses it with the Python standard library. No database, no API keys, no dependency on any backend cluster or LLM. The target site is configurable, so you can point it at your own deployment — or any site with the same shape — and see what it discovers.

Built on the official mcp Python SDK (FastMCP), speaking the standard stdio transport (and an optional streamable-http transport for container/Kubernetes deployment).

Engineering note: this repository doubles as a reference for how we build —

hexagonal layering, fully-typed OO, dependency injection, and a suite of

ratchets (see ARCHITECTURE.md) that enforce the rules

in CI. pytest runs unit tests, real-stdio e2e tests, and the ratchets together.

What it exposes

Tools

Resources

Discovery is live: articles from the site's /insights/ index, industries from its /llms.txt (falling back to crawling /industries/).

Install & run

pip install .            # Python >= 3.11; pulls in mcp + httpx
mcp-kettlelogic          # console script (stdio transport by default)

Normally an MCP client launches it. To explore interactively:

npx @modelcontextprotocol/inspector mcp-kettlelogic

Use it in an MCP client

{
  "mcpServers": {
    "kettlelogic": {
      "command": "mcp-kettlelogic",
      "env": { "KETTLELOGIC_BASE_URL": "https://kettlelogic.com" }
    }
  }
}

Or connect to the hosted server (no install)

A hardened instance runs live over streamable-HTTP — point any MCP client at it:

{
  "mcpServers": {
    "kettlelogic": { "url": "https://kettlelogic.com/mcp" }
  }
}

Publishing to the MCP registry

This server is listed in the public MCP registry as com.kettlelogic/mcp-kettlelogic (brand: kettlelogic, not a personal GitHub handle). server.json is the manifest — it advertises the hosted streamable-HTTP remote and validates against the 2025-12-11 schema.

The listing is claimed by HTTP domain ownership, not a GitHub login: the registry fetches https://kettlelogic.com/.well-known/mcp-registry-auth (a public-key challenge served by the marketing site — web/public/.well-known/mcp-registry-auth in the kettlelogic repo) and verifies a signature made with our Ed25519 private key.

Automated (on a self-hosted runner)

Shortened. The full README is on GitHub.