@robinmordasiewicz/f5xc-terraform-mcp 3.10.5 → 3.11.0

package/README.md

@@ -70,7 +70,7 @@ docker run -p 8080:8080 ghcr.io/modelcontextprotocol/registry:v1.0.0
 docker run -p 8080:8080 ghcr.io/modelcontextprotocol/registry:main-20250906-abc123d
 ```
 
-**Available tags:** 
+**Available tags:**
 - **Releases**: `latest`, `v1.0.0`, `v1.1.0`, etc.
 - **Continuous**: `main` (latest main branch build)
 - **Development**: `main-<date>-<sha>` (specific commit builds)

package/dist/docs/data-sources/index.md

@@ -0,0 +1,25 @@
+# Data Sources
+
+Data sources allow you to query existing F5 Distributed Cloud resources.
+
+## Available Data Sources
+
+For a complete list of available data sources, see the [Terraform Registry documentation](https://registry.terraform.io/providers/robinmordasiewicz/f5xc/latest/docs/data-sources).
+
+### Core Data Sources
+
+- `f5xc_namespace` - Query namespace details
+- `f5xc_addon_service` - Query addon service information
+- `f5xc_addon_service_activation_status` - Check addon activation status
+- And more...
+
+## Data Source Documentation
+
+Each data source is automatically generated from F5's official OpenAPI specifications and includes:
+
+- **Schema** - All available attributes
+- **Examples** - Working Terraform configurations
+
+## Finding Data Sources
+
+Visit the [Terraform Registry](https://registry.terraform.io/providers/robinmordasiewicz/f5xc/latest/docs/data-sources) to search and browse all available data sources.

package/dist/docs/functions/index.md

@@ -0,0 +1,39 @@
+# Provider Functions
+
+Provider-defined functions offer utility capabilities beyond resource management.
+
+!!! info "Terraform 1.8+ Required"
+    Provider functions require Terraform 1.8.0 or later.
+
+## Available Functions
+
+### Secret Management
+
+- **`provider::f5xc::blindfold`** - Encrypt base64-encoded plaintext using F5XC Secret Management
+- **`provider::f5xc::blindfold_file`** - Read and encrypt file contents using F5XC Secret Management
+
+## Usage Example
+
+```hcl
+terraform {
+  required_version = ">= 1.8.0"
+  required_providers {
+    f5xc = {
+      source  = "robinmordasiewicz/f5xc"
+      version = "~> 3.0"
+    }
+  }
+}
+
+locals {
+  encrypted = provider::f5xc::blindfold(
+    base64encode("my-secret-value"),
+    "secret-policy-name",
+    "namespace"
+  )
+}
+```
+
+## Function Documentation
+
+For complete function documentation, see the [Terraform Registry](https://registry.terraform.io/providers/robinmordasiewicz/f5xc/latest/docs/functions).

package/dist/docs/guides/index.md

@@ -0,0 +1,22 @@
+# Guides
+
+Step-by-step tutorials for common F5 Distributed Cloud scenarios.
+
+## Available Guides
+
+### Security & Load Balancing
+
+- **[HTTP Load Balancer with Security Features](http-loadbalancer.md)** - Deploy a production-ready HTTP Load Balancer with WAF, bot defense, and rate limiting
+
+## Coming Soon
+
+Additional guides are being developed. Check back soon for:
+
+- Origin pool configuration patterns
+- Multi-cloud deployment strategies
+- Service mesh integration
+- Advanced security configurations
+
+## Contributing
+
+Have a guide idea? [Open an issue](https://github.com/robinmordasiewicz/terraform-provider-f5xc/issues) or [submit a PR](https://github.com/robinmordasiewicz/terraform-provider-f5xc/pulls)!

package/dist/docs/index.md

@@ -1,276 +1,152 @@
 ---
-page_title: "F5XC Provider"
-description: |-
-  Terraform provider for F5 Distributed Cloud (F5XC) enabling infrastructure as code for load balancers, security policies, sites, and networking. Community-maintained provider built from public F5 API documentation.
+title: F5 Distributed Cloud Terraform Provider
 ---
 
-# F5XC Provider
-
-The F5XC Terraform provider enables infrastructure as code management for F5 Distributed Cloud (F5XC) resources. Configure HTTP/TCP load balancers, origin pools, application firewalls, service policies, cloud sites, and more through declarative Terraform configurations.
-
-This is a community-maintained provider built from public F5 API documentation.
-
-## Requirements
-
-| Name      | Version |
-|-----------|---------|
-| terraform | >= 1.8  |
-
--> **Note:** This provider uses provider-defined functions which require Terraform 1.8 or later. For details, see the [Functions](/docs/functions) documentation.
-
-## Authenticating to F5 Distributed Cloud
-
-The F5XC Terraform provider supports multiple authentication methods:
-
-1. **API Token** - Simplest method using a personal API token
-2. **P12 Certificate** - Certificate-based authentication using PKCS#12 bundle
-3. **PEM Certificate** - Certificate-based authentication using separate cert/key files
-
-Learn more about [how to generate API credentials](https://docs.cloud.f5.com/docs/how-to/user-mgmt/credentials).
-
-## Example Usage
-
-```terraform
-# Configure the F5XC Provider with API Token Authentication
-provider "f5xc" {
-  api_url   = "https://your-tenant.console.ves.volterra.io"
-  api_token = var.f5xc_api_token
-}
-
-# Alternatively, use environment variables:
-# export F5XC_API_URL="https://your-tenant.console.ves.volterra.io"
-# export F5XC_API_TOKEN="your-api-token"
-
-variable "f5xc_api_token" {
-  description = "F5 Distributed Cloud API Token"
-  type        = string
-  sensitive   = true
-}
-
-# Or use P12 Certificate Authentication:
-# provider "f5xc" {
-#   api_url      = "https://your-tenant.console.ves.volterra.io"
-#   api_p12_file = "/path/to/certificate.p12"
-#   p12_password = var.f5xc_p12_password
-# }
-#
-# Environment variables for P12 authentication:
-# export F5XC_API_URL="https://your-tenant.console.ves.volterra.io"
-# export F5XC_P12_FILE="/path/to/certificate.p12"
-# export F5XC_P12_PASSWORD="your-p12-password"
-```
-
-## Argument Reference
-
-### Required (one of the following authentication methods)
-
-* `api_token` - F5 Distributed Cloud API Token (`String`, Sensitive). Can also be set via `F5XC_API_TOKEN` environment variable.
-
-* `api_p12_file` - Path to PKCS#12 certificate bundle file (`String`). Can also be set via `F5XC_P12_FILE` environment variable. Requires `p12_password`.
-
-* `api_cert` and `api_key` - Paths to PEM-encoded certificate and private key files (`String`). Can also be set via `F5XC_CERT` and `F5XC_KEY` environment variables.
-
-### Optional
-
-* `api_url` - F5 Distributed Cloud API URL (`String`). Base URL **without** `/api` suffix. Defaults to `https://console.ves.volterra.io`. Can also be set via `F5XC_API_URL` environment variable.
-
-* `p12_password` - Password for PKCS#12 certificate bundle (`String`, Sensitive). Required when using `api_p12_file`. Can also be set via `F5XC_P12_PASSWORD` environment variable.
-
-* `api_ca_cert` - Path to PEM-encoded CA certificate file (`String`). Optional, used for server certificate verification. Can also be set via `F5XC_CACERT` environment variable.
-
-## Authentication Options
-
-### Option 1: API Token Authentication
-
-The simplest authentication method using a personal API token.
-
-**Provider Configuration:**
+# F5 Distributed Cloud Terraform Provider
+
+<div class="landing-page">
+
+<div class="hero">
+  <h2>Manage F5 Distributed Cloud Resources with Terraform</h2>
+  <p>Community-driven Terraform provider for F5 Distributed Cloud (F5XC) built using the HashiCorp Terraform Plugin Framework. Implements F5's public OpenAPI specifications to manage F5XC resources via Infrastructure as Code.</p>
+
+  <div class="buttons">
+    <a href="getting-started/installation/" class="md-button md-button--primary">Get Started</a>
+    <a href="https://registry.terraform.io/providers/robinmordasiewicz/f5xc/latest" class="md-button">Terraform Registry</a>
+  </div>
+</div>
+
+## Key Features
+
+<div class="feature-grid">
+  <div class="feature">
+    <div class="feature-icon">🚀</div>
+    <h3>Complete Resource Coverage</h3>
+    <p>Manage HTTP load balancers, namespaces, security policies, and more through Terraform</p>
+  </div>
+
+  <div class="feature">
+    <div class="feature-icon">🔒</div>
+    <h3>Secure Authentication</h3>
+    <p>Support for API tokens and P12 certificate authentication</p>
+  </div>
+
+  <div class="feature">
+    <div class="feature-icon">📖</div>
+    <h3>OpenAPI-Based</h3>
+    <p>Automatically generated from F5's official OpenAPI specifications</p>
+  </div>
+
+  <div class="feature">
+    <div class="feature-icon">🧪</div>
+    <h3>Well-Tested</h3>
+    <p>Comprehensive acceptance tests ensure reliability</p>
+  </div>
+
+  <div class="feature">
+    <div class="feature-icon">🔄</div>
+    <h3>Import Support</h3>
+    <p>Import existing F5XC resources into Terraform state</p>
+  </div>
+
+  <div class="feature">
+    <div class="feature-icon">🛠️</div>
+    <h3>Provider Functions</h3>
+    <p>Utility functions for Secret Management and more</p>
+  </div>
+</div>
+
+## Quick Example
 
 ```hcl
-provider "f5xc" {
-  api_url   = "https://your-tenant.console.ves.volterra.io"
-  api_token = var.f5xc_api_token
-}
-```
-
-**Environment Variables:**
-
-```bash
-export F5XC_API_URL="https://your-tenant.console.ves.volterra.io"
-export F5XC_API_TOKEN="your-api-token"
-```
-
-### Option 2: P12 Certificate Authentication
-
-Certificate-based authentication using a PKCS#12 bundle downloaded from F5 Distributed Cloud.
-
-**Provider Configuration:**
-
-```hcl
-provider "f5xc" {
-  api_url      = "https://your-tenant.console.ves.volterra.io"
-  api_p12_file = "/path/to/certificate.p12"
-  p12_password = var.f5xc_p12_password
+terraform {
+  required_providers {
+    f5xc = {
+      source  = "robinmordasiewicz/f5xc"
+      version = "~> 3.0"
+    }
+  }
 }
-```
-
-**Environment Variables:**
-
-```bash
-export F5XC_API_URL="https://your-tenant.console.ves.volterra.io"
-export F5XC_P12_FILE="/path/to/certificate.p12"
-export F5XC_P12_PASSWORD="your-p12-password"
-```
-
-### Option 3: PEM Certificate Authentication
 
