Skip to main content
MCP server CX Codex

Suzieq — MCP server for Claude Code: network queries via REST API

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.

no license updated 2026-10-29

Open on GitHub

What Suzieq 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.

What it helps with

  • 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 for the agent

  • 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

How to install Suzieq

Install

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

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about Suzieq

How do I install Suzieq MCP server?

Option 1 via Smithery: npx -y @smithery/cli install @PovedaAqui/suzieq-mcp --client claude. Option 2 manually: clone the repo, run uv venv, activate with source .venv/bin/activate (macOS/Linux) or .venv\Scripts\activate (Windows), run uv pip install mcp httpx python-dotenv, create .env with SUZIEQ_API_ENDPOINT and SUZIEQ_API_KEY, add the server to claude_desktop_config.json with the absolute path to main.py.

What does Suzieq MCP server do?

It bridges Claude and other AI tools to SuzieQ, a network observability platform. Through two tools (run_suzieq_show and run_suzieq_summarize), AI can query network state tables, apply filters, and retrieve results for analysis.

What are the requirements?

Python 3.8 or higher, the uv package manager, a running SuzieQ instance with REST API enabled, its API URL, and a valid API key. The server loads these from a .env file in the project directory.

Similar MCP servers

All MCP servers for Agent setup: memory, context, orchestration →

Project sponsors

Companies that keep this analytics open