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 GitHubWhat 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.