The Fabric MCP Server

The Equinix Fabric MCP (Model Context Protocol) server provides a standardized interface for AI assistants and language models to interact with the Equinix Fabric API. MCP is an open protocol that enables secure, structured access to external APIs and services, allowing AI applications to perform operations on your Equinix Fabric resources including connections, ports, Cloud Routers, and metros.

The Fabric MCP server is hosted at https://mcp.equinix.com/fabric and can be used with MCP-compatible AI agents.

Private Beta

The Fabric MCP Server is currently in Private Beta. If you are interested in joining the Beta program, please open a support case to request access.

Supported Agents

The Fabric MCP server is compatible with the following AI agents:

• Claude Desktop – Anthropic's desktop application for Claude AI
• Visual Studio Code – With MCP extensions that support remote MCP servers

Prerequisites

Before using the Fabric MCP server, ensure you have:

• An Equinix Customer Portal account
• Node.js and npx installed (Download Node.js and npx) – Required for running the mcp-remote package that connects to the remote MCP server
• An AI agent installed that supports MCP servers
• A valid OAuth2 access token for Equinix APIs

To obtain an access token, see API Authentication for instructions on generating Client ID and Client Secret credentials, then use those credentials to request an access token from the OAuth2 endpoint.

Token Expiration

Access tokens expire after 1 hour. You will need to generate a new access token and update your MCP server configuration after expiration. Token refresh and enhanced authentication for MCP servers is currently in development and will be supported for general availability.

Setup and Configuration

The Fabric MCP server can be configured independently for Claude Desktop and Visual Studio Code. Each agent uses its own configuration file and format.

Claude Desktop

To configure the Fabric MCP server in Claude Desktop, refer to the Claude documentation on remote MCP servers.

When adding the Equinix Fabric MCP server, use the URL https://mcp.equinix.com/fabric and ensure you include an Authorization header with a valid OAuth2 access token from Equinix. Replace <your_access_token> with your actual access token.

{
  "mcpServers": {
    "Equinix Fabric MCP Server": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.equinix.com/fabric",
        "--header",
        "Authorization: Bearer <your_access_token>"
      ]
    }
  }
}

After updating the configuration file, restart Claude Desktop for the changes to take effect.

Visual Studio Code

To configure the Fabric MCP server in Visual Studio Code, refer to the VS Code documentation on MCP servers.

When adding the Equinix Fabric MCP server, use the following configuration in your mcp.json file:

{
  "servers": {
    "fabric-mcp": {
      "type": "http",
      "url": "https://mcp.equinix.com/fabric",
      "headers": {
        "Authorization": "Bearer <your_access_token>"
      }
    }
  }
}

Replace <your_access_token> with a valid OAuth2 access token. After updating the configuration, restart Visual Studio Code or reload the MCP extension.

Tools

The Fabric MCP server exposes the following MCP tools that allow AI assistants to interact with your Equinix Fabric resources. Each tool corresponds to a specific Fabric API endpoint.

important

We recommend enabling human confirmation for tool execution, especially for operations that create, update, or delete resources. This helps prevent unintended changes to your Fabric infrastructure.

Current Limitations

Delete functionality is not currently supported in the Fabric MCP Server. This includes deletion of connections, ports, and Cloud Routers.

Connections

Tool	Description	API Endpoint
equinix_fabric_create_connection	Create a new Fabric Connection	Create Connection
equinix_fabric_update_connection	Update an Equinix Fabric Connection using its UUID	Update Connection
equinix_fabric_validate_connection	Validate a Fabric Connection configuration before creation	Validate Connection
equinix_fabric_retry_connection_action	Perform actions on a Fabric Connection	Connection Actions

Fabric Metros

Tool	Description	API Endpoint
equinix_fabric_get_metro	Retrieve detailed information about a specific Fabric Metro by passing its Metro Code	Get Metro by Code
equinix_fabric_list_metro	Fetch all metros available in Fabric	Get All Metros

Ports

Tool	Description	API Endpoint
equinix_fabric_get_port	Retrieve detailed information about a specific Fabric Port by passing its UUID	Get Port by UUID
equinix_fabric_search_port	Search for Fabric Ports using advanced filtering, pagination, and sorting	Search Ports
equinix_fabric_update_port	Update a Fabric Port configuration	Update Port
equinix_fabric_get_vlan_ports	Get VLAN configurations for a specific port	Get Port VLANs

