SuzieQ

SuzieQ is an MCP server that connects large language model clients to the SuzieQ network observability platform via its REST API. Built using the Model Context Protocol SDK, httpx, and python-dotenv, this server allows network engineers, site reliability teams, and systems administrators to inspect network infrastructure state directly through conversational AI interfaces. By interfacing with SuzieQ's backend, the server translates tool calls into network queries against tables such as interfaces, devices, routes, and BGP sessions. Users can execute targeted inspections with custom filters or generate aggregate telemetry summaries without manually navigating web dashboards or issuing CLI commands. The integration helps users diagnose connectivity issues, verify network health, and track telemetry across distributed switching and routing fabrics, enabling fast visibility during troubleshooting and operational reviews.

Category: Cloud & Infrastructure

Tags: monitoring, network, observability, suzieq

Visit SuzieQ

How to install and configure SuzieQ

1. Ensure Python 3.8 or higher, uv, and an accessible SuzieQ REST API instance are available. 2. Clone the repository or download main.py and server.py into a project directory. 3. Create and activate a virtual environment using uv venv and source .venv/bin/activate (or .venv\Scripts\activate on Windows). 4. Install dependencies by running uv pip install mcp httpx python-dotenv. 5. Create a .env file in the project directory containing SUZIEQ_API_ENDPOINT=http://your-suzieq-host:8000/api/v2 and SUZIEQ_API_KEY=your_actual_api_key. 6. Add the server configuration to your claude_desktop_config.json: json { "mcpServers": { "suzieq-server": { "command": "uv", "args": ["run", "python", "/full/path/to/your/project/mcp-suzieq-server/main.py"], "workingDirectory": "/full/path/to/your/project/mcp-suzieq-server/" } } } 7. Restart Claude Desktop and verify that run_suzieq_show and run_suzieq_summarize appear in the tools menu.

What you can do with SuzieQ

• Query device inventory tables to inspect hardware status, hostnames, and system versions across your network infrastructure. - Check BGP peering session states and filter by specific spine or leaf switches to detect routing anomalies. - Inspect network interface operational states and filter by specific VRF assignments or link conditions to isolate drops. - Retrieve aggregated network statistics and summary metrics for quick health reviews during incident triage operations.

Key facts

• https://github.com/PovedaAqui/suzieq-mcp
• Cloud & Infrastructure, Monitoring & Observability
• monitoring, network, observability, suzieq

Part of MCP Servers

How do I install SuzieQ MCP server?

You can install it automatically for Claude Desktop using the Smithery CLI with npx -y @smithery/cli install @PovedaAqui/suzieq-mcp --client claude. Alternatively, clone the repository, create a virtual environment with uv, install the mcp, httpx, and python-dotenv packages, configure your SuzieQ credentials in a local .env file, and add the server definition to your Claude Desktop configuration file.

What can SuzieQ MCP server do?

The server exposes two primary tools: run_suzieq_show and run_suzieq_summarize. These tools allow MCP clients to query SuzieQ tables like device, interface, and bgp, apply key-value filters such as hostname or VRF name, and return detailed tables or summarized statistics directly to an AI client.

Which MCP clients work with SuzieQ?

It is designed to work with Claude Desktop over standard input and output. It can also be tested and integrated with the MCP Inspector utility or any custom client compatible with the Model Context Protocol.

What prerequisites are needed to run this server?

You need Python 3.8 or higher, the uv package manager, and a reachable SuzieQ instance with REST API v2 enabled. You will also need the API endpoint URL and a valid API access token to place in the local .env configuration file.