# Kentik Mcp

> MCP Server for Kentik

- **Type:** MCP server
- **Install:** `agentstack add mcp-awlx-kentik-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [awlx](https://agentstack.voostack.com/s/awlx)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [awlx](https://github.com/awlx)
- **Source:** https://github.com/awlx/kentik-mcp

## Install

```sh
agentstack add mcp-awlx-kentik-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Kentik MCP Server

A [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server that provides LLM access to the [Kentik](https://www.kentik.com/) 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

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

Or build from source:

```bash
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` |

```bash
export KENTIK_EMAIL=user@example.com
export KENTIK_API_TOKEN=your_api_token_here
export KENTIK_REGION=US
```

## Usage

### With VS Code / GitHub Copilot

Add to your `.vscode/mcp.json`:

```json
{
  "servers": {
    "kentik": {
      "command": "kentik-mcp",
      "env": {
        "KENTIK_EMAIL": "user@example.com",
        "KENTIK_API_TOKEN": "your_api_token_here",
        "KENTIK_REGION": "US"
      }
    }
  }
}
```

### With Claude Desktop

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "kentik": {
      "command": "kentik-mcp",
      "env": {
        "KENTIK_EMAIL": "user@example.com",
        "KENTIK_API_TOKEN": "your_api_token_here",
        "KENTIK_REGION": "US"
      }
    }
  }
}
```

### Standalone (stdio)

```bash
./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](LICENSE).

This project is not affiliated with Kentik, Inc.

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [awlx](https://github.com/awlx)
- **Source:** [awlx/kentik-mcp](https://github.com/awlx/kentik-mcp)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-awlx-kentik-mcp
- Seller: https://agentstack.voostack.com/s/awlx
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.