Distr MCP Server

Distr also exposes its endpoints via the model context protocol to allow LLM-powered agents to interact with the Distr tools.

Common use cases include:

Investigate which deployments are failing and why
Update deployments, for example, as part of n8n workflows
Interact with the Distr Platform through natural language prompts

Getting Started With the Distr MCP Server

The Distr MCP Server is a separate go command that can be compiled locally.

Build the Distr MCP Server

Make sure you have downloaded the Distr source code and have Go installed. Then, you can build the Distr MCP Server with the following command:

make build-mcp-server

After compilation, the MCP server binary will be available in the ./dist/ directory. Which can be verified with ./dist/mcp-server --help.

Configure the Distr MCP Server Tools

The Distr MCP Server exposes its executable functions via tools.

If you want to use all tools, you can extend your mcp.json configuration file in your MCP client:

{
  "servers": {
    "distr": {
      "command": "dist/mcp-server",
      "args": ["serve"],
      "tools": ["*"],
      "env": {
        "DISTR_TOKEN": "distr-..."
      }
    }
  }
}

You can also configure the optional environment variable DISTR_HOST to point the MCP server against a different Distr instance.

If configured correctly, your MCP client will list the available tools:

Sucessfull Distr MCP Server confguration

Interact with the Distr MCP Server

After configuring the Distr MCP Server, you can perform prompts that gather additional information from Distr via the Distr MCP Sever.

Get all deployments and group them by their status

Prompt
Response

Show me all distr deployments and group them by status.

Why do the deployments are in the status error, show the latest log.