Auvik MCP server

Auvik MCP Server

MCP server for the Auvik network monitoring API. This server provides tools to interact with Auvik's network monitoring platform, allowing you to manage devices, networks, alerts, and more.

Features

• Multi-tenant support - Works in both single-tenant and gateway modes
• Comprehensive API coverage - 25+ tools covering all major Auvik API endpoints
• Transport flexibility - Supports both HTTP and stdio transports
• Type-safe - Built with TypeScript and Zod validation
• Docker ready - Available as a containerized solution

Tools Available

Status and Navigation

• auvik_status - Check server status and configuration
• auvik_navigate - Get navigation links to Auvik UI and documentation

Tenants

• auviktenantslist - List all accessible tenants
• auviktenantsget - Get basic tenant information
• auviktenantsdetail - Get detailed tenant information

Devices

• auvikdeviceslist - List network devices
• auvikdevicesget - Get basic device information
• auvikdevicesget_details - Get detailed device information
• auvikdevicesget_warranty - Get device warranty information
• auvikdevicesget_lifecycle - Get device lifecycle information

Networks

• auviknetworkslist - List discovered networks
• auviknetworksget - Get network information

Interfaces

• auvikinterfaceslist - List network interfaces

Configurations

• auvikconfigurationslist - List device configurations
• auvikconfigurationsget - Get specific configuration

Entities

• auvikentitieslist_notes - List entity notes
• auvikentitieslist_audits - List entity audit logs

Alerts

• auvikalertslist - List alert history. Scope to recent alerts with filterdetectedTimeAfter/filterdetectedTimeBefore (ISO 8601); filter by filterstatus/filterseverity; paginate by cursor with pageSize + pageAfter (follow the returned nextPageAfter). sort is a best-effort passthrough.
• auvikalertsget - Get specific alert
• auvikalertsdismiss - Dismiss/acknowledge alert

Statistics

• auvikstatisticsdevice - Get device performance metrics
• auvikstatisticsinterface - Get interface performance metrics
• auvikstatisticsservice - Get service performance metrics
• auvikstatisticssnmp_poller - Get SNMP poller metrics

Billing

• auvikbillingclient_usage - Get client billing usage
• auvikbillingdevice_usage - Get device billing usage

Raw

• auvikrawrequest - Make a raw request to any Auvik endpoint (method GET/POST, path, optional query/body). Returns the unmodified JSON:API response. For endpoints or params the typed tools don't expose.

Installation

Environment Variables

Single-tenant mode (stdio/direct):

AUVIK_USERNAME=your_auvik_username
AUVIK_API_KEY=your_auvik_api_key
AUVIK_REGION=us1  # Optional: us1, us2, us3, us4, us5, us6, lnx, eu1, eu2, au1, ca1

Gateway mode (HTTP):

Credentials are provided via request headers:

• x-auvik-username
• x-auvik-api-key
• x-auvik-region (optional)

Docker

# Pull from GitHub Container Registry
docker pull ghcr.io/wyre-ai/auvik-mcp:latest

# Run with environment variables
docker run -d \
  -p 8080:8080 \
  -e AUVIK_USERNAME=your_username \
  -e AUVIK_API_KEY=your_api_key \
  -e AUVIK_REGION=us1 \
  ghcr.io/wyre-ai/auvik-mcp:latest

Docker Compose

version: '3.8'
services:
  auvik-mcp:
    image: ghcr.io/wyre-ai/auvik-mcp:latest
    ports:
      - "8080:8080"
    environment:
      - AUVIK_USERNAME=your_username
      - AUVIK_API_KEY=your_api_key
      - AUVIK_REGION=us1

Local Development

git clone https://github.com/WYRE-AI/auvik-mcp.git
cd auvik-mcp
npm install
npm run build

# Run with stdio transport
npm start

# Run with HTTP transport
npm run start:http

Usage

With MCP Gateway

Shortened. The full README is on GitHub.