vcfa-orchestrator

MCP Server for VCF Automation Orchestrator

An MCP server that exposes VCF Automation Orchestrator (vRO), Service Broker, and Cloud Assembly REST API operations as tools. It helps AI assistants list, inspect, run, create, export, preflight, diff, import, and delete VCFA/vRO automation assets through discovery-first workflows.

Supports VCF 9 Automation and Aria Automation 8.x.

Documentation

Full documentation is available in the GitHub Pages site:

• Published site: https://mgovedarov.github.io/mcp-vcf-orchestrator/
• Local docs entry point: docs/index.md
• vRO artifact authoring notes: docs/vro-artifact-authoring.md

The docs include installation, configuration, MCP client setup, tool references, resources/prompts, how-tos, artifact lifecycle guidance, safety notes, troubleshooting, and contributor guidance.

Checked examples for common workflows are available in examples/README.md. These examples are validated against the registered tool and prompt names so stale snippets are caught during development.

Quick Start

Run directly from npm:

The package is published on npm as @mgovedarov/mcp-vcf-orchestrator.

npx @mgovedarov/mcp-vcf-orchestrator

Or install globally:

npm install -g @mgovedarov/mcp-vcf-orchestrator
mcp-vcf-orchestrator

Run from source:

git clone https://github.com/mgovedarov/mcp-vcf-orchestrator.git
cd mcp-vcf-orchestrator
npm install
npm run build

Claude Code Plugin

A Claude Code plugin in this repository bundles two skills (vcfa-authoring and vcfa-operations) that auto-activate and route to the server's vcfa-* prompts and tools with discovery-first, confirm-before-write safety. Install it from a Claude Code session:

/plugin marketplace add mgovedarov/mcp-vcf-orchestrator
/plugin install vcfa-orchestrator@mcp-vcf-orchestrator

The plugin contains skills only; configure the MCP server separately. See docs/guide/claude-code-plugin.md.

License And Branding

This project is licensed under the Apache License 2.0. Attribution notices are provided in NOTICE.

Forks and derivatives should preserve the required license and attribution notices. Redistributed packages must not use the @mgovedarov npm scope or imply that they are the official @mgovedarov/mcp-vcf-orchestrator package or repository.

Configuration

Required environment variables:

Variable	Description
VCFA_HOST	VCF Automation hostname, for example vcfa.example.com.
VCFA_USERNAME	Username without organization, for example admin.
VCFA_ORGANIZATION	Organization name (the tenant URL slug, not the display name), or system for provider/system administrator logins, which are routed to /cloudapi/1.0.0/sessions/provider.
VCFA_PASSWORD	Password for the VCF Cloud API session, or the vRO Basic-auth password when VCFA_TARGET_PLATFORM=vra8.

Useful optional variables: