Skip to content

Latest commit

 

History

5 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

equinix-agent-plugins

Agent plugins for Equinix products. This repository is a plugin marketplace: it packages Equinix skills plus the Equinix remote MCP server so agentic coding tools (Claude Code, Codex, and anything else that speaks MCP) can operate Equinix Fabric directly.

What's in here

Plugin Skills MCP server
equinix-fabric show-fabric-inventory, manage-cloud-router https://mcp.equinix.com/fabric
  • show-fabric-inventory — search and list connections, ports, cloud routers, service tokens, route filters, route aggregations, and time services.
  • manage-cloud-router — create/update Fabric Cloud Routers, configure BGP (IPv4/IPv6), and manage route filters, route filter rules, route aggregations, and aggregation rules.

Layout

Plugins follow the Agent Plugin standard: plugin.json and mcp.json sit at the plugin root, with components in fixed locations beneath it. The .claude-plugin/marketplace.json at the repo root is the Claude Code marketplace index — marketplaces are outside the standard's scope.

Each plugin also carries a .claude-plugin/plugin.json that duplicates the root manifest. Claude Code's CLI reads the root plugin.json and doesn't need it, but the Claude Desktop marketplace sync validates strictly against .claude-plugin/plugin.json and fails with marketplace_sync_plugin_missing_manifest without it. Keep the two files identical — if you edit one, edit the other.

.claude-plugin/marketplace.json      # marketplace index (what Claude Code adds)
LICENSE
fabric-agent-plugins/                # the equinix-fabric plugin
├── plugin.json                      # plugin manifest (Agent Plugin standard / Codex)
├── .claude-plugin/plugin.json       # duplicate manifest for Claude Desktop's strict sync
├── mcp.json                         # remote MCP server bundled with the plugin
└── skills/
    ├── show-fabric-inventory/SKILL.md
    └── manage-cloud-router/SKILL.md

Install in Claude Code

Add the marketplace, then install the plugin:

claude plugin marketplace add equinix/equinix-agent-plugins
claude plugin install equinix-fabric@equinix-agent-plugins

Or from inside an interactive Claude Code session, use /plugin and pick equinix-fabric from the equinix-agent-plugins marketplace.

The plugin ships the remote MCP server, so no separate MCP setup is needed. Authorize it on first use:

claude mcp list

If equinix-fabric shows as needing auth, run /mcp in an interactive session and complete the browser sign-in.

Verify the skills loaded:

claude plugin list

Then try: "show me all my Fabric connections in SV" or "create a Fabric Cloud Router in DA".

To update or remove:

claude plugin update equinix-fabric@equinix-agent-plugins
claude plugin uninstall equinix-fabric@equinix-agent-plugins

Install in Claude Desktop (UI)

If you use the Claude desktop app instead of the terminal, add the marketplace from Settings:

  1. Open Claude Desktop and go to Settings → Customize.

  2. Select Plugins.

  3. Click Add marketplace.

  4. Paste the repository link and confirm:

    https://github.com/equinix/equinix-agent-plugins
    

    The equinix/equinix-agent-plugins shorthand works too.

  5. Wait for the marketplace to sync — Claude fetches .claude-plugin/marketplace.json from the repo and lists the plugins it declares. Use the Sync / refresh control on the marketplace entry any time you want to pull newly published plugins or versions.

  6. Find equinix-fabric in the marketplace listing and click Install, then make sure its toggle is enabled.

  7. Authorize the bundled MCP server: open Settings → Connectors (or the /mcp prompt in a session), find equinix-fabric, and complete the browser sign-in. The skills work only once the server is connected.

  8. Restart or start a new session, then try "show me all my Fabric connections in SV".

To update, hit Sync on the marketplace and then Update on the plugin. To remove, use Uninstall on the plugin — or Remove marketplace to drop the whole source.

Team-wide install

Commit this to your project's .claude/settings.json so every teammate gets the plugin on clone:

{
  "extraKnownMarketplaces": {
    "equinix-agent-plugins": {
      "source": {
        "source": "github",
        "repo": "equinix/equinix-agent-plugins"
      }
    }
  },
  "enabledPlugins": {
    "equinix-fabric@equinix-agent-plugins": true
  }
}

Install in Codex

Codex has no marketplace, so wire up the MCP server and the skills separately.

1. Add the skills. Go to Codex → PluginsAddAdd marketplace, provide the repo link https://github.com/equinix/equinix-agent-plugins, go to your personal space, select equinix-fabric, and install.

2. Add the MCP server. The quick way:

codex mcp add equinix-fabric --url https://mcp.equinix.com/fabric

Install in other MCP clients

Any MCP client that supports remote HTTP servers can use the server definition in fabric-agent-plugins/mcp.json:

{
  "mcpServers": {
    "equinix-fabric": {
      "type": "http",
      "url": "https://mcp.equinix.com/fabric"
    }
  }
}

The skills are plain Markdown — point your agent's skill/instruction loader at fabric-agent-plugins/skills/, or paste a SKILL.md into its system instructions.

Contributing a plugin

  1. Create <my-plugin>/plugin.json with name, version, and description.
  2. Put skills under <my-plugin>/skills/<skill-name>/SKILL.md, with any supporting docs in a sibling references/ directory.
  3. Add remote MCP servers to <my-plugin>/mcp.json, and point plugin.json's mcpServers at ./mcp.json.
  4. Copy <my-plugin>/plugin.json to <my-plugin>/.claude-plugin/plugin.json (same content, paths stay relative to the plugin root either way). Claude Desktop's marketplace sync requires the manifest there specifically — without it, sync fails with marketplace_sync_plugin_missing_manifest.
  5. Register the plugin in the plugins array of .claude-plugin/marketplace.json.

Validate the marketplace manifest before opening a PR:

claude plugin validate .

Note: claude plugin validate ./<my-plugin> reports "No manifest found" — that validator only looks for the legacy .claude-plugin/plugin.json location, not the standard's root plugin.json. Installing the plugin resolves the root manifest correctly; validate the marketplace and then install to test.

Test against your working copy without publishing:

claude plugin marketplace add /path/to/equinix-agent-plugins

License

Apache License 2.0 — see LICENSE. Copyright 2026 Equinix, Inc.

About

A modular collection of custom agent plugins, skills, and mcp server configuration, designed to extend the capabilities of claude/other agents for Equinix related operations

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors