Skip to content

xpd mcp

Start the MCP server Use xpd mcp to give a coding agent xpd's tools through the Model Context Protocol. It starts the MCP server, which is Python and installs with the xpd package, and the arguments after mcp go to the server. The MCP server reference lists its tools, resources and prompts.

Terminal window
xpd mcp [ARGS]...

<ARGS>...

Arguments for the server, such as --transport http.

Every argument after it goes to it, flags included.

xpd mcp passes its arguments to the server, whose help lists these flags.

usage: xpd mcp [-h] [--root ROOT] [--code-mode | --no-code-mode] [--transport {stdio,http}]
[--host HOST] [--port PORT]
The xpd MCP server. It serves stdio unless --transport says otherwise.
options:
-h, --help show this help message and exit
--root ROOT The project root. Every path a tool gets must be inside it. Default:
XPD_MCP_ROOT, else the working directory. As an agent plugin, the default
is the first root the client names.
--code-mode, --no-code-mode
Show the tools through FastMCP's code mode, as search, get_schema and
execute. Default: XPD_MCP_CODE_MODE, else off.
--transport {stdio,http}
Default: FASTMCP_TRANSPORT, else stdio.
--host HOST Address to bind for http. Default: FASTMCP_HOST, else 127.0.0.1.
--port PORT Port for http. Default: FASTMCP_PORT, else 8000.
Terminal window
claude mcp add xpd -- uvx xpd mcp
uvx xpd mcp --transport http --port 8000

A binary built with cargo has no Python beside it, so its xpd mcp prints the command to use instead.

Terminal window
$ xpd mcp
xpd: xpd mcp needs xpd installed as a Python package. Run it as: uvx xpd mcp

The server's exit code passes through. xpd mcp itself exits 2 when the server cannot start, as when xpd is not installed as a Python package.