Ongrid MCP Server

<img src="web/public/ongrid-logo.svg" alt="" width="40" align="absmiddle" style="vertical-align: middle;" /> Ongrid

An ops AI Agent that understands your infrastructure, finds the root cause, and fixes it — right from Slack or Telegram.

Metrics · logs · traces · topology blast-radius · root-cause correlation · remote execution · alert-driven auto-investigation · RAG knowledge & code search · specialist agents & skills.

<p> <a href="https://trendshift.io/repositories/48061?utm_source=repository-badge&amp;utm_medium=badge&amp;utm_campaign=badge-repository-48061" target="_blank" rel="noopener noreferrer"> <img src="https://trendshift.io/api/badge/repositories/48061" alt="Ongrid on Trendshift" width="250" height="55" /> </a> </p>

English | 简体中文 | 日本語 | 한국어 | Español | Français | Deutsch | Português | Русский

---

<p align="center"> <img src="docs/assets/demo.gif" alt="Ongrid demo" width="100%" /> </p> <p align="center"> <img src="docs/assets/kubernetes-release-banner.png" alt="Kubernetes lifecycle management" width="100%" /> <br /> <strong>☸️ Kubernetes lifecycle management is now available</strong><br /> _{Enroll clusters through Edge, inspect workloads and events, manage upgrades, and connect Kubernetes resources to topology.} </p> <div align="center">

Features • Install • Integrations • License

</div>

Features

• 🤖 Coordinator + Specialist agents — coordinator dispatches to SRE / network / DB sub-agents
• 🚨 Auto-investigate on alert — investigator spawns an RCA worker, writes the cause back to chat
• 🔍 Root-cause RCA — walks topology, correlates m/l/t, pins the "why" to a source-code line
• 🔒 Zero inbound ports — edge dials out; no port 22 / 80 / 443 on hosts
• 💻 Browser SSH — reverse-tunnel shell into any host; no keys, no jumpbox, all audited
• 🐳 Self-host in one command — install.sh brings up the full stack
• 📊 Built-in observability — Prometheus + Loki + Tempo + Grafana wired; the agent writes the queries
• 🧠 Bring your own model — Anthropic / OpenAI / GLM / DeepSeek / Gemini / Kimi, hot routing
• 💬 Two-way IM channels — Slack / Telegram / Larksuite / DingTalk / WeCom, per-channel locale
• 🛠️ Read-only host tools — bash sandbox + 26+ inspection tools; every call audited
• ☸️ Kubernetes lifecycle — enroll clusters, inspect workloads and events, manage upgrades, and mirror Kubernetes resources into topology
• 🌐 Network device management — discover neighbors from Edge hosts, verify with SNMP, poll interfaces, and map host-to-network-device links

Install

Download the latest release for your server architecture (linux-amd64 or linux-arm64), extract it, and run the installer (Ubuntu 22.04+, Debian 12+, RHEL/Rocky 9):

Choose the command for your server architecture:

AMD64

wget https://github.com/ongridio/ongrid/releases/download/v0.20.0/ongrid-v0.20.0-linux-amd64.tar.xz
tar -xf ongrid-v0.20.0-linux-amd64.tar.xz && cd ongrid-v0.20.0-linux-amd64
sudo ./install.sh

ARM64

wget https://github.com/ongridio/ongrid/releases/download/v0.20.0/ongrid-v0.20.0-linux-arm64.tar.xz
tar -xf ongrid-v0.20.0-linux-arm64.tar.xz && cd ongrid-v0.20.0-linux-arm64
sudo ./install.sh

🇨🇳 Mainland China — if GitHub is slow, use the matching CDN mirror URL instead:

# AMD64
wget https://ongrid.cloud/dl/ongrid-v0.20.0-linux-amd64.tar.xz

# ARM64
wget https://ongrid.cloud/dl/ongrid-v0.20.0-linux-arm64.tar.xz

Product Tour

Root Cause Analysis

<p align="center"> <img src="docs/assets/readme-tour/user-20260707-agent-write-gate.png" alt="Root cause analysis report" width="100%" /> </p>

Start from an operator question or alert, collect topology and device context, and produce an evidence-backed analysis with concrete next steps.

Workflow Builder

<p align="center"> <img src="docs/assets/readme-tour/user-20260707-workflow-editor.png" alt="Workflow builder" width="100%" /> </p>

Wire triggers, agents, tools, conditions, and notifications into repeatable automations that stay editable and reviewable.

Skills Catalog

<p align="center"> <img src="docs/assets/readme-tour/user-20260707-skills-catalog.png" alt="Skills catalog" width="100%" /> </p>

Show the tools agents can call, with clear descriptions and a visible inventory for operators.

MCP Servers

<p align="center"> <img src="docs/assets/readme-tour/user-20260707-mcp-servers.png" alt="MCP servers" width="100%" /> </p>

Register external MCP servers and expose their tools to chat agents and workflows with clear runtime and trust boundaries.

Knowledge Vault

<p align="center"> <img src="docs/assets/readme-tour/user-20260707-knowledge-vault.png" alt="Knowledge vault" width="100%" /> </p>

Index runbooks, notes, incident history, and repositories so both humans and agents can search the same operational context.

Artifacts Center

<p align="center"> <img src="docs/assets/readme-tour/user-20260707-artifacts-pages.png" alt="Artifacts center" width="100%" /> </p>

