Skip to content
Distr

Distr MCP Server

Distr exposes its endpoints via the Model Context Protocol to allow LLM-powered agents to interact with Distr applications, deployments, and logs.

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

Section titled “Getting Started With the Distr MCP Server”

The Distr MCP server supports streamable HTTP and stdio as transport methods.

  1. Remote Hosted MCP server
  2. Locally Running MCP server

1. Using the Distr Hosted Remote MCP Server

Section titled “1. Using the Distr Hosted Remote MCP Server”

The Distr MCP server is hosted and secured by HyprMCP (https://hyprmcp.com).

It can be accessed via: https://glasskube.hyprmcp.cloud/distr/mcp.

Authentication

Section titled “Authentication”

Configure a personal access token (PAT) in an Authorization header when calling the MCP server.

Header name: Authorization

Header value: AccessToken distr-bc46...

Example configuration for Claude Code would look like:

Terminal window
claude mcp add --transport http distr https://glasskube.hyprmcp.cloud/distr/mcp --header "Authorization: AccessToken distr-bc46..."

2. Using the Distr MCP Server Locally

Section titled “2. Using the Distr MCP Server Locally”

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

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:

Terminal window
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.

Local MCP Server Configuration

Section titled “Local MCP Server Configuration”

The Distr MCP Server exposes its executable functions via tools.

To use all tools, extend your mcp.json configuration file in your MCP client:

mcp.json
{
  "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:

Successful Distr MCP Server configuration

Distr MCP Server Use Cases

Section titled “Distr MCP Server Use Cases”

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

Get All Deployments and Group Them by Status

Section titled “Get All Deployments and Group Them by Status”

Show me all distr deployments and group them by status.

Investigate Failed Deployments

Section titled “Investigate Failed Deployments”

Why are the deployments in error status? Show the latest log.