Itential Mcp
🔌 Itential Platform 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
- 79 Automation Tools (all enabled by default): Comprehensive toolkit across 13 tag categories for all network automation needs
- Advanced Tool Selection: Filter and control available tools using flexible tagging system
- Multiple Transport Methods: stdio and HTTP (Streamable HTTP, recommended) transports with optional TLS encryption; legacy SSE transport is also available but deprecated
- 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.11 or higher
- Access to an Itential Platform Instance
- For development -
uvandmake
Tested Python Versions
This project is automatically tested against the following Python versions:
- Python 3.11
- Python 3.12
- Python 3.13
- Python 3.14
🔧 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
From the project's README.