-Certificate-based authentication using separate PEM-encoded certificate and key files.
-
-**Provider Configuration:**
-
-```hcl
 provider "f5xc" {
-  api_url     = "https://your-tenant.console.ves.volterra.io"
-  api_cert    = "/path/to/certificate.crt"
-  api_key     = "/path/to/private.key"
-  api_ca_cert = "/path/to/ca-certificate.crt"  # Optional
+  api_url = "https://console.ves.volterra.io"
+  # api_token set via F5XC_API_TOKEN environment variable
 }
-```
-
-**Environment Variables:**
-
-```bash
-export F5XC_API_URL="https://your-tenant.console.ves.volterra.io"
-export F5XC_CERT="/path/to/certificate.crt"
-export F5XC_KEY="/path/to/private.key"
-export F5XC_CACERT="/path/to/ca-certificate.crt"  # Optional
-```
-
--> **Note:** Environment variables are the recommended approach for CI/CD pipelines and to avoid storing sensitive credentials in version control.
-
-## Getting Started
-
-1. **Generate API Credentials**: Navigate to your F5 Distributed Cloud console, go to **Administration** > **Personal Management** > **Credentials**, and create either an API Token or download a certificate bundle.
-
-2. **Configure the Provider**: Add the provider configuration to your Terraform files using one of the authentication options above.
-
-3. **Create Resources**: Start managing F5XC resources like namespaces, load balancers, and origin pools.
 
