Cisco NSO MCP Server
Provides integration with Cisco NSO (Network Services Orchestrator) through its RESTCONF API, enabling AI-powered network automation with tools for managing device configurations, syncing device state, retrieving device platform information, managing service types and instances, and accessing device groups and NED IDs.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Cisco NSO MCP Server get the configuration for router-nyc-01"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Cisco NSO MCP Server
A Model Context Protocol (MCP) server implementation for Cisco NSO (Network Services Orchestrator) that exposes NSO data and operations as MCP primitives (Tools, Resources, etc.) that can be consumed by an MCP-compatible client, enabling AI-powered network automation through natural language interactions.
Sample Custom Client

Related MCP server: Cisco SD-WAN MCP Server
What is MCP?
Model Context Protocol (MCP) is an open protocol that standardizes how AI models interact with external tools and services. MCP enables:
Tool Definition: Structured way to define tools that AI models can use
Tool Discovery: Mechanism for models to discover available tools
Tool Execution: Standardized method for models to call tools and receive results
Context Management: Efficient passing of context between tools and models
Framework Agnostic: Works across multiple AI frameworks including OpenAI, Anthropic, Google Gemini, and others
Interoperability: Provides a common language for AI systems to communicate with external tools
Features
Stdio Transport: By default, this MCP server uses stdio transport for process-bound communication
Tool-First Design: Network operations are defined as discrete tools with clear interfaces
Asynchronous Processing: All network operations are implemented asynchronously for better performance
Structured Responses: Consistent response format with status, data, and metadata sections
Environment Resources: Provides contextual information about the NSO environment
NSO Integration: Uses cisco-nso-restconf library for a clean, Pythonic interface to NSO's RESTCONF API
Flexible Logging: Configurable logging to stdout and/or file via environment variables. When the
LOG_FILEenvironment variable is set, logs are sent to both stdout and the specified file. If the log file cannot be created or written to, the server falls back to stdout-only logging with an error messageMultiple Client Support: Works with any MCP-compatible client including Windsurf Cascade and custom Python applications
Available Tools and Resources
Tools
Tool Name | Description | Inputs | Returns |
| Retrieves Network Element Driver (NED) IDs from Cisco NSO | A dictionary with a list of NED IDs | |
| Retrieves device groups from Cisco NSO | A dictionary with a list of device groups | |
| Gets platform information for a specific device in Cisco NSO | 'device_name' (string) | A dictionary with platform information for the specified device |
| Gets full configuration for a specific device in Cisco NSO | 'device_name' (string) | A dictionary with configuration for the specified device |
| Gets state for a specific device in Cisco NSO | 'device_name' (string) | A dictionary with state for the specified device |
| Checks sync status for a specific device in Cisco NSO | 'device_name' (string) | A dictionary with sync status for the specified device |
| Syncs from a specific device in Cisco NSO | 'device_name' (string) | A dictionary with sync status for the specified device |
| Gets service types in Cisco NSO | A dictionary with service types | |
| Gets services for a specific service type in Cisco NSO | 'service_type' (string) | A dictionary with services for the specified service type |
Resources
https://resources.cisco-nso-mcp.io/environment: Provides a curated summary of the NSO environment:Device count, Operating System Distribution, Unique Operating System Count, Unique Model Count, Model Distribution, Device Series Distribution, Device Groups and Members
Requirements
Python 3.12+
Cisco NSO with RESTCONF API enabled
Network connectivity to NSO RESTCONF API
Configuration Options
You can configure the server using command-line arguments or environment variables:
NSO Connection Parameters
Command-line Argument | Environment Variable | Default | Description |
|
| http | NSO connection scheme (http/https) |
|
| localhost | NSO server address |
|
| 8080 | NSO server port |
|
| 10 | Connection timeout in seconds |
|
| admin | NSO username |
|
| admin | NSO password |
|
| True | Verify NSO HTTPS certificate (default: True). Use |
|
| None | Path to a CA bundle file to trust for NSO HTTPS. Applicable when |
MCP Server Parameters
Command-line Argument | Environment Variable | Default | Description |
|
| stdio | MCP transport type (stdio/http) |
HTTP Transport Options (only used when --transport=http)
FastMCP HTTP Server reference: https://gofastmcp.com/deployment/http#http-deployment
Command-line Argument | Environment Variable | Default | Description |
|
| 0.0.0.0 | Host to bind to when using HTTP transport |
|
| 8000 | Port to bind to when using HTTP transport |
Logging Configuration
Environment Variable | Default | Description |
| None | Path to log file. If not set, logs will be sent to stdout only |
Environment variables take precedence over default values but are overridden by command-line arguments.
Connecting to the Server with MCP Clients
You can connect to the server using any MCP client that supports the selected transport type. A few options are:
Windsurf Cascade
Windsurf Cascade supports MCP servers through a configuration file. To use the Cisco NSO MCP server with Windsurf, add it to your mcp_config.json file.
Using uv (recommended)
When using uv, no specific installation is needed. You can use uvx to directly run the package:
{
"mcpServers": {
"nso": {
"command": "uvx",
"args": [
"cisco-nso-mcp-server",
"--nso-address=127.0.0.1",
"--nso-port=8080",
"--nso-username=admin",
"--nso-password=admin"
],
"env": {
"LOG_FILE": "/path/to/your/logs/nso-mcp.log"
}
}
}
}Using with pip installation
Alternatively, you can install cisco-nso-mcp-server via pip:
pip install cisco-nso-mcp-serverNow you can use the direct path to the executable:
{
"mcpServers": {
"nso": {
"command": "/path/to/your/env/bin/cisco-nso-mcp-server",
"args": [
"--nso-address=127.0.0.1",
"--nso-port=8080",
"--nso-username=admin",
"--nso-password=admin"
],
"env": {
"LOG_FILE": "/path/to/your/logs/nso-mcp.log"
}
}
}
}Replace /path/to/your/env/bin/cisco-nso-mcp-server with the actual path where you installed the package with pip. You can find this by running which cisco-nso-mcp-server if you installed it in your main environment, or by locating it in your virtual environment's bin directory.
In either case, the env section is optional. If you include it, you can specify the LOG_FILE environment variable to enable file logging.
Using in a custom MCP client Python application with stdio transport
A sample Python application is provided in sample_stdio_client.py that demonstrates how to connect to the MCP server locally and execute a tool.
Running the Server as Standalone
While the server is typically used with an MCP client, you can also run it directly as a standalone process:
# Run with default NSO connection and MCP settings (see Configuration Options above for details)
cisco-nso-mcp-server
# Run with custom NSO connection parameters
cisco-nso-mcp-server --nso-scheme=http --nso-address=127.0.0.1 --nso-port=8080 --nso-username=admin --nso-password=adminWhen running as a standalone process with stdio transport, you'll need to pipe input/output to the process or use it with an MCP client that supports stdio transport.
License
This project is licensed under the MIT License. This means you can use, modify, and distribute the code, subject to the terms and conditions of the MIT License.
Available Tools
9 toolscheck_device_syncCheck Device Sync StatusBRead-only
Check the sync status for a specific device in Cisco NSO. Requires a 'device_name' parameter.
Inputs: params (required). Returns: object
get_device_configGet Device ConfigurationBRead-only
Retrieve the full configuration for a specific device in Cisco NSO. Requires a 'device_name' parameter.
Inputs: params (required). Returns: object
get_device_groupsGet Device GroupsBRead-only
Retrieve the available device groups in Cisco NSO.
Inputs: params. Returns: object
get_device_ned_idsGet Device NED ID'sBRead-only
Retrieve the available Network Element Driver (NED) IDs in Cisco NSO.
Inputs: params. Returns: object
get_device_platformGet Device Platform InformationBRead-only
Retrieve platform information for a specific device in Cisco NSO. Requires a 'device_name' parameter.
Inputs: params (required). Returns: object
get_device_stateGet Device StateBRead-only
Retrieve the state for a specific device in Cisco NSO. Requires a 'device_name' parameter.
Inputs: params (required). Returns: object
get_servicesGet ServicesBRead-only
Retrieve the available services in Cisco NSO. Requires a 'service_type' parameter.
Inputs: params (required). Returns: object
get_service_typesGet Service TypesBRead-only
Retrieve the available service types in Cisco NSO.
Inputs: params. Returns: object
sync_from_deviceSync DeviceC
Sync from a specific device in Cisco NSO. Requires a 'device_name' parameter.
Inputs: params (required). Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
Every tool has a clearly distinct purpose with no ambiguity. Tools are well-organized around specific resources (devices, services) and actions (check, get, sync), making it easy for an agent to select the right one. For example, get_device_config retrieves configuration while get_device_state retrieves state, and they are clearly differentiated.
Tool names follow a highly consistent verb_noun pattern throughout, with all tools using snake_case. The naming is predictable, such as get_device_config, check_device_sync, and sync_from_device, which enhances readability and agent usability. There are no deviations or mixed conventions.
With 9 tools, the count is well-scoped for managing Cisco NSO devices and services. Each tool earns its place by covering essential operations like configuration retrieval, status checks, and synchronization, without being overly sparse or bloated. This aligns well with the server's purpose of network device management.
The tool set provides strong coverage for device and service management in Cisco NSO, including retrieval, status checks, and synchronization. However, there are minor gaps, such as the lack of tools for modifying configurations or creating services, which agents might need to work around for full lifecycle management. Overall, it supports core workflows effectively.
Related MCP Connectors
Manage ConfigDirector feature flags, remote configs, and targeting rules from AI assistants.
Enables AI assistants to retrieve event data and execute event management operations in Nunify.
Deploy, monitor, and manage your OpenClaw AI assistants via natural language.
Provides capabilities that let LLM agents perform a range of infrastructure management tasks.
Related MCP Servers
- AlicenseBqualityDmaintenanceExposes Cisco Network Services Orchestrator (NSO) operations and data as MCP tools and resources, enabling AI-powered network automation through natural language. It supports tasks like retrieving device configurations, checking sync status, and managing services via the NSO RESTCONF API.914MIT
- AlicenseBqualityDmaintenanceEnables natural language automation of Cisco SD-WAN vManage, including device management, template deployment, policy configuration, monitoring, and software upgrades.2MIT
- FlicenseNot gradedqualityBmaintenanceEnables AI assistants to manage network devices via gNMI protocol, including querying capabilities, reading/modifying configurations, and subscribing to telemetry data through natural language.-
- AlicenseNot gradedqualityCmaintenanceEnables AI-assisted management of multi-vendor network devices (Cisco, Juniper, Nokia, Arista, Linux) through natural language, supporting health checks, configuration changes, routing analysis, and automation workflows.MIT