Cloud Routers

Tool	Description	API Endpoint
equinix_fabric_search_router	Search for Equinix Fabric Cloud Routers using advanced filtering, pagination, and sorting	Search Cloud Routers
equinix_fabric_create_router	Create a new Fabric Cloud Router	Create Cloud Router
equinix_fabric_update_router	Update an existing Fabric Cloud Router	Update Cloud Router
equinix_fabric_get_router_package	Get details about a Cloud Router package	Get Router Package
equinix_fabric_create_router_commands	Initiate router commands such as ping or traceroute	Create Router Commands
equinix_fabric_search_router_commands	Search for router command execution results	Search Router Commands
equinix_fabric_search_routes	Search for routes including advertised, received, and active routes	Search Routes
equinix_fabric_load_routes	Create route table actions for a Cloud Router	Create Route Actions

Projects

Tool	Description	API Endpoint
equinix_iam_search_projects	Fetch all projects available in Equinix Resource Manager	Get Projects

Pricing

Tool	Description	API Endpoint
equinix_fabric_search_prices	Search for pricing information across Fabric resources	Search Prices

Precision Time

Tool	Description	API Endpoint
equinix_fabric_get_time_service	Retrieve detailed information about a specific Precision Time service by UUID	Get Time Service
equinix_fabric_search_time_service	Search for Equinix Precision Time services	Search Time Services
equinix_fabric_update_time_service	Update a Precision Time service configuration	Update Time Service

Service Profiles

Tool	Description	API Endpoint
equinix_fabric_search_service_profile	Search for Fabric Service Profiles using advanced filtering	Search Service Profiles
equinix_fabric_create_service_profile	Create a new Fabric Service Profile	Create Service Profile
equinix_fabric_update_service_profile	Update an existing Service Profile	Update Service Profile
equinix_fabric_replace_service_profile	Replace a Service Profile configuration	Replace Service Profile
equinix_fabric_get_service_profile_metros	Get metro information for a specific Service Profile	Get Service Profile Metros

Service Tokens

Tool	Description	API Endpoint
equinix_fabric_search_service_tokens	Search for Fabric Service Tokens	Search Service Tokens
equinix_fabric_create_service_token	Create a new Service Token	Create Service Token
equinix_fabric_update_service_token	Update an existing Service Token	Update Service Token

Route Filters

Tool	Description	API Endpoint
equinix_fabric_search_route_filter	Search for Cloud Router Route Filters	Search Route Filters
equinix_fabric_create_route_filter	Create a new Route Filter for traffic management	Create Route Filter
equinix_fabric_update_route_filter	Update an existing Route Filter configuration	Update Route Filter

Route Filter Rules

Tool	Description	API Endpoint
equinix_fabric_get_all_route_filter_rules	List all rules for a specific Route Filter	List Route Filter Rules
equinix_fabric_get_route_filter_rule	Get detailed information about a specific Route Filter Rule	Get Route Filter Rule
equinix_fabric_create_route_filter_rules	Create new rules for a Route Filter	Create Route Filter Rules
equinix_fabric_update_route_filter_rule	Update an existing Route Filter Rule	Update Route Filter Rule

Observability - Streams

Tool	Description	API Endpoint
equinix_fabric_list_streams	List all telemetry streams in your account	Get Streams
equinix_fabric_get_stream_details	Get detailed information about a specific stream	Get Stream Details
equinix_fabric_create_stream	Create a new telemetry stream	Create Stream
equinix_fabric_update_stream	Update an existing telemetry stream	Update Stream
equinix_fabric_list_stream_attached_assets	List assets attached to a stream	List Stream Assets
equinix_fabric_get_stream_attached_asset_details	Get details about a specific asset attached to a stream	Get Stream Asset Details
equinix_fabric_attach_stream_asset	Attach an asset to a telemetry stream	Attach Asset to Stream

Observability - Stream Alert Rules

Tool	Description	API Endpoint
equinix_fabric_list_stream_alert_rules	List all alert rules for a stream	Get Alert Rules
equinix_fabric_get_stream_alert_rule_details	Get detailed information about a specific alert rule	Get Alert Rule Details
equinix_fabric_create_stream_alert_rule	Create a new alert rule for a stream	Create Alert Rule
equinix_fabric_update_stream_alert_rule	Update an existing alert rule	Update Alert Rule