-### Example: Create a Namespace
-
-```hcl
 resource "f5xc_namespace" "example" {
   name = "example-namespace"
 }
-```
 
-### Example: Create an HTTP Load Balancer
-
-```hcl
 resource "f5xc_http_loadbalancer" "example" {
-  name      = "example-load-balancer"
-  namespace = "example-namespace"
-  domains   = ["example.com"]
-}
-```
-
-## MCP Configuration
-
-This provider includes a Model Context Protocol (MCP) server that enables AI assistants like Claude to interact with F5 Distributed Cloud resources. The MCP server provides schema information, documentation, and example configurations.
+  name      = "example-lb"
+  namespace = f5xc_namespace.example.name
 
-### Quick Setup for Claude Desktop
+  domains = ["example.com"]
 
-Add the following to your Claude Desktop configuration file:
-
-**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
-**Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
+  https_auto_cert {
+    http_redirect       = true
+    add_hsts            = false
+    no_mtls             = true
+    default_header      = true
+    enable_path_normalize = true
+  }
 
-```json
-{
-  "mcpServers": {
-    "f5xc-terraform": {
-      "command": "npx",
-      "args": ["@robinmordasiewicz/f5xc-terraform-mcp"]
+  default_route_pools {
+    pool {
+      name      = f5xc_origin_pool.example.name
+      namespace = f5xc_namespace.example.name
     }
+    weight   = 1
+    priority = 1
   }
-}
-```
-
-### Quick Setup for Claude Code (CLI)
-
-Install the MCP server with a single command:
-
-```bash
-claude mcp add f5xc-terraform -- npx -y @robinmordasiewicz/f5xc-terraform-mcp
-```
-
-**Scope Options:**
-
-* `--scope local` (default) - Available only in the current directory
-* `--scope user` - Available in all your Claude Code sessions
-* `--scope project` - Shared with anyone who clones the repository (saved in `.mcp.json`)
 
