cisco-api-guide-mcp

Cisco API Guide MCP Server

A Model Context Protocol (MCP) server that gives AI assistants searchable, token-efficient access to Cisco product API documentation.

Overview

cisco-api-guide-mcp ships as a single self-contained binary with an embedded SQLite database of API endpoints, authentication guides, and reference content for:

• Cisco ACI — Application Centric Infrastructure
• Cisco NDFC — Nexus Dashboard Fabric Controller (formerly DCNM)
• Cisco Intersight / UCS — Unified Compute System

The server speaks the MCP protocol over stdio (JSON-RPC 2.0) and exposes three tools that an AI assistant can call to search endpoints, retrieve full endpoint details, and look up product authentication guides. It is intended for AI developers building automation, integrations, and tooling against Cisco infrastructure APIs.

Quick Start

1. Download the binary

Download the latest release for your platform from the GitHub Releases page:

Extract the archive and place the cisco-api-guide binary somewhere on your PATH.

2. Build from source

Requires Go 1.21+:

git clone https://github.com/brightpuddle/cisco-api-guide-mcp.git
cd cisco-api-guide-mcp
go build -o cisco-api-guide ./cmd/cisco-api-guide

Note: The build embeds the bundled API database at internal/embeddb/api.db. No external database or network access is required at runtime.

3. Configure your MCP client

The server runs as a stdio process. Add it to your MCP client configuration:

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "cisco-api-guide": {
      "command": "/usr/local/bin/cisco-api-guide"
    }
  }
}

OpenCode (opencode.json in your project or ~/.config/opencode/config.json):

{
  "mcp": {
    "cisco-api-guide": {
      "type": "stdio",
      "command": "/usr/local/bin/cisco-api-guide"
    }
  }
}

Any MCP-compatible client can be configured the same way: point command at the binary and use stdio transport.

Tools

search_endpoints

Search Cisco API endpoints by natural language or keywords. Returns a ranked list of matching endpoints.

get_endpoint

Get full detail for a specific Cisco API endpoint, including parameters, request body schema, and responses.

get_product_guide

Get authentication instructions and general usage notes for a Cisco product API.

Contributing

Contributions are welcome. Please see CONTRIBUTING.md for guidelines on reporting issues, submitting pull requests, and updating the API database using the ingestion tool.

For security vulnerabilities, follow the responsible disclosure process described in SECURITY.md.

License

SPDX-License-Identifier: Apache-2.0

Copyright 2026 Cisco Systems, Inc. and their affiliates

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.