veeam-ports-mcp
Provides structured access to Veeam product network port requirements via the Magic Ports API, enabling queries for ports, generation of topology diagrams, and creation of firewall rule import files for 25+ Veeam products.
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., "@veeam-ports-mcp What ports does VBR v13 need?"
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.
Veeam Ports MCP Server
An MCP (Model Context Protocol) server that gives Claude structured access to Veeam product network port requirements. Query ports, generate topology diagrams, and produce firewall rule import files — all from natural language.
Backed by the Magic Ports API, covering 25+ Veeam products.
Installation
Claude Desktop
Add to your Claude Desktop config:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"veeam-ports": {
"command": "uvx",
"args": ["veeam-ports-mcp"]
}
}
}Requires uv — a single binary install. uvx downloads and runs the package automatically with no repo clone needed.
VS Code / Claude Code
claude mcp add veeam-ports -- uvx veeam-ports-mcpDevelopment Install
git clone https://github.com/shapedthought/veeam-ports-mcp.git
cd veeam-ports-mcp
uv syncClaude Desktop config for a local dev install:
{
"mcpServers": {
"veeam-ports": {
"command": "uv",
"args": [
"run",
"--directory", "/path/to/veeam-ports-mcp",
"veeam-ports-mcp"
]
}
}
}Related MCP server: Veeam Intelligence MCP Server
Available Tools
Tool | Description |
| List all Veeam products with port data |
| List available service roles for a product — call this before |
| Get all port requirements for a product |
| Get section headings for a product — use to find valid |
| Free-text keyword search across all products |
| Find which products and services use a specific port |
| Source services with their section groupings |
| Port data with LLM-parsed service metadata |
| Resolve firewall rules between named servers in your environment |
| Generate a JSON import file for the Magic Ports frontend app |
Topology & Import File Workflow
Call
list_servicesto see available service roles for the productAsk the user which servers they have and what roles each one serves
Call
generate_topologyorgenerate_app_importwith the server definitionsOptionally exclude subsections (e.g.
CDP Components) or specific ports withexclude_subsections/exclude_ports
User: "Generate firewall rules for my VBR v13 environment.
I have a VBR server, two Linux proxies, a repo, and ESXi hosts behind vCenter."
Claude: [calls list_services → generate_app_import]
"Import file saved: ~/Documents/veeam-ports-exports/magic-ports-vbr-v13-import.json"Generated files are saved to ~/Documents/veeam-ports-exports/ by default.
Example Prompts
"What ports does VBR v13 need?"
"Which products use port 902 and why?"
"Show me all ports the backup server uses to talk to ESXi hosts"
"Generate firewall rules for my VBR environment — I have a VBR server, a Linux proxy, a repo server, and ESXi hosts managed by vCenter"
"Create a Magic Ports import file for my VB365 deployment, excluding the proxy ports"
"What ports does the Veeam ONE server need open?"
Configuration
Environment Variable | Default | Description |
|
| API base URL |
|
| Directory for generated import files |
Debugging
Use the MCP Inspector to test tools interactively:
npx @modelcontextprotocol/inspector uvx veeam-ports-mcpLicense
MIT
Available Tools
11 toolsgenerate_app_importA
Generate a JSON file for importing into the Magic Ports frontend app.
Resolves the port mapping topology between user-defined servers using the enriched knowledge graph on the API server. The full JSON is written to a file on disk and a compact summary is returned.
Workflow:
Call list_services to see available service roles for the product.
Ask the user which servers they have and what roles they serve.
Call this tool with the server definitions.
Present the generated file to the user for download/import.
Args: product_name: Exact product name (e.g. 'VBR v13', 'VB365') servers_json: JSON array of server definitions. Each object must have 'name' (server label) and 'services' (list of service names this server provides). Example: [ {"name": "VBR", "services": ["Backup server"]}, {"name": "Proxy", "services": ["Backup proxy"]}, {"name": "Repo", "services": ["Backup repository"]}, {"name": "ESXi", "services": ["ESXi host", "vCenter Server"]} ] output_dir: Optional directory to write the file to. Defaults to ~/Documents/veeam-ports-exports or VEEAM_PORTS_OUTPUT_DIR env var. exclude_subsections: Subsection names to exclude from results (e.g. ["CDP Components"]). Accepts a list or JSON string. exclude_ports: Port numbers to exclude from results (e.g. ["33035"]). Accepts a list or JSON string. format: Output format — 'json' (default), 'csv', or 'markdown'. csv and markdown return the raw content as text (no file written).
Inputs: product_name (required), servers_json (required), output_dir, exclude_subsections, +2 more. Returns: result
generate_topologyA
Resolve server topology — given named servers and their services, returns all port mappings between them as human-readable text.
Use this when the user describes their server layout and wants to know what firewall rules are needed between servers.
Args: product_name: Exact product name (e.g. 'VBR v13', 'VB365') servers_json: JSON array of server definitions. Each object must have 'name' (server label) and 'services' (list of service names this server provides). Example: [ {"name": "VBR", "services": ["Backup server"]}, {"name": "Proxy", "services": ["Backup proxy"]}, {"name": "ESXi", "services": ["ESXi host"]} ] include_loopback: Include ports where source and target are the same server (default: false) exclude_subsections: Subsection names to exclude from results (e.g. ["CDP Components"]). Accepts a list or JSON string. exclude_ports: Port numbers to exclude from results (e.g. ["33035"]). Accepts a list or JSON string. format: Output format — 'json' (default), 'csv', or 'markdown'. csv and markdown return the raw content as text.
Inputs: product_name (required), servers_json (required), include_loopback, exclude_subsections, +2 more. Returns: result
get_enriched_portsA
Get port data with LLM-parsed service metadata for a product.
Returns the same port entries as get_product_ports, plus enriched metadata for each source and target service (canonical name, roles, OS, hypervisor, storage type). Useful for understanding service relationships and filtering by role.
Returns 404 if enrichment hasn't been run for this product.
Args: product_name: Exact product name (e.g. 'VBR v13', 'VB365')
Inputs: product_name (required). Returns: result
get_product_portsA
Get all network port requirements for a specific Veeam product.
Returns every port entry including source service, target service, port number, protocol, and description. Use list_products first to find valid product names.
Args: product_name: Exact product name (e.g. 'VBR v13', 'VB365', 'VONE')
Inputs: product_name (required). Returns: result
get_product_subheadingsA
Get the section headings that organise a product's port requirements.
Each subheading represents a component or role within the product (e.g. 'Backup Server', 'Proxy Server'). Useful for understanding the product architecture before diving into specific ports.
Args: product_name: Exact product name (e.g. 'VBR v13', 'VB365')
Inputs: product_name (required). Returns: result
get_source_detailsA
Get the source services for a product, grouped by section.
Shows which components/roles (source services) exist within each section of a product's port requirements. Useful for understanding the network topology before querying specific port details.
Args: product_name: Exact product name (e.g. 'VBR v13', 'VB365')
Inputs: product_name (required). Returns: result
list_productsA
List all Veeam products that have port requirement data available.
Call this first to discover valid product names before using other tools. Returns product names like 'VBR v13', 'VB365', etc.
Inputs: no named parameters. Returns: result
list_servicesA
List all known service roles for a product from the knowledge graph.
Returns canonical service names with their original name variants and any OS/hypervisor/storage qualifiers. Useful for discovering valid service names before calling generate_topology or generate_app_import.
Args: product_name: Exact product name (e.g. 'VBR v13', 'VB365')
Inputs: product_name (required). Returns: result
search_by_port_numberB
Find all Veeam product entries that use a specific port number.
Searches the port field across all products. Useful for firewall audits or checking which Veeam services need a particular port opened.
Args: port: Port number to search for (e.g. '443', '9392', '6180')
Inputs: port (required). Returns: result
search_portsA
Search across all Veeam products for port requirements matching a query.
Searches product names, source/target services, port numbers, protocols, descriptions, and section headings. Useful for questions like 'which products use SMTP' or 'what needs port 443'.
Args: query: Search text (e.g. 'SMTP', 'backup server', 'cloud gateway')
Inputs: query (required). Returns: result
semantic_searchA
Search port requirements using natural language (vector similarity).
Understands synonyms and related concepts — e.g. 'firewall rules for backup to NAS' matches NFS/SMB repository entries even if those exact words don't appear in the data.
Falls back to keyword search if vector embeddings are unavailable.
Args: query: Natural language search query (e.g. 'what ports does the proxy need for VMware', 'cloud connectivity', 'database ports') product_name: Optional product to filter results (e.g. 'VBR v13'). If omitted, searches across all products. limit: Max results to return (1-100, default 20)
Inputs: query (required), product_name, limit. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 11 tools
Each tool has a clearly distinct purpose: listing products, querying ports, searching, and generating topologies. No two tools overlap, and descriptions clearly differentiate them.
Names follow a consistent action_noun pattern using snake_case (list_, get_, search_, generate_). 'semantic_search' deviates slightly but remains descriptive and intuitive.
With 11 tools, the server is well-scoped for its domain: discovery (list_products, list_services), detailed querying (get_product_ports, etc.), search (multiple methods), and generation (topology, app import). No bloat or insufficiency.
The tool set covers the full lifecycle for a read-only knowledge base: discovery, metadata browsing, precise querying, search across dimensions, and generation of outputs. No obvious gaps—users can explore and export effectively.
Maintenance
Related MCP Connectors
Manage VeriTeknik servers, DNS, backups and support tickets from your AI assistant.
Generate cloud architecture diagrams, flowcharts, and sequence diagrams.
Query Allen-Bradley and Siemens PLC projects, live tag values, and analyses in plain English.
Generate, edit, and export data-architecture diagrams from your AI. Column lineage, PNG in chat.
Related MCP Servers
- AlicenseCqualityDmaintenanceEnables AI agents to control and monitor Veeam Backup & Replication v13 infrastructure through 328 MCP tools using the official REST API. Supports both stdio mode for local clients like Claude Desktop and streamable HTTP mode for remote integration with platforms like Dify.100ISC
- AlicenseNot gradedqualityCmaintenanceExtends Veeam Intelligence to MCP-compatible clients, enabling secure, real-time operational insight across Veeam Backup & Replication, Veeam ONE, and VSPC via natural language or AI workflows.22MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to interact with Veeam Backup & Replication infrastructure through natural language, allowing monitoring, management, and troubleshooting of backup jobs, sessions, and restore points.MIT
- FlicenseNot gradedqualityDmaintenanceAggregates network operations tools such as retrieving local network configurations and scanning ports, enabling IT professionals to perform these tasks via natural language.-