🔌 Itential - MCP Server

by itential

33 stars
358 downloads
Not rated
GitHub

About

An MCP server that connects LLMs to the Itential Platform, enabling AI assistants to manage network automations, orchestrate workflows, monitor platform health, and perform advanced network operations. It is designed for platform engineers and developers.

Details

Author
itential
GitHub stars
33
Downloads
358
Categories
Other, Automation, AI

- 56+ automation tools across 10 tag categories
- Flexible transport: stdio, SSE, HTTP with optional TLS
- Dynamic tool discovery without code modifications
- Supports basic auth, OAuth 2.0, JWT, and RBAC
- Role-based tool configurations for different user types
- Filter tools using --include-tags and --exclude-tags

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name 🔌 Itential - MCP Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install via pip install itential-mcp, set platform credentials as environment variables (ITENTIAL_MCP_PLATFORM_HOST, ITENTIAL_MCP_PLATFORM_USER, ITENTIAL_MCP_PLATFORM_PASSWORD), and start the server with itential-mcp run. Optionally configure transport (stdio, SSE, HTTP), tool tags, and authentication via CLI flags or a configuration file. Docker images are also available.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "\ud83d\udd0c itential - mcp server": {
            "itential-mcp": {
                "command": "uv",
                "args": [
                    "run",
                    "itential-mcp",
                    "run"
                ]
            }
        }
    }
}

McpServers

{
    "itential-mcp": {
        "command": "uv",
        "args": [
            "run",
            "itential-mcp",
            "run"
        ]
    }
}

🔌 Itential - MCP Server

A Model Context Protocol _(MCP)_ server that provides comprehensive tools for connecting LLMs to Itential Platform. Enable AI assistants to manage network automations, orchestrate workflows, monitor platform health, and perform advanced network operations.

🎯 Who This Is For

Platform Engineers

Manage infrastructure, monitor system health, configure devices, and orchestrate network operations through AI-powered automation.

Developers

Build automation workflows, integrate with external systems, manage application lifecycles, and extend platform capabilities.

📒 Key Features

Core Capabilities

- 56+ Automation Tools: Comprehensive toolkit across 10 tag categories for all network automation needs - Advanced Tool Selection: Filter and control available tools using flexible tagging system - Multiple Transport Methods: stdio, SSE, and HTTP transports with optional TLS encryption - Dynamic Tool Discovery: Automatically discovers and registers tools without code modifications - Flexible Authentication: Supports basic auth, OAuth 2.0, JWT, and role-based access for Itential Platform - Comprehensive Configuration: CLI parameters, environment variables, or configuration files - Role-Based Access: Tailored tool configurations for Platform Administrators, Network Engineers, and Developers

Network Automation & Device Management

- Device Configuration: Apply configurations, backup device settings, and retrieve current configurations - Command Execution: Run single commands or command templates across multiple devices with rule validation - Device Groups: Create and manage logical device collections for streamlined operations - Compliance Management: Automated compliance plan execution and detailed reporting - Golden Configuration: Hierarchical template-based configuration management with version control

Workflow & Orchestration

- Workflow Execution: Start workflows via API endpoints and monitor execution status - Job Management: Track workflow jobs with comprehensive status, metrics, and task details - Workflow Exposure: Convert workflows into REST API endpoints for external consumption - Template Management: Create, update, and execute Jinja2 and TextFSM templates - Performance Metrics: Detailed job and task execution metrics for workflow optimization

Platform Operations & Monitoring

- Health Monitoring: Real-time platform health including system resources, applications, and adapters - Component Lifecycle: Start, stop, and restart applications and adapters with status monitoring - Integration Management: Create and manage OpenAPI-based integration models - Gateway Services: Execute external services (Ansible, Python scripts, OpenTofu) through Gateway Manager

Lifecycle & Resource Management

- Resource Models: Define JSON Schema-based resource structures with lifecycle workflows - Instance Management: Full CRUD operations on resource instances with state tracking - Action Execution: Run lifecycle actions with comprehensive execution history - Data Validation: Schema-based validation for resource data and action parameters

🔍 Requirements

- Python _3.10_ or higher - Access to an Itential Platform Instance - For _development_ - uv and make

Tested Python Versions

This project is automatically tested against the following Python versions: - Python 3.10 - Python 3.11 - Python 3.12 - Python 3.13

🔧 Installation

The itential-mcp application can be installed using either PyPI or it can be run directly from source.

PyPI Installation

To install it from PyPI, simply use pip:
pip install itential-mcp

Local Development

The repository can also be clone the repository to your local environment to work with the MCP server. The project uses uv and make so both tools would need to be installed and available in your environment.

The following commands can be used to get started.

git clone https://github.com/itential/itential-mcp
cd itential-mcp
make build

For development, you can run the server directly using uv:

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.