Overview The get_env_map tool provides a comprehensive overview of all environment variables in your project. It scans the codebase, resolves variable definitions and usages, and returns a complete map with optional filtering by status.
Parameters Path to the project directory. Defaults to current working directory.
Filter variables by status. Defaults to “all”. Options:
all - Show all environment variablesmissing - Variables used in code but not defined anywhereunused - Variables defined in .env files but never usedrisky - Variables with critical or high risk levelundocumented - Variables used in code but not documented Response Statistical summary of environment variables Total number of unique environment variables found
Number of variables defined in .env files
Number of variables used in code
Number of variables missing from .env files
Number of variables lacking documentation
Number of unused (dead) variables
Number of variables with critical risk level
Array of environment variable summaries Files where the variable is defined
Files where the variable is used (limited to first 5)
Programming languages using this variable
Whether the variable has a default value in code
Whether the variable is documented in .env.example
Risk level: info, low, medium, high, or critical
Number of issues detected for this variable
Scan metadata Absolute path to the scanned project
Whether the scan used cached results
Scan duration in milliseconds
Example Response { "summary" : { "totalEnvVars" : 42 , "defined" : 38 , "used" : 40 , "missing" : 2 , "undocumented" : 5 , "dead" : 2 , "critical" : 1 }, "variables" : [ { "name" : "DATABASE_URL" , "definedIn" : [ ".env" , ".env.example" ], "usedIn" : [ "src/db/connection.ts" , "src/config/database.ts" ], "languages" : [ "typescript" ], "hasDefault" : false , "isDocumented" : true , "riskLevel" : "high" , "issueCount" : 0 }, { "name" : "API_KEY" , "definedIn" : [], "usedIn" : [ "src/api/client.ts" ], "languages" : [ "typescript" ], "hasDefault" : false , "isDocumented" : false , "riskLevel" : "critical" , "issueCount" : 2 } ], "metadata" : { "projectPath" : "/Users/dev/my-project" , "scannedFiles" : 156 , "cacheHit" : false , "duration" : 234 } }
Usage Example AI assistants can call this tool to get a comprehensive overview of all environment variables:
{ "name" : "get_env_map" , "arguments" : { "projectPath" : "/path/to/project" , "filter" : "missing" } }
To find only risky variables:
{ "name" : "get_env_map" , "arguments" : { "filter" : "risky" } }
Use Cases
Environment Audit : Get a complete overview of all environment variables and their statusFinding Missing Variables : Identify variables used in code but not defined in .env filesCleanup : Find unused variables that can be safely removedSecurity Review : Filter for risky or undocumented variablesDocumentation : Discover which variables need to be added to .env.example 