Command line tool and MCP

Added in version 1.1.0.

WPS has a command-line utility named wps

Here are listed all the subcommands it has.

wps explain

This command can be used to get description of violation. It will be the same description that is located on the website.

Syntax: wps explain <code>

Examples:

$ wps explain WPS115
WPS115 — Require ``snake_case`` for naming class attributes.

Attributes in Enum and enum-like classes (Django Choices)
are ignored, as they should be written in UPPER_SNAKE_CASE
...

$ wps explain 116
WPS116 — Forbid using more than one consecutive underscore in variable names.

Reasoning:
    This is done to gain extra readability.
...

MCP server

Added in version 1.8.0.

The best way to use our MCP is to use our /wps skill for your agent, it contains all the information about installing and starting the MCP server.

This command starts a Model Context Protocol server over standard input and output. The server exposes an explain_violation tool that returns the same description as wps explain.

Install the optional dependency before starting the server:

$ pip install 'wemake-python-styleguide[mcp]'

Next, run the server:

$ mcp run wemake_python_styleguide/mcp.py:mcp

The MCP SDK command-line tool can also open the server in the MCP Inspector:

$ mcp dev wemake_python_styleguide/mcp.py:mcp

These commands use the standard input and output transport, which does not listen on a network port.