-Example with user scope (recommended for personal use):
-
-```bash
-claude mcp add --scope user f5xc-terraform -- npx -y @robinmordasiewicz/f5xc-terraform-mcp
-```
-
-**Verify Installation:**
-
-```bash
-claude mcp list
+  advertise_on_public_default_vip = true
+}
 ```
 
-You should see `f5xc-terraform` listed with a `✓ Connected` status.
-
-### Quick Setup for Visual Studio Code
-
-VS Code 1.99+ supports MCP servers through GitHub Copilot. Choose the installation method that best fits your environment:
-
-#### Option 1: Workspace Configuration (Recommended)
+## Getting Started
 
-Create a `.vscode/mcp.json` file in your workspace:
+<div class="highlight-boxes">
+  <div class="highlight">
+    <h3>📦 Installation</h3>
+    <p>Install the provider from the Terraform Registry</p>
+    <a href="getting-started/installation/">Learn more →</a>
+  </div>
 
-```json
-{
-  "servers": {
-    "f5xc-terraform": {
-      "command": "npx",
-      "args": ["-y", "@robinmordasiewicz/f5xc-terraform-mcp"]
-    }
-  }
-}
-```
+  <div class="highlight">
+    <h3>🔐 Authentication</h3>
+    <p>Configure API token or P12 certificate authentication</p>
+    <a href="getting-started/authentication/">Learn more →</a>
+  </div>
 
