# Suzieq

MCP server to connect with SuzieQ, a network observability platform. Lets Claude and other AI tools run show and summarize commands against a live SuzieQ instance through its REST API.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: povedaaqui
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/povedaaqui/suzieq-mcp
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/suzieq

## What it does

The server exposes two tools: `run_suzieq_show` to query network state tables (interfaces, BGP, routes, devices) with filtering, and `run_suzieq_summarize` for aggregated statistics. Results come back as JSON strings directly from your SuzieQ instance.

You'll need Python 3.8+, the `uv` package manager, a running SuzieQ instance with REST API enabled, its API URL (e.g., `http://your-suzieq-host:8000/api/v2`), and an API key. The server reads configuration from a `.env` file in the project directory where you set `SUZIEQ_API_ENDPOINT` and `SUZIEQ_API_KEY`.

Install via Smithery with one command, or manually: clone the repo, create a virtual environment (`uv venv`), activate it, install dependencies (`uv pip install mcp httpx python-dotenv`), add your `.env` with credentials, then register the server in `claude_desktop_config.json` with the absolute path to `main.py` and `workingDirectory`.

## Requirements
- Needs: Docker

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- query interfaces by host or VRF filter
- retrieve BGP neighbors for a device
- find routes with conditions
- collect device data and status
- analyze network state tables with AI

## Example prompts
- Show all devices using the device table
- What are the BGP neighbors for spine01 using the bgp table and hostname:spine01 filter
- List up interfaces in VRF default with state:up and vrf:default filters

## Similar
- [dt-obs-network-devices](https://affpapa.org/en/nevibecode/skills/dt-obs-network-devices.md) — skill · 1200 installs
- [dt-obs-network-flows](https://affpapa.org/en/nevibecode/skills/dt-obs-network-flows.md) — skill · 1200 installs
- [openobserve-api](https://affpapa.org/en/nevibecode/skills/openobserve-api.md) — skill · ★ 1216 repo stars
- [gcp-slo-management](https://affpapa.org/en/nevibecode/skills/gcp-slo-management.md) — skill · ★ 151 repo stars
- [cli-anything-rms](https://affpapa.org/en/nevibecode/skills/cli-anything-rms.md) — skill · 514 installs
- [infrahub-mcp](https://affpapa.org/en/nevibecode/mcp/infrahub-mcp.md) — MCP server · ★ 10 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
