patch-window-mcp

MCP server that gives AI assistants access to all Patch Window articles via a read-only JSON API.

Articles are fetched once at startup and cached in memory.

Installation

npm install -g patch-window-mcp

Or run directly with npx:

npx patch-window-mcp

Claude Desktop configuration

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "patch-window": {
      "command": "npx",
      "args": ["patch-window-mcp"]
    }
  }
}

If installed globally:

{
  "mcpServers": {
    "patch-window": {
      "command": "patch-window-mcp"
    }
  }
}

Tools

pw_list_articles

List all articles with metadata (no full content).

Parameter	Type	Required	Default	Description
format	"deep-dive" | "hot-take" | "brief"	No	—	Filter by article format
tag	string	No	—	Filter by tag, e.g. "grafana"
limit	number	No	20	Maximum number of articles to return

---

pw_get_article

Fetch a full article including MDX content.

Parameter	Type	Required	Description
slug	string	Yes	Article slug, e.g. "grafana-13-single-host-operators"

---

pw_search

Full-text search across title, excerpt, and content.

Parameter	Type	Required	Default	Description
query	string	Yes	—	Search string
format	"deep-dive" | "hot-take" | "brief"	No	—	Limit search to a specific format
limit	number	No	10	Maximum number of results

---

pw_latest

Fetch the most recently published articles.

Parameter	Type	Required	Default	Description
limit	number	No	5	Number of articles to return

---

pw_list_tags

List all unique tags with article counts, sorted descending.

No parameters.

Development

npm install
npm run build
node dist/index.js

License

MIT