Skip to main content

Fabric Tools

The Fabric MCP server is available at https://mcp.equinix.com/fabric. For setup, authentication, and security guidance, see the MCP Server Overview.

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.

LevelDescription
ViewerSearches and lookups. Makes no changes.
OperatorViewer access, plus modification of existing resources and attach or detach operations.
ManagerOperator 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

ToolLevelDescriptionAPI Reference
search_connectionsViewerSearch for Fabric Connections using advanced filtering, pagination, and sortingSearch Connection
check_connectionViewerValidate a Fabric Connection configuration before creationValidate Connection
create_connectionOperatorCreate a new Fabric ConnectionCreate Connection
update_connectionOperatorUpdate an Equinix Fabric Connection using its UUIDUpdate Connection
retry_connectionOperatorPerform actions on a Fabric ConnectionConnection Actions

Metros

ToolLevelDescriptionAPI Reference
list_metrosViewerFetch all metros available in FabricGet All Metros
get_metroViewerRetrieve detailed information about a specific Fabric Metro by passing its Metro CodeGet Metro by Code

Projects

ToolLevelDescriptionAPI Reference
list_projectViewerList the projects your account can see, with their project identifiersGet Projects

Pricing

ToolLevelDescriptionAPI Reference
search_pricesViewerSearch for pricing information across Fabric resourcesSearch Prices

Ports

ToolLevelDescriptionAPI Reference
search_portsViewerSearch for Fabric Ports using advanced filtering, pagination, and sortingSearch Ports
get_vlan_portViewerGet VLAN configurations for a specific portGet Port VLANs
create_portManagerCreate a new Equinix Fabric PortCreate Port
update_portOperatorUpdate a Fabric Port configurationUpdate Port
attach_physical_ports_to_lagOperatorAttach Physical Ports to a Link Aggregation Group (LAG)Add to Lag

Cloud Routers

ToolLevelDescriptionAPI Reference
search_routersViewerSearch for Equinix Fabric Cloud Routers using advanced filtering, pagination, and sortingSearch Cloud Routers
list_router_packagesViewerList all available Cloud Router packagesList Packages
create_routerManagerCreate a new Fabric Cloud RouterCreate Cloud Router
update_routerManagerUpdate an existing Fabric Cloud RouterUpdate Cloud Router
create_router_commandOperatorRun a router command such as ping or tracerouteCreate Router Command
search_router_commandsViewerSearch for router command execution resultsSearch Router Commands
search_routesViewerSearch for routes including advertised, received, and active routesSearch Routes
refresh_routesViewerCreate route table actions for a Cloud RouterCreate Route Actions

Routing Protocols

ToolLevelDescriptionAPI Reference
list_routing_protocolsViewerList all Routing Protocols for a connectionGet Routing Protocols
create_routing_protocolOperatorCreate a new Routing ProtocolCreate Routing Protocols
update_routing_protocolOperatorUpdate an existing Routing ProtocolUpdate Routing Protocols
replace_routing_protocolOperatorReplace an existing Routing ProtocolReplace Routing Protocols
create_routing_protocol_actionOperatorClear or reset a BGP session for a Routing ProtocolClear/Reset BGP
list_routing_protocol_actionsViewerGet all BGP action statuses for a Routing ProtocolGet BGP Actions

Networks

ToolLevelDescriptionAPI Reference
search_networksViewerSearch for Fabric NetworksSearch Networks
create_networkManagerCreate a new Fabric NetworkCreate Network
update_networkOperatorUpdate an existing Fabric NetworkUpdate Network

IP Blocks

ToolLevelDescriptionAPI Reference
search_ip_blocksViewerSearch Fabric IP blocksSearch IP Blocks
add_ip_block_to_eia_serviceOperatorAdd an IP block to an Equinix Internet Access serviceAdd IP Block

Service Profiles

ToolLevelDescriptionAPI Reference
search_service_profilesViewerSearch for Fabric Service Profiles using advanced filteringSearch Service Profiles
get_service_profileViewerRetrieve detailed information about a specific Service Profile by UUIDGet Profile
list_service_profile_metrosViewerGet metro information for a specific Service ProfileGet Service Profile Metros
create_service_profileManagerCreate a new Fabric Service ProfileCreate Service Profile
update_service_profileOperatorUpdate an existing Service ProfileUpdate Service Profile
replace_service_profileOperatorReplace a Service Profile configurationReplace Service Profile

Service Tokens

ToolLevelDescriptionAPI Reference
search_service_tokensViewerSearch for Fabric Service TokensSearch Service Tokens
create_service_tokenOperatorCreate a new Service TokenCreate Service Token
update_service_tokenOperatorUpdate an existing Service TokenUpdate Service Token

Route Filters

ToolLevelDescriptionAPI Reference
search_route_filtersViewerSearch for Cloud Router Route FiltersSearch Route Filters
create_route_filterOperatorCreate a new Route Filter for traffic managementCreate Route Filter
update_route_filterOperatorUpdate an existing Route Filter configurationUpdate Route Filter
attach_route_filterOperatorAttach Route Filter to Fabric ConnectionAttach Route Filter
list_route_filters_for_connectionViewerList all Route Filters attached to a Fabric ConnectionGet All Route Filters
list_route_filter_connectionsViewerRetrieve all Connections using an existing Route FilterGet Route Filter Connections
search_route_filter_attachments_for_fcrViewerSearch Route Filter attachments for a given Cloud RouterSearch Cloud Router Route Filter Attachments
get_route_filter_changesViewerRetrieve all changes for a specific Route FilterGet All Changes
list_route_filter_changeViewerList change records for a route filterList Route Filter Changes

