home / mcp / metoro mcp server

Metoro MCP Server

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "metoro-io-metoro-mcp-server": {
      "command": "<your path to Metoro MCP server go executable>/metoro-mcp-server",
      "args": [],
      "env": {
        "METORO_API_URL": "https://us-east.metoro.io",
        "METORO_AUTH_TOKEN": "<your auth token> exactly as provided in Claude config snippet>"
      }
    }
  }
}

You can run Metoro MCP Server to expose telemetry and observational data from your Kubernetes cluster to an LLM-based assistant. This server acts as a bridge, letting the Claude Desktop App query Metoro’s telemetry APIs through the MCP protocol so you can interact with cluster data in natural language.

How to use

You will run the Metoro MCP Server as a local process and point Claude Desktop App to it as an MCP server. Start by building the server, then configure Claude Desktop to reference the server using your authentication token. Once connected, you can ask questions about your Kubernetes cluster, telemetry, and observability data provided by Metoro.

How to install

Prerequisites you need before installing the MCP server:

- Claude Desktop App installed on your machine.

- Go programming language installed on your system.

Follow these steps to install and run the server:

Clone the repository, build the server, and start it.

# 1) Install Go if you have not already
# macOS (Homebrew)
brew install go
# Ubuntu
sudo apt-get update
sudo apt-get install -y golang-go

# 2) Clone the repository
git clone https://github.com/metoro-io/metoro-mcp-server.git
cd metoro-mcp-server

# 3) Build the server
go build -o metoro-mcp-server

# 4) Run the server (example path; adjust as needed)
./metoro-mcp-server

Configuration for Claude Desktop

You configure Claude Desktop to load the Metoro MCP Server by adding a server entry in Claude's MCP configuration using your local executable path and credentials.

If you already have a Metoro account, copy your auth token from Metoro and create the CLAUDE configuration file with the following content.

{
  "mcpServers": {
    "metoro-mcp-server": {
      "command": "<your path to Metoro MCP server go executable>/metoro-mcp-server",
      "args": [],
      "env": {
          "METORO_AUTH_TOKEN" : "<your auth token>",
          "METORO_API_URL": "https://us-east.metoro.io"
       }
    }
  }
}

Using a demo account without a Metoro account

If you do not have a Metoro account, you can use the Live Demo Cluster with a public demo token.

Create the Claude Desktop MCP configuration with the following content:

{
  "mcpServers": {
    "metoro-mcp-server": {
      "command": "<your path to Metoro MCP server go executable>/metoro-mcp-server",
      "args": [],
      "env": {
          "METORO_AUTH_TOKEN" : "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjdXN0b21lcklkIjoiOThlZDU1M2QtYzY4ZC00MDRhLWFhZjItNDM2ODllNWJiMGUzIiwiZW1haWwiOiJ0ZXN0QGNocmlzYmF0dGFyYmVlLmNvbSIsImV4cCI6MTgyMTI0NzIzN30.7G6alDpcZh_OThYj293Jce5rjeOBqAhOlANR_Fl5auw",
          "METORO_API_URL": "https://demo.us-east.metoro.io"
       }
    }
  }
}

Final steps to start using Metoro MCP Server

After editing Claude’s configuration, save the file and restart Claude Desktop. You should then see Metoro MCP Server appear in the MCP server dropdown, and you can begin querying Kubernetes telemetry through Claude.

Notes and tips

- The server exposes APIs to Claude through the MCP protocol, enabling natural language queries over your Kubernetes telemetry data.

- Ensure your METORO_API_URL points to the correct Metoro backend region for your account.