Fabric MCP Server
officialThe 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.
What can you do with Fabric MCP?
-
Search and inspect Fabric resources — Ask your assistant to find connections, ports, metros, or networks using
search_connections,search_ports,list_metros, orsearch_networks. -
Create and manage connections — Have your assistant provision a new Fabric connection with
create_connection, validate a configuration viacheck_connection, or update an existing one usingupdate_connection. -
Manage Cloud Routers and routing — Use
create_routerto set up a router,search_routesto inspect routing tables, orcreate_router_commandto run diagnostics like ping or traceroute. -
Configure routing protocols and BGP — Ask your assistant to list, create, or update routing protocols with
list_routing_protocolsandcreate_routing_protocol, or clear a BGP session viacreate_routing_protocol_action. -
Handle ports and VLANs — Retrieve VLAN details for a port with
get_vlan_port, search available ports usingsearch_ports, or attach physical ports to a LAG withattach_physical_ports_to_lag. -
Manage service profiles and tokens — Search for service profiles with
search_service_profiles, create a new one viacreate_service_profile, or manage access usingsearch_service_tokensandcreate_service_token.
Documentation
The Fabric MCP server is available at https://mcp.equinix.com/fabric. For setup, authentication, and security guidance, see the MCP Server Overview.
[!-secondary] -secondary Public Preview
The Fabric MCP server is in public preview. Tools, descriptions, and response formats may change before general availability.
For feedback, questions, or help with the MCP server, email fabric-intelligence-support@equinix.com.
Permission Levels
Each tool in the following tables lists the lowest permission level required to call it. Two controls must permit a call: the roles assigned to your Equinix Customer Portal account, and the permission level you select when you connect a client. The issued token grants the intersection of the two. For more information, see Permissions Model.
| Level | Description Viewer Searches and lookups. Makes no changes. Operator Viewer access, plus modification of existing resources and attach or detach operations. Manager Operator access, plus creation of resources. Ordering a port or a Cloud Router is billed at the same rate as ordering one in the portal. |
|---|---|
| Viewer | Searches and lookups. Makes no changes. |
| Operator | Viewer access, plus modification of existing resources and attach or detach operations. |
| Manager | Operator access, plus creation of resources. Ordering a port or a Cloud Router is billed at the same rate as ordering one in the portal. |
Use the narrowest permission level that covers the work. A client connected with Viewer cannot change resources, regardless of the roles assigned to the account.
The server publishes no delete tools. No permission level, including Manager, can remove a connection, port, Cloud Router, or network.
Tools
Connections
| Tool | Level | Description | API Reference search_connections Viewer Search for Fabric Connections using advanced filtering, pagination, and sorting Search Connection check_connection Viewer Validate a Fabric Connection configuration before creation Validate Connection create_connection Operator Create a new Fabric Connection Create Connection update_connection Operator Update an Equinix Fabric Connection using its UUID Update Connection retry_connection Operator Perform actions on a Fabric Connection Connection Actions |
|---|---|---|---|
search_connections | Viewer | Search for Fabric Connections using advanced filtering, pagination, and sorting | Search Connection |
check_connection | Viewer | Validate a Fabric Connection configuration before creation | Validate Connection |
create_connection | Operator | Create a new Fabric Connection | Create Connection |
update_connection | Operator | Update an Equinix Fabric Connection using its UUID | Update Connection |
retry_connection | Operator | Perform actions on a Fabric Connection | Connection Actions |
Metros
| Tool | Level | Description | API Reference list_metros Viewer Fetch all metros available in Fabric Get All Metros get_metro Viewer Retrieve detailed information about a specific Fabric Metro by passing its Metro Code Get Metro by Code |
|---|---|---|---|
list_metros | Viewer | Fetch all metros available in Fabric | Get All Metros |
get_metro | Viewer | Retrieve detailed information about a specific Fabric Metro by passing its Metro Code | Get Metro by Code |
Projects
| Tool | Level | Description | API Reference list_project Viewer List the projects your account can see, with their project identifiers Get Projects list_projects Fetch all projects available in the Equinix Substrate Governance API. API Reference |
|---|---|---|---|
list_project | Viewer | List the projects your account can see, with their project identifiers | Get Projects |
list_projects | Fetch all projects available in the Equinix Substrate Governance API. | API Reference |
Pricing
| Tool | Level | Description | API Reference search_prices Viewer Search for pricing information across Fabric resources Search Prices |
|---|---|---|---|
search_prices | Viewer | Search for pricing information across Fabric resources | Search Prices |
Ports
| Tool | Level | Description | API Reference search_ports Viewer Search for Fabric Ports using advanced filtering, pagination, and sorting Search Ports get_vlan_port Viewer Get VLAN configurations for a specific port Get Port VLANs create_port Manager Create a new Equinix Fabric Port Create Port update_port Operator Update a Fabric Port configuration Update Port attach_physical_ports_to_lag Operator Attach Physical Ports to a Link Aggregation Group (LAG) Add to Lag |
|---|---|---|---|
search_ports | Viewer | Search for Fabric Ports using advanced filtering, pagination, and sorting | Search Ports |
get_vlan_port | Viewer | Get VLAN configurations for a specific port | Get Port VLANs |
create_port | Manager | Create a new Equinix Fabric Port | Create Port |
update_port | Operator | Update a Fabric Port configuration | Update Port |
attach_physical_ports_to_lag | Operator | Attach Physical Ports to a Link Aggregation Group (LAG) | Add to Lag |
Cloud Routers
| Tool | Level | Description | API Reference search_routers Viewer Search for Equinix Fabric Cloud Routers using advanced filtering, pagination, and sorting Search Cloud Routers list_router_packages Viewer List all available Cloud Router packages List Packages create_router Manager Create a new Fabric Cloud Router Create Cloud Router update_router Manager Update an existing Fabric Cloud Router Update Cloud Router create_router_command Operator Run a router command such as ping or traceroute Create Router Command search_router_commands Viewer Search for router command execution results Search Router Commands search_routes Viewer Search for routes including advertised, received, and active routes Search Routes refresh_routes Viewer Create route table actions for a Cloud Router Create Route Actions |
|---|---|---|---|
search_routers | Viewer | Search for Equinix Fabric Cloud Routers using advanced filtering, pagination, and sorting | Search Cloud Routers |
list_router_packages | Viewer | List all available Cloud Router packages | List Packages |
create_router | Manager | Create a new Fabric Cloud Router | Create Cloud Router |
update_router | Manager | Update an existing Fabric Cloud Router | Update Cloud Router |
create_router_command | Operator | Run a router command such as ping or traceroute | Create Router Command |
search_router_commands | Viewer | Search for router command execution results | Search Router Commands |
search_routes | Viewer | Search for routes including advertised, received, and active routes | Search Routes |
refresh_routes | Viewer | Create route table actions for a Cloud Router | Create Route Actions |
Routing Protocols
| Tool | Level | Description | API Reference list_routing_protocols Viewer List all Routing Protocols for a connection Get Routing Protocols create_routing_protocol Operator Create a new Routing Protocol Create Routing Protocols update_routing_protocol Operator Update an existing Routing Protocol Update Routing Protocols replace_routing_protocol Operator Replace an existing Routing Protocol Replace Routing Protocols create_routing_protocol_action Operator Clear or reset a BGP session for a Routing Protocol Clear/Reset BGP list_routing_protocol_actions Viewer Get all BGP action statuses for a Routing Protocol Get BGP Actions |
|---|---|---|---|
list_routing_protocols | Viewer | List all Routing Protocols for a connection | Get Routing Protocols |
create_routing_protocol | Operator | Create a new Routing Protocol | Create Routing Protocols |
update_routing_protocol | Operator | Update an existing Routing Protocol | Update Routing Protocols |
replace_routing_protocol | Operator | Replace an existing Routing Protocol | Replace Routing Protocols |
create_routing_protocol_action | Operator | Clear or reset a BGP session for a Routing Protocol | Clear/Reset BGP |
list_routing_protocol_actions | Viewer | Get all BGP action statuses for a Routing Protocol | Get BGP Actions |
Networks
| Tool | Level | Description | API Reference search_networks Viewer Search for Fabric Networks Search Networks create_network Manager Create a new Fabric Network Create Network update_network Operator Update an existing Fabric Network Update Network |
|---|---|---|---|
search_networks | Viewer | Search for Fabric Networks | Search Networks |
create_network | Manager | Create a new Fabric Network | Create Network |
update_network | Operator | Update an existing Fabric Network | Update Network |
IP Blocks
| Tool | Level | Description | API Reference search_ip_blocks Viewer Search Fabric IP blocks Search IP Blocks add_ip_block_to_eia_service Operator Add an IP block to an Equinix Internet Access service Add IP Block |
|---|---|---|---|
search_ip_blocks | Viewer | Search Fabric IP blocks | Search IP Blocks |
add_ip_block_to_eia_service | Operator | Add an IP block to an Equinix Internet Access service | Add IP Block |
Service Profiles
| Tool | Level | Description | API Reference search_service_profiles Viewer Search for Fabric Service Profiles using advanced filtering Search Service Profiles get_service_profile Viewer Retrieve detailed information about a specific Service Profile by UUID Get Profile list_service_profile_metros Viewer Get metro information for a specific Service Profile Get Service Profile Metros create_service_profile Manager Create a new Fabric Service Profile Create Service Profile update_service_profile Operator Update an existing Service Profile Update Service Profile replace_service_profile Operator Replace a Service Profile configuration Replace Service Profile |
|---|---|---|---|
search_service_profiles | Viewer | Search for Fabric Service Profiles using advanced filtering | Search Service Profiles |
get_service_profile | Viewer | Retrieve detailed information about a specific Service Profile by UUID | Get Profile |
list_service_profile_metros | Viewer | Get metro information for a specific Service Profile | Get Service Profile Metros |
create_service_profile | Manager | Create a new Fabric Service Profile | Create Service Profile |
update_service_profile | Operator | Update an existing Service Profile | Update Service Profile |
replace_service_profile | Operator | Replace a Service Profile configuration | Replace Service Profile |
Service Tokens
| Tool | Level | Description | API Reference search_service_tokens Viewer Search for Fabric Service Tokens Search Service Tokens create_service_token Operator Create a new Service Token Create Service Token update_service_token Operator Update an existing Service Token Update Service Token |
|---|---|---|---|
search_service_tokens | Viewer | Search for Fabric Service Tokens | Search Service Tokens |
create_service_token | Operator | Create a new Service Token | Create Service Token |
update_service_token | Operator | Update an existing Service Token | Update Service Token |
Route Filters
| Tool | Level | Description | API Reference search_route_filters Viewer Search for Cloud Router Route Filters Search Route Filters create_route_filter Operator Create a new Route Filter for traffic management Create Route Filter update_route_filter Operator Update an existing Route Filter configuration Update Route Filter attach_route_filter Operator Attach Route Filter to Fabric Connection Attach Route Filter list_route_filters_for_connection Viewer List all Route Filters attached to a Fabric Connection Get All Route Filters list_route_filter_connections Viewer Retrieve all Connections using an existing Route Filter Get Route Filter Connections search_route_filter_attachments_for_fcr Viewer Search Route Filter attachments for a given Cloud Router Search Cloud Router Route Filter Attachments get_route_filter_changes Viewer Retrieve all changes for a specific Route Filter Get All Changes list_route_filter_change Viewer List change records for a route filter List Route Filter Changes get_route_filter_change Retrieve a specific change or update log of an Equinix Route Filter Policy. API Reference list_route_filter_changes Retrieve changes or update history of an Equinix Route Filter Policy. API Reference |
|---|---|---|---|
search_route_filters | Viewer | Search for Cloud Router Route Filters | Search Route Filters |
create_route_filter | Operator | Create a new Route Filter for traffic management | Create Route Filter |
update_route_filter | Operator | Update an existing Route Filter configuration | Update Route Filter |
attach_route_filter | Operator | Attach Route Filter to Fabric Connection | Attach Route Filter |
list_route_filters_for_connection | Viewer | List all Route Filters attached to a Fabric Connection | Get All Route Filters |
list_route_filter_connections | Viewer | Retrieve all Connections using an existing Route Filter | Get Route Filter Connections |
search_route_filter_attachments_for_fcr | Viewer | Search Route Filter attachments for a given Cloud Router | Search Cloud Router Route Filter Attachments |
get_route_filter_changes | Viewer | Retrieve all changes for a specific Route Filter | Get All Changes |
list_route_filter_change | Viewer | List change records for a route filter | List Route Filter Changes |
get_route_filter_change | Retrieve a specific change or update log of an Equinix Route Filter Policy. | API Reference | |
list_route_filter_changes | Retrieve changes or update history of an Equinix Route Filter Policy. | API Reference |
Route Filter Rules
| Tool | Level | Description | API Reference list_route_filter_rules Viewer List all rules for a specific Route Filter Get Route Filter Rules get_route_filter_rule Viewer Get detailed information about a specific Route Filter Rule Get Route Filter Rule create_route_filter_rule Operator Create new rules for a Route Filter Create Route Filter Rules update_route_filter_rule Operator Update an existing Route Filter Rule Update Route Filter Rule list_route_filter_rule_changes Viewer List change records for a route filter rule List Rule Changes get_route_filter_rule_change Viewer Get one change record for a route filter rule Get Rule Change |
|---|---|---|---|
list_route_filter_rules | Viewer | List all rules for a specific Route Filter | Get Route Filter Rules |
get_route_filter_rule | Viewer | Get detailed information about a specific Route Filter Rule | Get Route Filter Rule |
create_route_filter_rule | Operator | Create new rules for a Route Filter | Create Route Filter Rules |
update_route_filter_rule | Operator | Update an existing Route Filter Rule | Update Route Filter Rule |
list_route_filter_rule_changes | Viewer | List change records for a route filter rule | List Rule Changes |
get_route_filter_rule_change | Viewer | Get one change record for a route filter rule | Get Rule Change |
Route Aggregations
| Tool | Level | Description | API Reference search_route_aggregations Viewer Search for Cloud Router Route Aggregations Search Route Aggregation get_route_aggregation Viewer Retrieve detailed information about a specific Route Aggregation by UUID Get Aggregation create_route_aggregation Operator Create a new Route Aggregation for traffic management Create Route Aggregation update_route_aggregation Operator Update an existing Route Aggregation configuration Update Route Aggregation attach_route_aggregation Operator Attach Route Aggregation to Fabric Connection Attach Route Aggregation list_route_aggregations_for_connection Viewer List all Route Aggregations attached to a Fabric Connection Get All Aggregations list_route_aggregation_connections Viewer Retrieve all Connections using an existing Route Aggregation Get Route Aggregation Connections search_route_aggregation_attachments_for_fcr Viewer Search Route Aggregation attachments for a given Cloud Router Search Cloud Router Route Aggregation Attachments list_route_aggregation_changes Viewer List change records for a route aggregation List Route Aggregation Changes get_route_aggregation_change Viewer Get one change record for a route aggregation Get Route Aggregation Change |
|---|---|---|---|
search_route_aggregations | Viewer | Search for Cloud Router Route Aggregations | Search Route Aggregation |
get_route_aggregation | Viewer | Retrieve detailed information about a specific Route Aggregation by UUID | Get Aggregation |
create_route_aggregation | Operator | Create a new Route Aggregation for traffic management | Create Route Aggregation |
update_route_aggregation | Operator | Update an existing Route Aggregation configuration | Update Route Aggregation |
attach_route_aggregation | Operator | Attach Route Aggregation to Fabric Connection | Attach Route Aggregation |
list_route_aggregations_for_connection | Viewer | List all Route Aggregations attached to a Fabric Connection | Get All Aggregations |
list_route_aggregation_connections | Viewer | Retrieve all Connections using an existing Route Aggregation | Get Route Aggregation Connections |
search_route_aggregation_attachments_for_fcr | Viewer | Search Route Aggregation attachments for a given Cloud Router | Search Cloud Router Route Aggregation Attachments |
list_route_aggregation_changes | Viewer | List change records for a route aggregation | List Route Aggregation Changes |
get_route_aggregation_change | Viewer | Get one change record for a route aggregation | Get Route Aggregation Change |
Route Aggregation Rules
| Tool | Level | Description | API Reference list_route_aggregation_rules Viewer List all rules for a specific Route Aggregation List Route Aggregation Rules get_route_aggregation_rule Viewer Get detailed information about a specific Route Aggregation Rule Get Route Aggregation Rule create_route_aggregation_rule Operator Create new rules for a Route Aggregation Create Route Aggregation Rules update_route_aggregation_rule Operator Update an existing Route Aggregation Rule Update Route Aggregation Rule list_route_aggregation_rule_changes Viewer List change records for a route aggregation rule List Rule Changes get_route_aggregation_rule_change Viewer Get one change record for a route aggregation rule Get Rule Change |
|---|---|---|---|
list_route_aggregation_rules | Viewer | List all rules for a specific Route Aggregation | List Route Aggregation Rules |
get_route_aggregation_rule | Viewer | Get detailed information about a specific Route Aggregation Rule | Get Route Aggregation Rule |
create_route_aggregation_rule | Operator | Create new rules for a Route Aggregation | Create Route Aggregation Rules |
update_route_aggregation_rule | Operator | Update an existing Route Aggregation Rule | Update Route Aggregation Rule |
list_route_aggregation_rule_changes | Viewer | List change records for a route aggregation rule | List Rule Changes |
get_route_aggregation_rule_change | Viewer | Get one change record for a route aggregation rule | Get Rule Change |
Telemetry Streams
| Tool | Level | Description | API Reference list_streams Viewer List all telemetry streams in your account Get Streams get_stream Viewer Get details for one telemetry stream Get Stream create_stream Manager Create a new telemetry stream Create Stream update_stream Manager Update an existing telemetry stream Update Stream get_stream_network_edge_device Viewer Get details for network edge device attached to a telemetry stream Get Stream Network Edge Device update_stream_network_edge_device Operator Update or attach a network edge device for a telemetry stream Update Stream Network Edge Device |
|---|---|---|---|
list_streams | Viewer | List all telemetry streams in your account | Get Streams |
get_stream | Viewer | Get details for one telemetry stream | Get Stream |
create_stream | Manager | Create a new telemetry stream | Create Stream |
update_stream | Manager | Update an existing telemetry stream | Update Stream |
get_stream_network_edge_device | Viewer | Get details for network edge device attached to a telemetry stream | Get Stream Network Edge Device |
update_stream_network_edge_device | Operator | Update or attach a network edge device for a telemetry stream | Update Stream Network Edge Device |
Stream Assets
| Tool | Level | Description | API Reference search_attached_assets Viewer Search for assets attached to a telemetry stream Search Asset to Stream list_stream_attached_assets_by_type Viewer List assets attached to a telemetry stream filtered by asset type Get Assets get_stream_attached_asset Viewer Get details for one asset attached to a stream Get Stream Asset attach_stream_asset Operator Attach an asset to a telemetry stream Attach Asset to Stream |
|---|---|---|---|
search_attached_assets | Viewer | Search for assets attached to a telemetry stream | Search Asset to Stream |
list_stream_attached_assets_by_type | Viewer | List assets attached to a telemetry stream filtered by asset type | Get Assets |
get_stream_attached_asset | Viewer | Get details for one asset attached to a stream | Get Stream Asset |
attach_stream_asset | Operator | Attach an asset to a telemetry stream | Attach Asset to Stream |
Stream Subscriptions
| Tool | Level | Description | API Reference list_stream_subscriptions Viewer List all subscriptions for a specific telemetry stream List Stream Subscription get_stream_subscription Viewer Get details for one stream subscription Get Stream Subscription create_stream_subscription Operator Create a new telemetry stream subscription Create Stream Subscription update_stream_subscription Operator Update an existing telemetry stream subscription Update Stream Subscription |
|---|---|---|---|
list_stream_subscriptions | Viewer | List all subscriptions for a specific telemetry stream | List Stream Subscription |
get_stream_subscription | Viewer | Get details for one stream subscription | Get Stream Subscription |
create_stream_subscription | Operator | Create a new telemetry stream subscription | Create Stream Subscription |
update_stream_subscription | Operator | Update an existing telemetry stream subscription | Update Stream Subscription |
Stream Alert Rules
| Tool | Level | Description | API Reference list_stream_alert_rules Viewer List all alert rules for a stream Get Alert Rules get_stream_alert_rule Viewer Get details for one stream alert rule Get Alert Rule create_stream_alert_rule Operator Create a new alert rule for a stream Create Alert Rule replace_stream_alert_rule Operator Replace a stream alert rule Replace Alert Rule |
|---|---|---|---|
list_stream_alert_rules | Viewer | List all alert rules for a stream | Get Alert Rules |
get_stream_alert_rule | Viewer | Get details for one stream alert rule | Get Alert Rule |
create_stream_alert_rule | Operator | Create a new alert rule for a stream | Create Alert Rule |
replace_stream_alert_rule | Operator | Replace a stream alert rule | Replace Alert Rule |
Application Connect
| Tool | Level | Description | API Reference search_application_links Viewer Search Application Connect links Search Links get_application_link Viewer Get details for one Application Connect link Get Link create_application_link Manager Create an Application Connect link Create Link attach_application_domain_to_link Operator Attach a domain to an Application Connect link Attach Domain attach_application_service_to_link Operator Attach a service to an Application Connect link Attach Service search_application_domains Viewer Search Application Connect domains Search Domains get_application_domain Viewer Get details for one Application Connect domain Get Domain create_application_domain Operator Create an Application Connect domain Create Domain search_application_services Viewer Search Application Connect services Search Services create_application_service Operator Create an Application Connect service Create Service search_application_subscriptions Viewer Search Application Connect subscriptions Search Subscriptions create_application_subscription Operator Create an Application Connect subscription Create Subscription |
|---|---|---|---|
search_application_links | Viewer | Search Application Connect links | Search Links |
get_application_link | Viewer | Get details for one Application Connect link | Get Link |
create_application_link | Manager | Create an Application Connect link | Create Link |
attach_application_domain_to_link | Operator | Attach a domain to an Application Connect link | Attach Domain |
attach_application_service_to_link | Operator | Attach a service to an Application Connect link | Attach Service |
search_application_domains | Viewer | Search Application Connect domains | Search Domains |
get_application_domain | Viewer | Get details for one Application Connect domain | Get Domain |
create_application_domain | Operator | Create an Application Connect domain | Create Domain |
search_application_services | Viewer | Search Application Connect services | Search Services |
create_application_service | Operator | Create an Application Connect service | Create Service |
search_application_subscriptions | Viewer | Search Application Connect subscriptions | Search Subscriptions |
create_application_subscription | Operator | Create an Application Connect subscription | Create Subscription |
Observability - Streams
| Tool | Description | API Endpoint search_streams Search Equinix Fabric streams using filters, wildcard matching, sorting, and pagination. API Reference |
|---|---|---|
search_streams | Search Equinix Fabric streams using filters, wildcard matching, sorting, and pagination. | API Reference |
Example Prompts
The following examples show the types of requests these tools support. The client selects the tools to call. You do not need to name them.
Everyday
- "Show me all active connections in the SV metro."
- "Which ports are over-utilized or have negative available bandwidth?"
- "Summarize my Fabric Cloud Routers."
- "What projects can I create a Cloud Router in?"
- "Change the bandwidth on the connection named
<connection_name>to 1 Gbps." - "Ping the far end of this router-based connection."
- "What would a 10 Gbps port in Frankfurt cost?"
Bigger Questions
The tools can be combined, which allows an agent to complete multi-step analysis:
- "Look at port, router, and connection utilization across every metro. Find what is underutilized and tell me where we could cut spend without hurting performance."
- "Find metros where we terminate on a single path and should have a second one."
- "Walk our connection topology and list the single points of failure."
For these requests, the agent reads live inventory and derives conclusions from it. Review the results before you act on them, and confirm any request that modifies a resource.