Route Filter Rules

ToolLevelDescriptionAPI Reference
list_route_filter_rulesViewerList all rules for a specific Route FilterGet Route Filter Rules
get_route_filter_ruleViewerGet detailed information about a specific Route Filter RuleGet Route Filter Rule
create_route_filter_ruleOperatorCreate new rules for a Route FilterCreate Route Filter Rules
update_route_filter_ruleOperatorUpdate an existing Route Filter RuleUpdate Route Filter Rule
list_route_filter_rule_changesViewerList change records for a route filter ruleList Rule Changes
get_route_filter_rule_changeViewerGet one change record for a route filter ruleGet Rule Change

Route Aggregations

ToolLevelDescriptionAPI Reference
search_route_aggregationsViewerSearch for Cloud Router Route AggregationsSearch Route Aggregation
get_route_aggregationViewerRetrieve detailed information about a specific Route Aggregation by UUIDGet Aggregation
create_route_aggregationOperatorCreate a new Route Aggregation for traffic managementCreate Route Aggregation
update_route_aggregationOperatorUpdate an existing Route Aggregation configurationUpdate Route Aggregation
attach_route_aggregationOperatorAttach Route Aggregation to Fabric ConnectionAttach Route Aggregation
list_route_aggregations_for_connectionViewerList all Route Aggregations attached to a Fabric ConnectionGet All Aggregations
list_route_aggregation_connectionsViewerRetrieve all Connections using an existing Route AggregationGet Route Aggregation Connections
search_route_aggregation_attachments_for_fcrViewerSearch Route Aggregation attachments for a given Cloud RouterSearch Cloud Router Route Aggregation Attachments
list_route_aggregation_changesViewerList change records for a route aggregationList Route Aggregation Changes
get_route_aggregation_changeViewerGet one change record for a route aggregationGet Route Aggregation Change

Route Aggregation Rules

ToolLevelDescriptionAPI Reference
list_route_aggregation_rulesViewerList all rules for a specific Route AggregationList Route Aggregation Rules
get_route_aggregation_ruleViewerGet detailed information about a specific Route Aggregation RuleGet Route Aggregation Rule
create_route_aggregation_ruleOperatorCreate new rules for a Route AggregationCreate Route Aggregation Rules
update_route_aggregation_ruleOperatorUpdate an existing Route Aggregation RuleUpdate Route Aggregation Rule
list_route_aggregation_rule_changesViewerList change records for a route aggregation ruleList Rule Changes
get_route_aggregation_rule_changeViewerGet one change record for a route aggregation ruleGet Rule Change

Telemetry Streams

ToolLevelDescriptionAPI Reference
list_streamsViewerList all telemetry streams in your accountGet Streams
get_streamViewerGet details for one telemetry streamGet Stream
create_streamManagerCreate a new telemetry streamCreate Stream
update_streamManagerUpdate an existing telemetry streamUpdate Stream
get_stream_network_edge_deviceViewerGet details for network edge device attached to a telemetry streamGet Stream Network Edge Device
update_stream_network_edge_deviceOperatorUpdate or attach a network edge device for a telemetry streamUpdate Stream Network Edge Device

Stream Assets

ToolLevelDescriptionAPI Reference
search_attached_assetsViewerSearch for assets attached to a telemetry streamSearch Asset to Stream
list_stream_attached_assets_by_typeViewerList assets attached to a telemetry stream filtered by asset typeGet Assets
get_stream_attached_assetViewerGet details for one asset attached to a streamGet Stream Asset
attach_stream_assetOperatorAttach an asset to a telemetry streamAttach Asset to Stream

Stream Subscriptions

ToolLevelDescriptionAPI Reference
list_stream_subscriptionsViewerList all subscriptions for a specific telemetry streamList Stream Subscription
get_stream_subscriptionViewerGet details for one stream subscriptionGet Stream Subscription
create_stream_subscriptionOperatorCreate a new telemetry stream subscriptionCreate Stream Subscription
update_stream_subscriptionOperatorUpdate an existing telemetry stream subscriptionUpdate Stream Subscription

Stream Alert Rules

ToolLevelDescriptionAPI Reference
list_stream_alert_rulesViewerList all alert rules for a streamGet Alert Rules
get_stream_alert_ruleViewerGet details for one stream alert ruleGet Alert Rule
create_stream_alert_ruleOperatorCreate a new alert rule for a streamCreate Alert Rule
replace_stream_alert_ruleOperatorReplace a stream alert ruleReplace Alert Rule

Application Connect

ToolLevelDescriptionAPI Reference
search_application_linksViewerSearch Application Connect linksSearch Links
get_application_linkViewerGet details for one Application Connect linkGet Link
create_application_linkManagerCreate an Application Connect linkCreate Link
attach_application_domain_to_linkOperatorAttach a domain to an Application Connect linkAttach Domain
attach_application_service_to_linkOperatorAttach a service to an Application Connect linkAttach Service
search_application_domainsViewerSearch Application Connect domainsSearch Domains
get_application_domainViewerGet details for one Application Connect domainGet Domain
create_application_domainOperatorCreate an Application Connect domainCreate Domain
search_application_servicesViewerSearch Application Connect servicesSearch Services
create_application_serviceOperatorCreate an Application Connect serviceCreate Service
search_application_subscriptionsViewerSearch Application Connect subscriptionsSearch Subscriptions
create_application_subscriptionOperatorCreate an Application Connect subscriptionCreate Subscription

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.

Was this page helpful?