list-doc-categoriesLABSCO SUMMARY
Terragrunt blocks are exactly the thing an assistant invents plausibly and wrongly.
Editor tooling covers Terraform well and Terragrunt poorly, which is where confident, incorrect completions come from. Reading the current docs and the open issues in the same session covers both halves of that: what the syntax is, and what is currently broken. Start from the category listing — it is the map the other four tools navigate.
What it is
A documentation provider for Terragrunt. It reads the docs straight from the project's GitHub repository — categories, individual pages, or a whole category merged — and can also pull the open issues for context on known problems.
What you get
- list-doc-categories — every documentation category, with the link for each
- list-all-docs-by-category — the docs in one category, with their content
- read-document-from-category — the full markdown of one document
- read-all-docs-from-category — every doc in a category merged into a single response
- get-all-open-issues — open issues from the Terragrunt repository with title, number, state, dates, body and labels
Requirements
A GitHub token, read from GITHUB_TOKEN, GH_TOKEN or GITHUB_PERSONAL_ACCESS_TOKEN — all five tools need it. Deno is the runtime; run it straight from JSR, from a local checkout, or from the Docker image built by the repository's Dockerfile.
Setup effort
One command plus a key — deno run -A jsr:@excoriate/mcp-terragrunt-docs@0.1.0, then supply credentials
USE CASES
Getting the syntax right the first time
Find the category covering the block you are writing and read that document in full.
Loading a whole topic at once
Merge every document in a category into one response before a long editing session.
Checking whether the problem is you
Search the open issues for the behaviour you are seeing before rewriting your configuration.
Surveying what is documented
List everything in a category with its content to see what the project actually covers.
5 tools
Listed in project docs. Your client may show a different list.
list-all-docs-by-categoryread-document-from-categoryread-all-docs-from-categoryget-all-open-issuesBEFORE YOU INSTALL
What to know first
Tools you get
5 tools named in the project's documentation.
Requires
- deno on PATH
- GITHUB_TOKEN in your environment
Where it runs
All 3 documented setups run the server on your machine.
INSTALLATION
Connect your client
Server setup
deno run -A jsr:@excoriate/mcp-terragrunt-docs@0.1.0MCP Clients
Claude Desktop — JSR
{
"mcpServers": {
"terragrunt_docs": {
"command": "deno",
"args": [
"run",
"-A",
"jsr:@excoriate/mcp-terragrunt-docs@0.1.0"
],
"env": {
"GITHUB_TOKEN": "<YOUR_TOKEN>"
}
}
}
}Claude Desktop — Deno local
{
"mcpServers": {
"terragrunt_docs": {
"command": "deno",
"args": [
"run",
"-A",
"main.ts"
],
"env": {
"GITHUB_TOKEN": "<YOUR_TOKEN>"
}
}
}
}Claude Desktop — Docker
{
"mcpServers": {
"terragrunt_docs": {
"command": "docker",
"args": [
"run",
"-e",
"GITHUB_TOKEN=<YOUR_TOKEN>",
"mcp-terragrunt-docs"
],
"env": {
"GITHUB_TOKEN": "<YOUR_TOKEN>"
}
}
}
}