Kentik

A Model Context Protocol (MCP) server that provides LLM access to the Kentik network observability platform.

Disclaimer: This is an unofficial, community-maintained project and is not affiliated with, endorsed by, or supported by Kentik, Inc. "Kentik" is a trademark of Kentik, Inc. This project uses the name solely to describe its compatibility with Kentik's publicly documented APIs.

Features

Tool	Description
kentik_list_devices	List all registered devices
kentik_search_devices	Search/filter devices by name, site, type, or label with summarized output
kentik_get_device	Get device details by ID
kentik_list_interfaces	List interfaces on a device
kentik_list_all_interfaces	List interfaces across all devices (bulk, rate-limited)
kentik_get_interface	Get interface details
kentik_query_data	Query flow data with convenience filters (connect type, port, ASN, IP), device label/site shortcuts, and auto-summarization
kentik_query_compare	Compare traffic volume (bytes) vs flow rate (fps) side-by-side with skew analysis
kentik_query_toptalkers	Quick top-talkers query by IP, ASN, port, country, or interface
kentik_compare_sites	Compare the same metric across multiple sites side-by-side
kentik_capacity_plan	Interface capacity report with utilization and threshold filtering
kentik_get_interface_counters	Query per-interface bandwidth with description filtering
kentik_list_alerts	List active alerts, alarms, and anomaly detections
kentik_list_dimensions	List all available query dimensions with descriptions
kentik_save_context	Save a named query context (device group + filters) for reuse
kentik_list_contexts	List saved query contexts
kentik_delete_context	Delete a saved query context
kentik_query_url	Generate a Kentik portal Data Explorer URL for a query
kentik_list_synthetic_tests	List all synthetic monitoring tests
kentik_get_synthetic_test	Get synthetic test details
kentik_get_synthetic_results	Get synthetic test probe results
kentik_list_synthetic_agents	List synthetic monitoring agents
kentik_get_synthetic_agent	Get synthetic agent details
kentik_get_synthetic_trace	Get traceroute data for a synthetic test
kentik_list_labels	List device labels
kentik_get_label	Get label details
kentik_list_sites	List all sites
kentik_get_site	Get site details
kentik_list_users	List all users
kentik_get_user	Get user details
kentik_list_tags	List flow tags
kentik_get_tag	Get tag details
kentik_ai_advisor	Ask Kentik's AI Advisor natural language questions about your network

Prerequisites

• Go 1.21+
• A Kentik account with API access
• Your Kentik email and API token (found in User Profile → Authentication)

Installation

go install github.com/awlx/kentik-mcp@latest

Or build from source:

git clone https://github.com/awlx/kentik-mcp.git
cd kentik-mcp
go build -o kentik-mcp .

Configuration

Set the following environment variables:

Variable	Required	Description
KENTIK_EMAIL	Yes	Your Kentik account email
KENTIK_API_TOKEN	Yes	Your Kentik API token
KENTIK_REGION	No	US (default) or EU

export [email protected]
export KENTIK_API_TOKEN=your_api_token_here
export KENTIK_REGION=US

Usage

With VS Code / GitHub Copilot

Add to your .vscode/mcp.json:

{
  "servers": {
    "kentik": {
      "command": "kentik-mcp",
      "env": {
        "KENTIK_EMAIL": "[email protected]",
        "KENTIK_API_TOKEN": "your_api_token_here",
        "KENTIK_REGION": "US"
      }
    }
  }
}

With Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "kentik": {
      "command": "kentik-mcp",
      "env": {
        "KENTIK_EMAIL": "[email protected]",
        "KENTIK_API_TOKEN": "your_api_token_here",
        "KENTIK_REGION": "US"
      }
    }
  }
}

Standalone (stdio)

./kentik-mcp

The server communicates over stdio using the MCP protocol.

Example Queries

Once connected, you can ask your LLM things like:

• "Search for border routers in the NYC site"
• "Show me the top 10 destination ASNs by traffic on PNI links in the last 24 hours"
• "What's the traffic breakdown by port on external links?"
• "Query flows per second by destination port, filtered to transit links"
• "What synthetic tests are configured?"
• "Ask Kentik AI: How are my devices doing?"
• "Which sites have the most devices?"

API Coverage

This MCP server covers:

• V5 REST APIs: Devices, interfaces, users, sites, labels, tags, and flow data queries
• V6 gRPC-gateway APIs: Synthetic monitoring (tests, agents, results, traces) and AI Advisor

For full Kentik API documentation, see: https://kb.kentik.com/docs/apis-overview

Rate Limits

Kentik applies rate limits per customer. Key limits:

Limit	Non-query APIs	Query API
Max concurrent	1	4
Soft limit/min	20	30
Hard limit/min	60	100
Hourly limit	3,750	1,500

AI Advisor has additional limits: 4 requests/min for create/update, 60 requests/min for polling.

License

MIT — see LICENSE.

This project is not affiliated with Kentik, Inc.