-#### Option 2: Corporate Environments (No Node.js Required)
+  <div class="highlight">
+    <h3>⚡ Quick Start</h3>
+    <p>Deploy your first F5XC resource in minutes</p>
+    <a href="getting-started/quick-start/">Learn more →</a>
+  </div>
+</div>
 
-For environments where npm/Node.js cannot be installed:
+## Resources
 
-1. Download the latest `.mcpb` bundle from [GitHub Releases](https://github.com/robinmordasiewicz/terraform-provider-f5xc/releases)
-2. Place the file in a known location (e.g., `~/.mcp/f5xc-terraform-mcp.mcpb`)
-3. Create a `.vscode/mcp.json` file:
+Explore the available resources and data sources:
 
-```json
-{
-  "servers": {
-    "f5xc-terraform": {
-      "command": "/path/to/f5xc-terraform-mcp.mcpb"
-    }
-  }
-}
-```
+- **[Resources](resources/)**: Create and manage F5XC infrastructure
+- **[Data Sources](data-sources/)**: Query existing F5XC resources
+- **[Functions](functions/)**: Utility functions for advanced use cases
+- **[Guides](guides/)**: Step-by-step tutorials for common scenarios
 
-#### Verify Installation
+## Community & Support
 
-1. Press `Ctrl+Shift+P` / `Cmd+Shift+P`
-2. Run `MCP: List Servers`
-3. Look for `f5xc-terraform` with a green status indicator
+This is a community-driven provider. Contributions are welcome!
 
-For complete MCP server documentation including all available tools and advanced configuration options, see the [NPM package page](https://www.npmjs.com/package/@robinmordasiewicz/f5xc-terraform-mcp).
+- **GitHub**: [robinmordasiewicz/terraform-provider-f5xc](https://github.com/robinmordasiewicz/terraform-provider-f5xc)
+- **Issues**: [Report bugs or request features](https://github.com/robinmordasiewicz/terraform-provider-f5xc/issues)
+- **Contributing**: [Development guide](contributing/development/)
 
-## Resources and Data Sources
+---
 
-Browse the documentation sidebar for the complete list of resources and data sources organized by category.
+<div class="footer-note">
+Built with ❤️ by the community • <a href="https://registry.terraform.io/providers/robinmordasiewicz/f5xc/latest">View on Terraform Registry</a>
+</div>
 
-<!-- Template version: 1.0.1 - MCP token optimization (#592) -->
+</div>

package/dist/docs/resources/index.md

@@ -0,0 +1,27 @@
+# Resources
+
+Resources allow you to create and manage F5 Distributed Cloud infrastructure.
+
+## Available Resources
+
+For a complete list of available resources, see the [Terraform Registry documentation](https://registry.terraform.io/providers/robinmordasiewicz/f5xc/latest/docs).
+
+### Core Resources
+
+- `f5xc_namespace` - Manage namespaces
+- `f5xc_http_loadbalancer` - HTTP/HTTPS load balancers
+- `f5xc_origin_pool` - Backend origin pools
+- `f5xc_app_firewall` - Web Application Firewall policies
+- And many more...
+
+## Resource Documentation
+
+Each resource is automatically generated from F5's official OpenAPI specifications and includes:
+
+- **Schema** - All available attributes and their types
+- **Import** - How to import existing resources
+- **Examples** - Working Terraform configurations
+
+## Finding Resources
+
+Visit the [Terraform Registry](https://registry.terraform.io/providers/robinmordasiewicz/f5xc/latest/docs) to search and browse all available resources.

package/dist/metadata/resource-metadata.json

@@ -13080,4 +13080,4 @@
       }
     }
   }
-}
+}

package/dist/metadata/validation-patterns.json

@@ -66,4 +66,4 @@
       ]
     }
   }
-}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@robinmordasiewicz/f5xc-terraform-mcp",
-  "version": "3.10.5",
+  "version": "3.11.0",
   "description": "MCP server for F5 Distributed Cloud Terraform provider - documentation, 270+ OpenAPI specs, subscription info, and addon activation workflows for AI assistants",
   "type": "module",
   "main": "dist/index.js",