MCP server enabling IDE agents to semantically search Cisco product API documentation hosted on DevNet.
The DevNet Content Search MCP server provides seamless access to Cisco's extensive API documentation and development resources through the Model Context Protocol (MCP). This server enables AI assistants and development tools like VS Code Copilot, Cursor, and other MCP-compatible IDEs to search, retrieve, and understand Cisco DevNet content for enhanced code generation and network automation tasks.
This MCP server acts as a bridge between AI-powered development environments and Cisco's comprehensive API documentation ecosystem, providing intelligent search capabilities across multiple Cisco platforms and technologies.
Need a specific product API? Create an issue to help us prioritize which APIs to add next!
Cmd+Shift+P (Mac) or Ctrl+Shift+P (Windows/Linux)MCP: Add ServerHTTPhttps://devnet.cisco.com/v1/foundation-search-mcp/mcpdevnet-content-searchGetting Started:
After installation, test the connection by asking Copilot:
Find Meraki L3 firewall API endpoints for configuring traffic rules
Cmd+Shift+P (Mac) or Ctrl+Shift+P (Windows/Linux)Tools & MCPAdd Custom MCP and configure:
{
"mcpServers": {
"devnet-content-search": {
"url": "https://devnet.cisco.com/v1/foundation-search-mcp/mcp"
}
}
}~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.jsonmcpServers section:
{
"mcpServers": {
"devnet-content-search": {
"command": "npx",
"args": [
"mcp-remote@latest",
"https://devnet.cisco.com/v1/foundation-search-mcp/mcp"
]
}
}
}claude mcp add devnet-content-search --transport http https://devnet.cisco.com/v1/foundation-search-mcp/mcp
claude mcp list
librechat.yaml in the root of your LibreChat installationmcpServers section:
mcpServers: devnet-content-search: type: http url: https://devnet.cisco.com/v1/foundation-search-mcp/mcp
Cmd+, on Mac or Ctrl+Alt+S on Windows/Linux){
"mcpServers": {
"devnet-content-search": {
"command": "npx",
"args": [
"mcp-remote@latest",
"https://devnet.cisco.com/v1/foundation-search-mcp/mcp"
]
}
}
}This server follows the standard MCP protocol and works with any compatible client. For implementation details, refer to the MCP specification.
Generic MCP Configuration:
Note: Some AI agents require choosing a transport type. If prompted, select http (or stream as your client names it) for this server URL.
Add this configuration to your MCP client's config.json:
{
"mcpServers": {
"devnet-content-search": {
"url": "https://devnet.cisco.com/v1/foundation-search-mcp/mcp"
}
}
}Copy → Paste → See Results:
Show me the latest API docs for Meraki L3 firewall settings
Find Meraki OAuth 2.0 API authentication documentation with setup flow
Find network device inventory management APIs for Catalyst Center
Show me details for createNetworkMerakiAuthUser operation
🔒 "I need to secure my network"
Show me L3 firewall rules configuration for Meraki
Find wireless SSID firewall policies for Meraki
How do I configure network security group rules in Meraki?
👤 "I'm building an authentication system"
Find OAuth authentication setup for Meraki APIs
Show me RADIUS server configuration API documentation for Meraki
How do I configure splash page captive portal using Meraki API?
⚙️ "I want to automate network management"
Show me VLAN management REST API documentation for Meraki
Find wireless access point configuration APIs for Meraki
How do I configure switch ports using Meraki API?
📊 "I need monitoring and troubleshooting"
Show me network device health monitoring APIs for Meraki
Find traffic analytics API endpoints in Meraki documentation
How do I set up webhook event notifications for Meraki?
Find assurance and troubleshooting APIs in Catalyst Center documentation
🎯 "I know exactly what I want"
Find details for createNetworkMerakiAuthUser operation
Show me updateNetworkApplianceFirewallL3FirewallRules API specification
Enterprise Network Management:
Show me network device inventory management APIs for Catalyst Center
Find device discovery and onboarding APIs for Catalyst Center
How do I manage network device configurations in Catalyst Center?
Policy and Compliance:
Find policy automation workflows for Catalyst Center
Show me compliance reporting APIs for Catalyst Center
How do I configure network segmentation policies in Catalyst Center?
Monitoring and Assurance:
Find assurance and troubleshooting APIs in Catalyst Center documentation
Show me network performance monitoring APIs for Catalyst Center
How do I get network health analytics from Catalyst Center?
Site and Topology Management:
Show me site hierarchy management APIs for Catalyst Center
Find network topology discovery APIs for Catalyst Center
How do I manage campus and branch locations in Catalyst Center?
✅ Be Specific: "L3 firewall rules" → Better than "firewall"
✅ Include Platform: "Meraki wireless access point API" → Better than "access point setup"
✅ Use Tech Terms: "VLAN management REST endpoints" → Better than "network segments"
For users who prefer direct tool invocation:
#Meraki-API-Doc-Search L3 firewall rules configuration
Tool ID: Meraki-API-Doc-Search
Search comprehensive Meraki API documentation covering network infrastructure management, security policies, wireless configuration, and monitoring capabilities.
Parameters:
keyword (required): Search terms for finding relevant documentationreturn_api_only (optional): Set to true for API specs only, false for complete documentation contexttop_k (optional): Number of results to return (default: 3, max: 10)Use Cases:
Response Structure:
All responses include structured data with these key fields:
Core Information:
name: Document or API endpoint titledescription: Brief summary of functionalitycontent: Full text content when applicableMetadata:
products: Associated Cisco product linestags: Searchable keywords and categoriescategories: Primary classification (e.g., "Networking", "Security")API-Specific Fields:
api_path: RESTful endpoint URL patternapi_method: HTTP verb (GET, POST, PUT, DELETE)api_operation_id: Unique OpenAPI operation identifieropenapi_specification: Complete API specification (JSON string)documentation_url: Direct link to official documentationSample Response:
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"content": [
{
"type": "text",
"text": "Found 2 results for Meraki authentication APIs:\n\n1. Create Network Meraki Auth User\n2. OAuth 2.0 Authentication Overview"
}
],
"structuredContent": {
"result": [
{
"name": "Create Network Meraki Auth User",
"description": "Authorize a user configured with Meraki Authentication for a network",
"products": ["Meraki"],
"tags": ["networks", "configure", "merakiAuthUsers"],
"categories": ["Networking"],
"api_path": "/networks/{networkId}/merakiAuthUsers",
"api_method": "post",
"api_operation_id": "createNetworkMerakiAuthUser",
"openapi_specification": "{\"description\": \"Authorize a user...\", \"operationId\": \"createNetworkMerakiAuthUser\", \"parameters\": [...], \"requestBody\": {...}, \"responses\": {...}}",
"documentation_url": "https://developer.cisco.com/meraki/api-v1/create-network-meraki-auth-user"
}
]
},
"isError": false
}
}Tool ID: CatalystCenter-API-Doc-Search
Access Catalyst Center API documentation for enterprise network management, automation workflows, and infrastructure orchestration.
Parameters:
keyword (required): Search terms for relevant documentationreturn_api_only (optional): Filter for API specifications vs. general documentationtop_k (optional): Maximum results to returnUse Cases:
Tool ID: Meraki-API-OperationId-Search
Retrieve specific API endpoint details using exact operation identifiers for precise documentation lookup.
Parameters:
operation_id (required): The exact OpenAPI operation ID (e.g., createNetworkMerakiAuthUser)Use Cases:
This feature uses artificial intelligence to enhance its capabilities. Please note that AI-generated results may sometimes be inaccurate or incomplete.
For example agent and prompt definitions that use this MCP server for more complex scenarios, see Experimental reference: Example agents and prompts.
If your assistant responds with generic networking advice instead of specific Cisco API documentation, try these approaches:
Instead of: "How do I configure a firewall?"
Try: "Show me the Meraki L3 firewall API endpoints for configuring traffic rules"
Instead of: "I need network monitoring tools"
Try: "Find Catalyst Center APIs for collecting device performance metrics"
Technology-Specific + Action-Oriented:
Current Documentation Requests:
Problem-Solution Approach:
Some development environments allow you to customize AI assistant behavior. Configure your IDE with specific instructions to ensure reliable tool usage:
VS Code/Cursor Custom Instructions:
For Cisco networking questions, always search official DevNet documentation first.
Use the available MCP tools for current API specifications rather than
providing general networking advice. Focus on specific Cisco platforms:
Meraki Dashboard, Catalyst Center, and DevNet resources.
Avoid Generic Terms That May Not Trigger Tools:
| Issue | Description | Solution |
|---|---|---|
| Input Validation Errors | Error: 'keyword' is a required property |
Ensure all required parameters are provided according to the tool's schema |
| Rate Limiting | Error: Rate limit exceeded. Please wait before sending another request |
Wait before retrying your request. Consider spacing out queries over time |
| Service Unavailability | Error: Search Service is Unavailable |
The backend search engine is experiencing issues. Please contact the DevNet team |
| No Results Found | Empty or minimal search results | • Try broader search terms • Check spelling and technical terminology • Use alternative keywords or synonyms |
| MCP Server Connection | Server not responding or unavailable | • Verify MCP server configuration • Check network connectivity • Restart IDE or MCP client |
| Authentication Issues | API access denied or forbidden | • Verify API credentials • Check organization access permissions • Contact DevNet support for access issues |
If you encounter issues or need assistance:
This project is licensed under the Apache License 2.0.
Owner
Contributors
Categories
NetworkingProducts
Catalyst CenterMerakiAI
MCP ServersDeploy Type
HTTP/StreamFeatures / Capabilities
ToolsLicense
Code Exchange Community
Get help, share code, and collaborate with other developers in the Code Exchange community.View Community