Command line

StaticalPrismCALCmd.exe is Prism for C/AL's command-line tool. You use it to show and install a license, and to run the MCP server for AI agents without a Prism window.

The Prism for C/AL MSIX package registers StaticalPrismCALCmd.exe as an execution alias, so it runs from any command prompt or script, whatever PATH holds. The MSI package installs the 3.x release, which this manual does not describe.

Help and common options

Put -h after the tool for a list of commands and the exit codes, or after a command for that command's help:

StaticalPrismCALCmd.exe -h
StaticalPrismCALCmd.exe license install -h

The tool prints a banner with its version first. It leaves the banner out when it runs an MCP server and when its output is redirected, so the output of a script stays clean.

The MCP server commands take a workspace argument: the path of an object text file (.txt) or of a folder of object files. A path that does not exist stops the command with Workspace not found and exit code 1. Both MCP server commands also take these options:

The command-line server does not read Prism's settings. Give it the encoding and filters your workspace window uses, so an agent sees the same objects you do. A value other than the default is echoed when the server starts.

license

Shows the license status of Prism for C/AL on this machine. It takes no arguments or options and always exits with 0.

StaticalPrismCALCmd.exe license

It prints one line per fact:

license install

Installs a license key, checks it, and prints the resulting status as license does. It saves the key in the same place the Activate license window does, so Prism and every running MCP server use it without a restart.

Give the key exactly once: as the argument, with --key-file or with --stdin. Use one of the two options in a script, so the key does not appear on a command line.

StaticalPrismCALCmd.exe license install --key-file "C:\keys\prism-for-cal.txt"
type "C:\keys\prism-for-cal.txt" | StaticalPrismCALCmd.exe license install --stdin

mcp-server-http

Runs an MCP server over HTTP for an object store, at http://localhost:<port>, without a Prism window. It is the same server the MCP server page describes. The alias mcp-server runs the same command.

Syntax:

StaticalPrismCALCmd.exe mcp-server-http <workspace> [options]

It takes the common options and these:

StaticalPrismCALCmd.exe mcp-server-http "C:\NAV\Cronus" --port 47821
StaticalPrismCALCmd.exe mcp-server "C:\NAV\Cronus.txt" --port-search 47821..47920 --encoding windows-1252

The server prints “MCP server is running on http://localhost:47821” and builds the symbol index in the background. A tool call that needs the index waits up to 20 seconds for it. Press Ctrl+C to stop the server; it then prints MCP server stopped.

mcp-server-stdio

Runs an MCP server that talks over its standard input and output. You do not run it yourself: you put it in an agent's MCP configuration, and the agent starts it whenever it needs the server. It works with Prism closed.

Syntax:

StaticalPrismCALCmd.exe mcp-server-stdio <workspace> [options]

It takes the common options and no port options.

StaticalPrismCALCmd.exe mcp-server-stdio "C:\NAV\Cronus" --encoding 850 --file-include-filter "*.txt"

Every start builds the symbol index again, which takes a while on a large object store, and a tool call that needs the index waits up to 20 seconds for it. When one Prism window is open on the store anyway, connect the agent to that window's HTTP server instead. The server stops when its standard input closes or on Ctrl+C, and writes its messages to standard error, never to standard output.

Exit codes

Install a license from a script

Use this to license Prism for C/AL on a machine without opening Prism, for example when you set up machines from a script. You need the license key in a text file.

1. Save the key in a text file the script can read, such as C:\keys\prism-for-cal.txt.
2. Run this command:

   StaticalPrismCALCmd.exe license install --key-file "C:\keys\prism-for-cal.txt"

3. Check the exit code: 0 means the key is installed; -33 means it was rejected, with the reason on standard error.
4. Delete the key file if it should not stay on the machine.

StaticalPrismCALCmd.exe license install --key-file "C:\keys\prism-for-cal.txt"
if %errorlevel% neq 0 (echo License not installed & exit /b 1)
del "C:\keys\prism-for-cal.txt"

The output shows Status: Licensed and the license file Prism now reads. A key bound to another machine is rejected; StaticalPrismCALCmd.exe license prints the Machine code of this one.

Run the MCP server over stdio for an agent

Use this when an agent should reach your C/AL objects without a Prism window open. The agent starts the server itself, so there is nothing to keep running.

1. Find the absolute path of your object store: an object text file or a folder of object files.
2. Open the agent's MCP configuration file, such as .mcp.json for Claude Code or .vscode/mcp.json for GitHub Copilot in Visual Studio Code.
3. Add an entry whose command is StaticalPrismCALCmd.exe and whose args are mcp-server-stdio and the path. Add --encoding and the filter options when your Prism settings use them.
4. Save the file and start a new agent session. Ask a question that names a C/AL object.

{
  "mcpServers": {
    "prism-cronus-3f9a1c": {
      "type": "stdio",
      "command": "StaticalPrismCALCmd.exe",
      "args": [
        "mcp-server-stdio",
        "C:\\NAV\\Cronus",
        "--encoding",
        "850"
      ]
    }
  }
}

The agent's first call that needs the symbol index waits while the server builds it. The MCP Server page in a workspace window writes this entry for you, with the path filled in; see Connect an agent.

Related

• MCP server: connect an agent, and every tool and resource the server offers.
• Activate license window: activate or remove a license in Prism.
• Settings page: the encoding and folder store filters the server options mirror.
• Installation: install the MSIX package that brings the tool.