Observability - Cloud Events

Tool	Description	API Endpoint
equinix_fabric_get_cloud_event	Get details about a specific cloud event	Get Cloud Event
equinix_fabric_search_cloud_events	Search for cloud events across your Fabric resources	Search Cloud Events

Observability - Metrics

Tool	Description	API Endpoint
equinix_fabric_get_metrics	Get metrics for a specific asset by asset ID	Get Metrics
equinix_fabric_search_metrics	Search for metrics across multiple assets	Search Metrics

Example Commands

Once you have configured the Fabric MCP server in your AI agent, you can use natural language to interact with your Fabric resources. The following are examples of common queries:

Basic Queries

• "Show me all active connections in the SV metro." – Searches for and displays all active connections in the Silicon Valley metro.
• "Which ports are currently over-utilized or have negative available bandwidth?" – Analyzes port utilization to identify capacity issues.
• "Summarize all my Fabric Cloud Routers." – Provides an overview of all Cloud Routers in your account.
• "How do I create a Cloud Router and what projects can I use?" – Guides you through the Cloud Router creation process and lists available projects.
• "Can you update the bandwidth for the connection named <connection_name>?" – Modifies the bandwidth allocation for a specific connection.
• "Can you ping this router-based connection?" – Executes a ping command to test connectivity through a Cloud Router connection.

Advanced Queries

The MCP server can help with complex analysis and optimization tasks:

• "We're looking to rationalize our network footprint. Can you analyze our active and provisioned port, router, and connection utilization across all metros, identify underutilized resources, and suggest optimization strategies to reduce our monthly costs while maintaining performance? Also, can you suggest adding redundancy options to improve resiliency of our network?" – Performs comprehensive network analysis to identify cost optimization opportunities while maintaining or improving network resilience.
• "Find metros where we should establish redundant paths but currently don't have them." – Analyzes network topology to identify single points of failure across metros and recommends redundancy improvements.
• "Analyze our connection patterns and identify any single points of failure in our network topology." – Examines connection architecture to detect vulnerabilities and suggest architectural improvements.

Security Considerations

When using the Fabric MCP server:

• Access Tokens – Store your access tokens securely. Tokens expire after 1 hour and must be refreshed. See API Authentication for token management details.
• Permissions – The MCP server respects the same permissions as direct API access. Ensure your account has appropriate roles for the operations you want to perform.
• Tool Confirmation – Enable human confirmation for operations that create or modify resources to prevent unintended changes.
• Audit Trail – All operations performed through the MCP server are logged in the same way as direct API calls.

important

The MCP server does not bypass any permissions or account requirements. If your direct API call would be rejected due to missing entitlements or invalid account state, the MCP server call will be rejected as well.

Troubleshooting

Access Token Has Expired

Problem: The MCP server returns authentication errors or fails to execute operations.

Solution: Access tokens expire after 1 hour. Generate a new OAuth2 access token following the API Authentication guide and update your MCP server configuration file with the new token. After updating the token, restart your AI agent (Claude Desktop or VS Code) for the changes to take effect.

MCP Server Not Responding

Problem: The AI agent cannot communicate with the MCP server or tools are not available.

Solution:

• Verify that your internet connection is active and can reach https://mcp.equinix.com/fabric
• Check that your MCP server configuration file has the correct URL and format
• Restart your AI agent to reinitialize the MCP server connection
• Review the MCP server logs in your AI agent for specific error messages

Permission Denied Errors

Problem: Operations fail with permission or authorization errors.

Solution:

• Ensure your Equinix account has the appropriate roles and permissions for the operations you're attempting
• Verify that your OAuth2 credentials (Client ID and Client Secret) have the correct scopes
• Confirm that your account is in good standing and has access to the resources you're trying to manage

Rate Limiting

Problem: Requests are being throttled or rejected due to rate limits.

Solution: The Fabric MCP server respects the same rate limits as direct API access. If you encounter rate limiting, reduce the frequency of requests or contact Equinix support to discuss your rate limit requirements.

Additional Resources

• Fabric API Reference – Complete API documentation for all Fabric endpoints
• API Authentication – Detailed guide on obtaining and using OAuth2 credentials