Cisco FMC MCP Server
Provides read-only access to Cisco Firepower Management Center (FMC) 7.4.x configuration, enabling queries for system information, managed devices, network objects, deployment status, and IP-based object search.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
MCP Server for Cisco FMC
A read-only Model Context Protocol (MCP) server for Cisco Firepower Management Center (FMC) 7.4.x.
This server allows LLMs like Claude to query your firewall configuration, search for network objects, and check deployment status—all through natural language.
Features
Read-Only Access: Safe exploration of FMC configuration without modification risk
Rate Limiting: Built-in token bucket rate limiter (120 req/min, 10 concurrent connections)
Automatic Token Refresh: Handles FMC's 30-minute token expiration and 3-refresh limit
Transparent Pagination: Automatically fetches all pages from large datasets
MCP Resources
Resource | Description |
| FMC server version and system information |
| List of all managed firewall devices |
| All network objects (IPs, subnets) |
| Devices with pending changes |
MCP Tools
Tool | Description |
| Find network objects containing a specific IP |
| Check if devices are in sync |
Related MCP server: Cisco Secure Firewall FMC MCP Connector
Installation
Prerequisites
Python 3.10+
uv (recommended) or pip
Access to a Cisco FMC 7.4.x instance
Using uv (Recommended)
# Clone the repository
git clone https://github.com/your-org/fmc-mcp.git
cd fmc-mcp
# Install dependencies
uv syncUsing pip
pip install -e .Configuration
Copy the example configuration:
cp .env.example .envEdit
.envwith your FMC credentials:
FMC_HOST=fmc.example.com
FMC_USERNAME=api_user
FMC_PASSWORD=your_password_hereConfiguration Options
Variable | Required | Default | Description |
| Yes | - | FMC hostname or IP |
| Yes | - | API username |
| Yes | - | API password |
| No |
| SSL certificate verification |
| No | auto | Domain UUID (auto-discovered) |
| No |
| Request timeout in seconds |
| No |
| Transport mode: |
| No |
| HTTP server host (HTTP mode only) |
| No |
| HTTP server port (HTTP mode only) |
Usage
Running the Server
stdio Mode (Default - for Claude Desktop)
# Using uv
uv run python -m fmc_mcp
# Or using the CLI entry point
uv run mcp-server-fmcHTTP/SSE Mode (for Integration Testing)
HTTP/SSE mode enables multiple client connections and integration testing scenarios:
# Set environment variable for HTTP mode
export MCP_TRANSPORT=http
export MCP_HOST=127.0.0.1 # Optional, defaults to 127.0.0.1
export MCP_PORT=8080 # Optional, defaults to 8080
# Run the server
uv run python -m fmc_mcpOr add to your .env file:
MCP_TRANSPORT=http
MCP_HOST=127.0.0.1
MCP_PORT=8080Benefits of HTTP/SSE mode:
Multiple concurrent client connections
Integration testing with Python MCP clients
Health checks and monitoring
Standard HTTP debugging tools
Testing Connection
uv run python -c "from fmc_mcp.client import FMCClient; import asyncio; asyncio.run(FMCClient().test_connection())"Claude Desktop Integration
Add to your Claude Desktop configuration (claude_desktop_config.json):
{
"mcpServers": {
"fmc": {
"command": "uv",
"args": ["run", "--directory", "/path/to/fmc-mcp", "python", "-m", "fmc_mcp"]
}
}
}Then restart Claude Desktop and try:
"What version is my FMC running?"
"List all firewall devices"
"Find the network object for IP 10.10.10.5"
"Are there any pending deployments?"
MCP Inspector Testing
# Install MCP Inspector
npx @anthropic/mcp-inspector
# Run the server
uv run python -m fmc_mcpDevelopment
Running Tests
# Run all tests
uv run pytest -v
# Run with coverage
uv run pytest --cov=src/fmc_mcp --cov-report=term-missingCode Quality
# Linting
uv run ruff check src/ tests/
# Type checking
uv run mypy src/API Rate Limits
The FMC API has strict rate limits that this server respects:
Limit | Value | How We Handle It |
Requests per minute | 120 | Token bucket rate limiter |
Concurrent connections | 10 | Connection semaphore |
Token lifetime | 30 min | Auto-refresh on 401 |
Max token refreshes | 3 | Full re-authentication after 3 |
The server logs warnings when approaching rate limits:
WARNINGwhen token bucket drops below 20%ERRORon 429 (rate limited) responses
Security Notes
Read-Only: This server only performs GET requests
SSL: Disabled by default for lab environments; enable in production
Credentials: Store in
.env, never commit to version controlAPI User: Create a dedicated read-only API user in FMC
License
Apache 2.0
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
An MCP server that provides an API to LLMs to manage their JumpCloud resources.
Official Microsoft MCP Server to query Microsoft Entra data using natural language
Read-only MCP server for AIStatusDashboard status, incidents, metrics, and fallback recommendations.
The HubSpot MCP Server acts as a bridge that enables AI assistants and Large Language Models to securely interact with HubSpot CRM data through natural conversation, without requiring users to understand complex API structures. It provides read-only access to standard CRM objects (contacts, companies, deals, tickets, products, invoices, and more) and their associations, secured via OAuth 2.0, allowing AI agents to perform tasks like summarizing deals, fetching company updates, and looking up record changes.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA read-only Model Context Protocol server that enables LLMs to query Cisco Firepower Management Center (FMC) for firewall configurations, network objects, and deployment status. It features automatic token management and built-in rate limiting to safely interact with FMC 7.4.x instances through natural language.Apache 2.0
- AlicenseNot gradedqualityCmaintenanceMCP server that exposes high-level tooling for Cisco Secure Firewall Management Center (FMC), allowing discovery of FMC profiles and searching access rules by IP, FQDN, or identity indicators.8MIT
- AlicenseNot gradedqualityDmaintenanceA read-only MCP server for Cisco Meraki Dashboard, enabling LLMs to discover devices, check health, troubleshoot, and generate reports via natural language.MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server for Cisco Catalyst SD-WAN that lets LLM clients query fabric inventory, device health, alarms, and path quality from vManage. It is read-only by default, with configuration-changing tools available only when explicitly enabled and requiring human confirmation.1MIT