Edit

Get package dependencies - al_getpackagedependencies

Applies to: AL Language extension 17.0 and later | Available in: AL MCP Server only

The al_getpackagedependencies tool reads the app.json file of an AL project and returns its declared package dependencies—including the app name, publisher, app ID (GUID), and version range for each dependency.

Use this tool to understand what packages a project requires before downloading symbols or publishing, to audit dependency graphs, or to check whether a specific package is referenced.

Note

This tool is available on the AL MCP Server only. In Visual Studio Code, inspect the app.json file directly to view dependencies.

Parameters

Parameter Type Default Description
projectPath string First project in workspace Absolute path to the AL project folder containing app.json.
name string — Optional. When specified, returns only the dependency matching this app name.

Return value

Property Type Description
Succeeded boolean true if the operation completed successfully.
ModuleName string The name of the queried project or module.
Dependencies array List of dependency items (see below).
ErrorMessage string Error description if Succeeded is false.

Each item in Dependencies has:

Property Type Description
Name string App name.
Publisher string Publisher name.
Id string App ID (GUID).
Version string Required version range (for example, "24.0.0.0").

Examples

List all dependencies for the workspace project

{}

List dependencies for a specific project

{
  "projectPath": "C:/repos/MyExtension"
}

Check whether a specific package is a dependency

{
  "projectPath": "C:/repos/MyExtension",
  "name": "Base Application"
}

Suggested next steps

  • Use the returned dependency list to decide which packages to download with al_downloadsymbols.
  • Compare the declared dependencies against what is available in .alpackages to identify missing symbols.

AI agent tools overview
AL MCP Server reference

  • Last updated on