Edge Delta MCP Server

The Edge Delta MCP Server is a Model Context Protocol (MCP)

server that provides seamless integration with Edge Delta APIs, enabling advanced

automation and interaction capabilities for developers and tools.

Use Cases

• Extract and analyse observability data from Edge Delta.
• Build AI‑powered tools and applications that interact with Edge Delta’s platform.

Pipeline Configuration Tools

The server exposes tools to inspect and change Edge Delta pipelines. Write

operations follow a safe loop: validate → save → deploy, with rollback.

Typical edit flow: `get_pipeline_config` → edit YAML → `validate_pipeline_config`

→ `save_pipeline_config` → `get_pipeline_history` → `deploy_pipeline`

(`revert_pipeline` to roll back).

Live-capture tools

Validating that a config is *valid* is not the same as confirming a change

actually *transformed the data*. The live-capture tools sample real

before/after data flowing through pipeline nodes on running agents, so an agent

can verify a transformation took effect.

Capture flow: `start_pipeline_capture` → `get_pipeline_capture_status` (poll until

an agent reports `success`) → `get_pipeline_capture_results` (compare each node's

`before` vs `after` to confirm the transformation).

Processor dry-run (test) tools

Develop and verify a processor against sample logs offline — no save, no

deploy, no live traffic. The offline complement to live-capture: capture proves

what *did* happen, this proves what *will* happen.

Iterate until the output is right, then add the statements/node to the pipeline,

`save_pipeline_config` → `deploy_pipeline`, and confirm on live data with the

capture tools. Use `test_pipeline_ottl` for OTTL transforms (its `ExtractPatterns`

also covers regex field extraction); use `test_pipeline_node` for non-OTTL node

types such as log-to-metric and log-to-pattern.

Prerequisites

1. Docker Engine ≥ 20.10 installed *and running*.

2. Docker Buildx plug‑in available:

sudo apt-get update && sudo apt-get install -y docker-buildx-plugin

sudo dnf install -y docker-buildx-plugin   # or yum install …

mkdir -p ~/.docker/cli-plugins
     curl -sSL \
       https://github.com/docker/buildx/releases/latest/download/buildx-$(uname -s | tr '[:upper:]' '[:lower:]')-amd64 \
       -o ~/.docker/cli-plugins/docker-buildx
     chmod +x ~/.docker/cli-plugins/docker-buildx

3. An Edge Delta API token with the required scope – create one here.

4. Your Edge Delta organisation ID – find it here.

Build (container image)

First‑time setup (creates a multi‑platform builder and boots it):

docker buildx create --name edgedelta-builder --use
docker buildx inspect --bootstrap

Build the image and load it into the local Docker daemon:

docker buildx build --load -t mcp/edgedelta .

> ℹ️ The `--load` flag streams the image back to your local Docker engine so you can

> run it directly with `docker run mcp/edgedelta …`.

Installation

Usage with Cursor

{
  "mcpServers": {
    "edgedelta": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e ED_ORG_ID",
        "-e ED_API_TOKEN",
        "ghcr.io/edgedelta/edgedelta-mcp-server:latest"
      ],
      "env": {
        "ED_API_TOKEN": "",
        "ED_ORG_ID": ""
      }
    }
  }
}

Library Usage

The exported Go API of this module is experimental and may change without notice.

If you rely on it in production, please open an issue describing your use case so we

can stabilise the relevant surface.

License

Licensed under the terms of the MIT licence. See LICENSE for full details.