Keep generated pages and reports in one place, with private-by-default sharing and a clean handoff for review.

Monitoring

<p align="center"> <img src="docs/assets/readme-tour/user-20260707-monitor.png" alt="Monitoring" width="100%" /> </p>

Inspect fleet health, logs, traces, and alert state from the same workspace where the agent gathers evidence.

Topology Map

<p align="center"> <img src="docs/assets/readme-tour/user-20260707-topology-map.png" alt="Topology map" width="100%" /> </p>

Visualize dependencies and blast radius so incidents can be traced through the affected service graph.

Approval and Write Gate

<p align="center"> <img src="docs/assets/readme-tour/user-20260707-rca-session.png" alt="Approval and write gate" width="100%" /> </p>

Keep risky actions behind approvals, with a visible policy boundary before anything changes production systems.

Documentation

The full product documentation is available at ongrid.cloud.

Area	Start here
Get started	Introduction · Quickstart · Architecture · Concepts
Install & operate	Server install · Edge install · First boot · Upgrade
Capabilities	Alerts · RCA · Monitoring · Logs · Traces · Knowledge · Skills
Agents	Overview · Coordinator · Incident investigator · Specialists · Reviewer
Reference	API · CLI · Alert rules · Skill manifest · Data plane

Integrations

Drop-in for the observability, channel, and model stacks your team already uses.

Observability	<img src="docs/assets/integrations/prometheus.svg" alt="Prometheus" title="Prometheus" width="28" height="28" />   <img src="docs/assets/integrations/grafana.svg" alt="Grafana" title="Grafana" width="28" height="28" />   <img src="docs/assets/integrations/loki.svg" alt="Loki" title="Loki" width="28" height="28" />   <img src="docs/assets/integrations/elasticsearch.svg" alt="Elasticsearch" title="Elasticsearch" width="28" height="28" />   <img src="docs/assets/integrations/tempo.svg" alt="Tempo" title="Tempo" width="28" height="28" />   <img src="docs/assets/integrations/pyroscope.svg" alt="Pyroscope" title="Pyroscope" width="28" height="28" />   <img src="docs/assets/integrations/opentelemetry.svg" alt="OpenTelemetry" title="OpenTelemetry" width="28" height="28" />   <img src="docs/assets/integrations/qdrant-icon.svg" alt="Qdrant" title="Qdrant" width="28" height="28" />
Platforms	<img src="docs/assets/integrations/kubernetes.svg" alt="Kubernetes" title="Kubernetes" width="28" height="28" />   <img src="docs/assets/integrations/docker.svg" alt="Docker" title="Docker" width="28" height="28" />
Database metrics	<img src="docs/assets/integrations/mysql.svg" alt="MySQL" title="MySQL" width="28" height="28" />   <img src="docs/assets/integrations/postgresql.svg" alt="PostgreSQL" title="PostgreSQL" width="28" height="28" />   <img src="docs/assets/integrations/redis.svg" alt="Redis" title="Redis" width="28" height="28" />   <img src="docs/assets/integrations/mongodb.svg" alt="MongoDB" title="MongoDB" width="28" height="28" />
Channels	<img src="docs/assets/integrations/slack-icon.svg" alt="Slack" title="Slack" width="28" height="28" />   <img src="docs/assets/integrations/telegram.svg" alt="Telegram" title="Telegram" width="28" height="28" />   <img src="docs/assets/integrations/larksuite.svg" alt="Larksuite" title="Larksuite" width="28" height="28" />   <img src="docs/assets/integrations/dingtalk.svg" alt="DingTalk" title="DingTalk" width="28" height="28" />   <img src="docs/assets/integrations/wecom.svg" alt="WeCom" title="WeCom" width="28" height="28" />   <img src="docs/assets/integrations/webhooks.svg" alt="Webhook" title="Webhook" width="28" height="28" />
Models	<img src="docs/assets/integrations/claude.svg" alt="Anthropic" title="Anthropic" width="28" height="28" />   <img src="docs/assets/integrations/openai.svg" alt="OpenAI" title="OpenAI" width="28" height="28" />   <img src="docs/assets/integrations/gemini.svg" alt="Gemini" title="Gemini" width="28" height="28" />   <img src="docs/assets/integrations/deepseek.svg" alt="DeepSeek" title="DeepSeek" width="28" height="28" />   <img src="docs/assets/integrations/zhipu.svg" alt="Zhipu" title="Zhipu" width="28" height="28" />   <img src="docs/assets/integrations/kimi.svg" alt="Kimi" title="Kimi" width="28" height="28" />   <img src="docs/assets/integrations/minimax.svg" alt="MiniMax" title="MiniMax" width="28" height="28" />   <img src="docs/assets/integrations/mimo.svg" alt="Xiaomi MiMo" title="Xiaomi MiMo" width="28" height="28" />
Tools & search	<img src="docs/assets/integrations/mcp.svg" alt="Model Context Protocol" title="Model Context Protocol" width="28" height="28" />   <img src="docs/assets/integrations/searxng.svg" alt="SearXNG" title="SearXNG" width="28" height="28" />   <img src="docs/assets/integrations/tavily.svg" alt="Tavily" title="Tavily" width="28" height="28" />   <img src="docs/assets/integrations/brave.svg" alt="Brave Search" title="Brave Search" width="28" height="28" />

License

AGPLv3 — see LICENSE.

Ongrid brand assets are not licensed under AGPLv3. See TRADEMARK.md.