Terragrunt MCP Server

A Model Context Protocol (MCP) server that provides comprehensive Terragrunt documentation and tooling integration for AI assistants like GitHub Copilot in VS Code.

Overview

This MCP server enables AI assistants to access and search the complete Terragrunt documentation, providing intelligent assistance for working with Terragrunt configurations, CLI commands, and HCL syntax. It features a robust caching system with network resilience and multiple fallback mechanisms.

New: Multi-mode architecture with 60-94% token overhead reduction for optimized AI assistant integration. Choose the mode that fits your workflow: CORE (docs), CONFIG (generation), GUIDANCE (troubleshooting), OBSERVABILITY (metrics), or FULL (all tools).

Features

📚 Documentation Access

• Live Documentation: Automatically fetches the latest Terragrunt documentation via llms.txt in a single HTTP request
• Indexed Search: Metadata-indexed architecture for efficient search with full content available on demand
• Smart Caching: Two-tier caching system (in-memory + disk) with 24-hour refresh cycle
• Network Resilience: Retry mechanism with exponential backoff (3 retries, up to 10s delay)
• Multiple Fallbacks: Network → Disk cache → Stale cache → Local fixture (for offline/CI use)
• Fast Search: Metadata-first search (title/section/URL) with full-text content fallback
• Organized Sections: Browse documentation by categories (getting-started, reference, features, etc.)
• Persistent Cache: Cache survives server restarts (stored in .cache/terragrunt-docs/)

See Lazy Loading Documentation for performance optimization details.

⚙️ Configuration Generator

• Tiered Templates: Essential (4-5 vars) and Advanced (9-12 vars) backend templates
• Multi-Cloud Support: AWS S3, Azure Blob Storage, GCP GCS backends
• Advanced Features: KMS encryption, cross-account access, managed identity, service account impersonation
• Mustache Conditionals: Smart rendering includes only provided options
• Two-Tier Validation: Regex-based (fast) + optional Terragrunt CLI validation (accurate)
• Custom Templates: Extend with organization-specific templates

See Advanced Backend Templates for enterprise configuration options.

🔧 Available Tools

8 consolidated tools for comprehensive Terragrunt assistance:

• 7 core tools (tools 1-7): Documentation, functions, CLI, HCL reference, guidance, config generation, error diagnosis
• 1 observability tool (tool 8): Server metrics and monitoring

1. search_docs - Unified Documentation Search

Unified tool for all documentation search needs - semantic search, browsing sections, retrieving content, and finding code examples.

• Parameters:
  • mode (string, optional): Operation mode - search, list, section, or examples (default: search)
  • query (string, conditional): Search query text (required for search mode, optional for examples)
  • section (string, conditional): Section name (required for section mode)
  • detailLevel (string, optional): summary or full (default: summary)
  • Additional mode-specific parameters (page, pageSize, limit, advanced, category, etc.)
• Modes:
  • search: Semantic search across all documentation
  • list: List available documentation sections
  • section: Get docs from a specific section
  • examples: Find code examples and patterns (supports advanced curated examples)
• Use cases: All doc-related tasks including search, browsing, section retrieval, and code examples

2. function_reference - Built-in Function Reference

Get function details OR list all functions - unified tool for Terragrunt built-in function documentation.

• Get Mode (when function_name provided):
  • function_name (string): Function name (e.g., "path_relative_to_include", "get_env")

... View full README on GitHub