Read-only MCP server for Patchwork (patchwork.kernel.org and other instances)
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"patchwork-mcp-server","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# patchwork-mcp-server A Model Context Protocol (MCP) server that exposes the [Patchwork](https://patchwork.kernel.org) REST API to LLM-based coding agents (Claude Code, Claude Desktop, Cursor, etc.). It is a thin, **read-only** wrapper around `/api/1.2/` so you can ask the agent things like: - "What's the state of my latest `seg6:` series on netdev?" - "Show me failing CI checks on patch 14553325." - "List the cover-letter thread for series 1089407." - "Find the patch with Message-Id `20260505-seg6-mobile-v2-0-...`." Without this server, the same questions either require a working `~/.pwclientrc` (which has trouble with CI checks and comment threads) or hand-rolled `curl` against the REST API. ## Install Requires Python 3.10+. Install with [uv](https://docs.astral.sh/uv/): ```bash # From PyPI (preferred once published) uv tool install patchwork-mcp-server # From a local checkout uv tool install . # From a Git remote uv tool install git+https://github.com/higebu/patchwork-mcp-server ``` The package installs a `patchwork-mcp-server` executable into `~/.local/bin/`. To refresh an existing install after editing source locally: ```bash uv tool install --reinstall . ``` ## Configuration | Variable | Default | Purpose | |-------------------------|--------------------------------|------------------------------------| | `PATCHWORK_URL` | `https://patchwork.kernel.org` | Base URL of the Patchwork instance | | `PATCHWORK_API_VERSION` | `1.2` | REST API version segment | Read-only access to public Patchwork instances needs no credentials. ## Connect to Claude Code After `uv tool install`, the executable is on your `PATH`, so registration needs no path: ```bash claude mcp add patchwork-mcp-server -- patchwork-mcp-server ``` For Claude Desktop, add it to `~/.config/claude/claude_desktop_config.json`: ```json { "mcpServers": { "patchwork": { …
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.