Wolfram AgentTools

https://github.com/wolframresearch/agenttools
Admin
Wolfram AgentTools is a Wolfram Language toolkit for integrating AI agents and LLMs with...
Tokens:134,794
Snippets:904
Trust Score:9.4
License:MIT
Update:5 months ago
Show doc for...
Tokens:
Raw
### InstallMCPServer with ToolOptions

Source: https://github.com/wolframresearch/agenttools/blob/main/Notes/tool-options.md

Example of how to specify custom options for built-in tools like WolframLanguageContext and WolframLanguageEvaluator when installing an MCP server.

```wl
InstallMCPServer[
	"ClaudeCode",
	"WolframLanguage",
	"ToolOptions" -> <|
		"WolframLanguageContext" -> <|"MaxItems" -> 5|>,
		"WolframLanguageEvaluator" -> <|"Method" -> "Local"|>
	|>
]
```

--------------------------------

### Install MCP Server for Kiro

Source: https://github.com/wolframresearch/agenttools/blob/main/client-research/kiro.md

Example usage of the InstallMCPServer function targeting the Kiro client directory.

```Wolfram Language
InstallMCPServer[{"Kiro", dir}, ...]
```

--------------------------------

### Install MCP Server

Source: https://github.com/wolframresearch/agenttools/blob/main/client-research/junie.md

Provides information on how to install an MCP server.

```Markdown
[`Kernel/InstallMCPServer.wl`](../Kernel/InstallMCPServer.wl)
```

--------------------------------

### InstallMCPServer with CodeInspector ToolOptions

Source: https://github.com/wolframresearch/agenttools/blob/main/Notes/tool-options.md

Example demonstrating how to set specific options for the CodeInspector tool, including 'ConfidenceLevel' and 'DefaultSeverityExclusions', when installing an MCP server.

```wl
InstallMCPServer[
    "ClaudeCode",
    "WolframLanguage",
    "ToolOptions" -> <|
        "CodeInspector" -> <|
            "ConfidenceLevel" -> 0.25,
            "DefaultSeverityExclusions" -> {"Remark", "Scoping"}
        |>
    |>
]
```

--------------------------------

### DeployedAgentTools Usage Examples

Source: https://github.com/wolframresearch/agenttools/blob/main/docs/deploy-agent-tools.md

Examples of listing and filtering existing deployments.

```wl
(* List all deployments *)
DeployedAgentTools[]
(* {AgentToolsDeployment[...], AgentToolsDeployment[...]} *)

(* Filter by client *)
DeployedAgentTools["ClaudeDesktop"]
(* {AgentToolsDeployment[...]} *)

(* Aliases are resolved *)
DeployedAgentTools["Claude"]  (* same as "ClaudeDesktop" *)
```

--------------------------------

### Install Wolfram Engine on Linux

Source: https://github.com/wolframresearch/agenttools/blob/main/AgentSkills/Skills/wolfram-paclets/references/GetWolframEngine.md

Run the downloaded shell installer script with root privileges to install the engine.

```bash
sudo bash WolframEngine_*_Linux.sh
```

--------------------------------

### Install AgentTools Paclet

Source: https://github.com/wolframresearch/agenttools/blob/main/AgentSkills/Skills/wolfram-alpha/references/SetUpWolframMCPServer.md

Installs the AgentTools paclet for local Wolfram MCP server setup. Run this in a Wolfram Language session.

```wl
PacletInstall["Wolfram/AgentTools"]
```

--------------------------------

### Install MCP Server for Project

Source: https://github.com/wolframresearch/agenttools/blob/main/README.md

Installs an MCP server for a specific project within a client application that supports project-level installation. Specify the client name and project path.

```wl
InstallMCPServer[{"ClaudeCode", "/path/to/project"}, "WolframLanguage"]
```

--------------------------------

### Install Wolfram MCP Server

Source: https://github.com/wolframresearch/agenttools/blob/main/docs/servers.md

Installs the default Wolfram server for general-purpose computational tasks and documentation lookup.

```wl
InstallMCPServer["ClaudeDesktop", "Wolfram"]
```

--------------------------------

### Install Local MCP Server

Source: https://github.com/wolframresearch/agenttools/blob/main/AgentSkills/Skills/wolfram-alpha/references/SetUpWolframMCPServer.md

Installs a local Wolfram MCP server for a specified client and server name. Ensure wolframscript is available.

```wl
Needs["Wolfram`AgentTools`"]
Wolfram`AgentTools`InstallMCPServer["<ClientName>", "<ServerName>"]
```

--------------------------------

### Install Wolfram Server for Claude Desktop

Source: https://github.com/wolframresearch/agenttools/blob/main/docs/quickstart-chat.md

Run this command in a Wolfram Language session to install the default Wolfram server into Claude Desktop's configuration. Ensure Claude Desktop is fully restarted after installation.

```wl
InstallMCPServer["ClaudeDesktop"]

```

--------------------------------

### Install WolframPacletDevelopment MCP Server

Source: https://github.com/wolframresearch/agenttools/blob/main/docs/servers.md

Installs the WolframPacletDevelopment server for paclet creation, documentation management, and distribution.

```wl
InstallMCPServer[{"ClaudeCode", "/path/to/paclet"}, "WolframPacletDevelopment"]
```

--------------------------------

### Install MCP Server for Claude Desktop

Source: https://github.com/wolframresearch/agenttools/blob/main/README.md

Installs the default MCP server configuration for Claude Desktop. Restart Claude Desktop after installation for changes to take effect.

```wl
InstallMCPServer["ClaudeDesktop"]
```

--------------------------------

### InstallMCPServer

Source: https://github.com/wolframresearch/agenttools/blob/main/README.md

Installs an MCP server for a specified client. Can install the default server or a specific one.

```APIDOC
## POST /api/mcp/clients/{client}/install

### Description
Install an MCP server for a client. This can be the default server or a specific named server.

### Method
POST

### Endpoint
/api/mcp/clients/{client}/install

### Parameters
#### Path Parameters
- **client** (string) - Required - The identifier for the client.

#### Query Parameters
- **serverName** (string) - Optional - The name of the specific server to install. If not provided, the default server is installed.

#### Request Body
- **options** (object) - Optional - Options for the installation.
  - **"EnableMCPApps"** (boolean) - Default: `True` - Enable or disable MCP Apps UI resources.
  - **"DevelopmentMode"** (boolean) - Default: `False` - Use local source files instead of installed paclet.
  - **"MCPServerName"** (string) - Default: `Automatic` - Override the config file key for the server entry.
  - **"ToolOptions"** (object) - Default: `{}` - Customize built-in tool behavior.
  - **"VerifyLLMKit"** (boolean) - Default: `True` - Check LLMKit subscription requirements.

### Response
#### Success Response (200)
- **status** (string) - Indicates the success of the installation.

#### Response Example
```json
{
  "status": "Success["InstallMCPServer", <|...|>]"
}
```
```

--------------------------------

### Install PacletCICD Paclet

Source: https://github.com/wolframresearch/agenttools/blob/main/Notes/new-paclet-development-tools.md

This command installs the Wolfram/PacletCICD paclet. It is a prerequisite for using the CheckPaclet, BuildPaclet, and SubmitPaclet functions. PacletInstall is efficient for already installed paclets.

```Wolfram Language
PacletInstall[ "Wolfram/PacletCICD" ]
```

--------------------------------

### Install MCP Servers

Source: https://github.com/wolframresearch/agenttools/blob/main/docs/servers.md

Demonstrates installing built-in servers into MCP clients. Note that servers sharing the 'Wolfram' config key are mutually exclusive.

```Wolfram Language
InstallMCPServer["ClaudeDesktop", "Wolfram"]
InstallMCPServer["ClaudeDesktop", "WolframLanguage"]
(* Only "WolframLanguage" remains, under the "Wolfram" config key *)
```

```Wolfram Language
(* Install default (Wolfram) server *)
InstallMCPServer["ClaudeDesktop"]

(* Install a specific server *)
InstallMCPServer["ClaudeCode", "WolframLanguage"]

(* Install to a project directory *)
InstallMCPServer[{"ClaudeCode", "/path/to/project"}, "WolframPacletDevelopment"]
```

--------------------------------

### CLI Script Invocation Examples

Source: https://github.com/wolframresearch/agenttools/blob/main/Specs/AgentSkills.md

Examples of command-line syntax for .wls scripts, demonstrating positional arguments and optional flags.

```bash
wolframscript -f TestReport.wls <paths> [--timeConstraint N] [--memoryConstraint N] [--newKernel true|false]
```

```bash
wolframscript -f CodeInspector.wls [--code "..."] [--file "..."] [--severityExclusions "..."] [--confidenceLevel N] [--limit N]
```

--------------------------------

### Append an Option Documentation Example

Source: https://github.com/wolframresearch/agenttools/blob/main/Specs/PacletDocumentationTools.md

Add documentation for a specific option of a function, illustrating its usage with an example.

```json
{
  "tool": "EditSymbolPacletDocumentationExamples",
  "parameters": {
    "notebook": "/path/to/MyPaclet/Documentation/English/ReferencePages/Symbols/AddOne.nb",
    "operation": "appendExample",
    "section": "Options",
    "subsection": "Method",
    "content": "Use Method -> \"Fast\" for optimized computation:\n\n```wl\nAddOne[Range[1000], Method -> \"Fast\"]\n```"
  }
}
```

--------------------------------

### Install pi-mcp-adapter

Source: https://github.com/wolframresearch/agenttools/blob/main/client-research/pi.md

Install the required adapter to enable MCP support in the Pi coding agent.

```bash
pi install npm:pi-mcp-adapter
```

--------------------------------

### POST InstallMCPServer

Source: https://github.com/wolframresearch/agenttools/blob/main/Specs/PacletExtension.md

Installs an MCP server, including automatic paclet installation and validation.

```APIDOC
## POST InstallMCPServer

### Description
Installs an MCP server. If the server is paclet-qualified, it automatically installs the required paclet and validates tool definitions.

### Method
POST

### Endpoint
InstallMCPServer[shortName, qualifiedName]

### Parameters
#### Request Body
- **shortName** (String) - Required - The local name for the server.
- **qualifiedName** (String) - Required - The paclet-qualified server name (e.g., "Wolfram/JIRALink/ProjectManagement").
```

--------------------------------

### Project-Level MCP Server Installation

Source: https://github.com/wolframresearch/agenttools/blob/main/docs/mcp-clients.md

Installs an MCP server into a specific project directory by creating a `.mcp.json` file. This is for clients that support project-level configuration.

```wl
InstallMCPServer[{"ClaudeCode", "/path/to/project"}]
```

--------------------------------

### Install MCP Server in Development Mode

Source: https://github.com/wolframresearch/agenttools/blob/main/docs/mcp-clients.md

Installs an MCP server using local development files instead of the installed paclet. Useful for testing local changes without reinstalling the paclet.

```Wolfram Language
InstallMCPServer["ClaudeCode", "DevelopmentMode" -> True]
```

--------------------------------

### MCP Server Setup Reference Note

Source: https://github.com/wolframresearch/agenttools/blob/main/Specs/AgentSkills.md

Standardized markdown note for suggesting the Wolfram MCP server setup for enhanced functionality.

```markdown
For a richer experience, consider setting up the Wolfram MCP server.
See `references/SetUpWolframMCPServer.md` (relative to this
skill directory) for instructions.
```

--------------------------------

### Project-Level Local MCP Server Installation

Source: https://github.com/wolframresearch/agenttools/blob/main/AgentSkills/Skills/wolfram-alpha/references/SetUpWolframMCPServer.md

Installs a local MCP server for a specific project, supported by certain clients. Replace placeholders with actual values.

```wl
InstallMCPServer[{"ClaudeCode", "/path/to/project"}, "<ServerName>"]
```

--------------------------------

### Install Wolfram/AgentTools Paclet

Source: https://github.com/wolframresearch/agenttools/blob/main/README.md

Use this command to install the AgentTools paclet. Ensure you have Wolfram Language 14.3 or higher.

```wl
PacletInstall["Wolfram/AgentTools"]
```

--------------------------------

### Tool Response for Appending Example

Source: https://github.com/wolframresearch/agenttools/blob/main/Specs/PacletDocumentationTools.md

This is the expected response from the tool after successfully appending an example, indicating the file, operation, section, and the generated content including the output.

```json
{
  "file": "/path/to/MyPaclet/Documentation/English/ReferencePages/Symbols/AddOne.nb",
  "operation": "appendExample",
  "section": "BasicExamples",
  "generatedContent": "Add one to a symbolic expression:\n\n```wl\nAddOne[x + y]\n```\n```wl-output\n1 + x + y\n```"
}
```

--------------------------------

### Import AGENTS.md Example

Source: https://github.com/wolframresearch/agenttools/blob/main/docs/quickstart-coding.md

This example shows how to import the AGENTS.md file used during the development of the AgentTools paclet. It's useful for understanding real-world AGENTS.md content.

```wl
Import[PacletObject["Wolfram/AgentTools"]["AssetLocation", "AGENTS.md"], "Text"]
```

--------------------------------

### Initialization and Setup

Source: https://github.com/wolframresearch/agenttools/blob/main/Assets/Apps/evaluator-viewer.html

Initiates the tool viewer by sending an initialization request to the host. Sets up auto-resize and applies the initial theme based on the host context.

```javascript
sendRequest("ui/initialize", {
  protocolVersion: "2026-01-26",
  appInfo: { name: "evaluator-viewer", version: "1.0.0" },
  appCapabilities: {
    availableDisplayModes: ["inline"],
    tools: { listChanged: false }
  }
}).then(function(result) {
  sendNotification("ui/notifications/initialized");
  setupAutoResize();
  if (result) {
    applyTheme(result.hostContext || result.context || result);
  }
}).catch(function(err) {
  showError("Failed to initialize: " + ((err && err.message) || String(err)));
});
```

--------------------------------

### InstallMCPServer with Multiple Built-In Servers

Source: https://github.com/wolframresearch/agenttools/blob/main/Specs/DeployAgentTools.md

Demonstrates how installing multiple built-in servers with distinct names to the same client can lead to coexistence in the client's configuration file.

```wl
InstallMCPServer["ClaudeDesktop", "Wolfram"]
InstallMCPServer["ClaudeDesktop", "WolframLanguage"]
(* Both entries now coexist in claude_desktop_config.json *)
```

--------------------------------

### Install WolframLanguage Server for Copilot CLI

Source: https://github.com/wolframresearch/agenttools/blob/main/docs/quickstart-coding.md

Installs the WolframLanguage MCP server for use with the Copilot CLI. This allows the Copilot CLI to interact with the Wolfram Language.

```wl
InstallMCPServer["CopilotCLI", "WolframLanguage"]
```

--------------------------------

### Example CLI Usage

Source: https://github.com/wolframresearch/agenttools/blob/main/docs/agent-skills.md

Demonstrates the expected command-line interface structure for generated scripts.

```bash
wolframscript -f TestReport.wls <paths> [--timeConstraint N] [--memoryConstraint N] [--newKernel true|false]
wolframscript -f CodeInspector.wls [--code "..."] [--file "..."] [--severityExclusions "..."]
```

--------------------------------

### POST /prependExample

Source: https://github.com/wolframresearch/agenttools/blob/main/Specs/PacletDocumentationTools.md

Adds content to the beginning of a specified example section.

```APIDOC
## POST /prependExample

### Description
Adds content at the beginning of the specified example section.

### Parameters
#### Request Body
- **section** (string) - Required - Target section name
- **content** (string) - Required - Markdown string with example content
- **subsection** (string) - Optional - For "Options" section

### Response
#### Success Response (200)
- **file** (string) - Path to the modified notebook file
- **operation** (string) - The operation performed
- **section** (string) - The section modified
- **generatedContent** (string) - Markdown representation of added cells
```

--------------------------------

### Basic Symbol Definition Request (Unqualified)

Source: https://github.com/wolframresearch/agenttools/blob/main/Specs/SymbolDefinition.md

Example JSON request to get the definition of an unqualified symbol like 'Map'.

```JSON
{
  "tool": "SymbolDefinition",
  "parameters": {
    "symbols": "Map"
  }
}
```

--------------------------------

### Basic Symbol Definition Request (Qualified)

Source: https://github.com/wolframresearch/agenttools/blob/main/Specs/SymbolDefinition.md

Example JSON request to get the definition of a qualified symbol like 'Wolfram`AgentTools`CreateMCPServer'.

```JSON
{
  "tool": "SymbolDefinition",
  "parameters": {
    "symbols": "Wolfram`AgentTools`CreateMCPServer"
  }
}
```

--------------------------------

### Example Output for Plus

Source: https://github.com/wolframresearch/agenttools/blob/main/Specs/SymbolDefinition.md

Representation of how kernel-handled functions are documented.

```wl
Attributes[Plus] = {Flat, Listable, NumericFunction, OneIdentity, Orderless, Protected}

Default[Plus] := 0

Plus[___] := <kernel function>
```

--------------------------------

### Reference Prompts in Custom Servers

Source: https://github.com/wolframresearch/agenttools/blob/main/docs/mcp-prompts.md

Use CreateMCPServer to initialize a server with specific prompts, either by name or via paclet qualification.

```wl
CreateMCPServer[ "MyServer", <|
    "MCPPrompts" -> { "WolframLanguageSearch" }
|> ]
```

```wl
CreateMCPServer[ "MyServer", <|
    "MCPPrompts" -> {
        "WolframLanguageSearch",
        "PublisherID/MyPaclet/CustomPrompt"
    }
|> ]
```

--------------------------------

### Getting Location of Paclet-Defined Server

Source: https://github.com/wolframresearch/agenttools/blob/main/Specs/PacletExtension.md

For paclet-defined servers, the 'Location' property returns a PacletObject. This example shows how to retrieve the PacletObject for the 'Wolfram/JIRALink/ProjectManagement' server.

```Wolfram Language
MCPServerObject["Wolfram/JIRALink/ProjectManagement"]["Location"]
(* PacletObject["Wolfram/JIRALink"] *)
```

--------------------------------

### Symbol Definition Request for Multiple Symbols

Source: https://github.com/wolframresearch/agenttools/blob/main/Specs/SymbolDefinition.md

Example JSON request to get definitions for multiple symbols, including a mix of qualified and unqualified names, and a non-existent symbol.

```JSON
{
  "tool": "SymbolDefinition",
  "parameters": {
    "symbols": "Plus, Subtract, NonExistent`Symbol"
  }
}
```

--------------------------------

### Start MCPServer with Paclet Dependency Error

Source: https://github.com/wolframresearch/agenttools/blob/main/Specs/PacletExtension.md

Demonstrates a scenario where StartMCPServer fails due to a missing paclet dependency. The error message indicates that a required paclet could not be installed.

```Wolfram Language
(* Cross-paclet dependency that fails to install *)
StartMCPServer @ MCPServerObject["MyServer"]
(* AgentTools::PacletDependencyMissing: Server "MyServer" references tool
   "Wolfram/SlackLink/PostMessage" from paclet "Wolfram/SlackLink",
   which could not be installed. *)
```

--------------------------------

### Configure Build Options

Source: https://github.com/wolframresearch/agenttools/blob/main/docs/building.md

Examples of running the build script with specific flags to modify behavior.

```bash
wolframscript -f Scripts/BuildPaclet.wls --install=true
```

```bash
wolframscript -f Scripts/BuildPaclet.wls --check=false
```

```bash
wolframscript -f Scripts/BuildPaclet.wls --mx=false
```

--------------------------------

### Install an MCP Server

Source: https://github.com/wolframresearch/agenttools/blob/main/Specs/PacletExtension.md

Installs an MCP server by name, automatically handling paclet installation and validation of qualified tools.

```wl
InstallMCPServer[ "ClaudeCode", "Wolfram/JIRALink/ProjectManagement" ]
```

--------------------------------

### Ensure PacletCICD is Installed and Loaded

Source: https://github.com/wolframresearch/agenttools/blob/main/Specs/PacletTools.md

This helper function ensures the Wolfram/PacletCICD paclet is installed and loaded. It uses memoization to perform the installation and loading only once per session.

```wl
ensurePacletCICD // beginDefinition;

ensurePacletCICD[] := ensurePacletCICD[] = Enclose[
    Module[ { paclet },
        paclet = PacletInstall[ "Wolfram/PacletCICD" ];

        If[ ! MatchQ[ paclet, _PacletObject ],
            throwFailure[ "PacletCICDLoadFailed" ]
        ];

        Needs[ "Wolfram`PacletCICD`" -> None ];
        Null
    ],
    throwInternalFailure
];

ensurePacletCICD // endDefinition;
```

--------------------------------

### Using Tools in Custom Servers

Source: https://github.com/wolframresearch/agenttools/blob/main/docs/tools.md

Demonstrates how to reference and include tools when creating custom servers.

```APIDOC
## Using Tools in Custom Servers

### Reference by Name

```wl
CreateMCPServer[ "MyServer", <|
    "Tools" -> { "WolframLanguageEvaluator", "WolframAlpha" }
|> ]
```
```

--------------------------------

### Combined Definition File Example

Source: https://github.com/wolframresearch/agenttools/blob/main/Specs/PacletExtension.md

Shows how to define multiple tools within a single combined definition file, using both association and LLMTool forms.

```Wolfram Language
(* AgentTools/Tools.wl *)
<|
    "Increment" -> LLMTool[ "Increment", { "x" -> "Integer" }, #x + 1 & ],
    "GetIssue"  -> <| "Name" -> "GetIssue", ... |>
|>
```

--------------------------------

### Initialize UI Protocol

Source: https://github.com/wolframresearch/agenttools/blob/main/Assets/Apps/mcp-apps-test.html

Establishes the communication protocol and applies host context upon successful initialization.

```javascript
} }); // ---- Initialize ---- sendRequest("ui/initialize", { protocolVersion: "2026-01-26", appInfo: { name: "mcp-apps-test", version: "1.0.0" }, appCapabilities: { availableDisplayModes: ["inline"], tools: { listChanged: false } } }).then(function(result) { check("chk-init"); // Send the required initialized notification sendNotification("ui/notifications/initialized"); // Set up auto-resize reporting setupAutoResize(); // Apply initial host context if (result) { applyTheme(result.hostContext || result.context || result); } }).catch(function(err) { log("in", "init-error", err); });
```

--------------------------------

### POST /setExamples

Source: https://github.com/wolframresearch/agenttools/blob/main/Specs/PacletDocumentationTools.md

Completely replaces all examples in a section.

```APIDOC
## POST /setExamples

### Description
Replaces all examples in a section with the provided content. Use '---' to separate example groups.

### Parameters
#### Request Body
- **section** (string) - Required - Target section name
- **content** (string) - Required - Markdown string with all examples
- **subsection** (string) - Optional - For "Options" section
```

--------------------------------

### Replace All Examples in a Section

Source: https://github.com/wolframresearch/agenttools/blob/main/Specs/PacletDocumentationTools.md

Replace all existing examples within a specified section of a symbol's documentation with new content. This operation allows for a complete overhaul of examples in a section.

```json
{
  "tool": "EditSymbolPacletDocumentationExamples",
  "parameters": {
    "notebook": "/path/to/MyPaclet/Documentation/English/ReferencePages/Symbols/AddOne.nb",
    "operation": "setExamples",
    "section": "BasicExamples",
    "content": "Add one to a number:\n\n```wl\nAddOne[5]\n```\n\n---\n\nAdd one to a symbol:\n\n```wl\nAddOne[x]\n```\n\n---\n\nAdd one to a list:\n\n```wl\nAddOne[{1, 2, 3}]\n```"
  }
}
```

--------------------------------

### Truncated Output Example

Source: https://github.com/wolframresearch/agenttools/blob/main/Specs/SymbolDefinition.md

Example of how output is formatted when it exceeds the character limit.

```markdown
# VeryLargeSymbol

## Definition

```wl
largeSymbol[args_] :=
    Module[{...},
        (* large body *)
        ...
... [truncated, showing 10000/45000 characters]
```

--------------------------------

### InstallMCPServer with MCPServerName Option

Source: https://github.com/wolframresearch/agenttools/blob/main/Specs/DeployAgentTools.md

Shows how to use the 'MCPServerName' option to override the default configuration key, allowing multiple built-in servers to be installed distinctly.

```wl
(* Default: both write to the "Wolfram" key, so the second overwrites the first *)
InstallMCPServer["ClaudeDesktop", "Wolfram"]
InstallMCPServer["ClaudeDesktop", "WolframLanguage"]

(* Override: install under a custom key to keep both *)
InstallMCPServer["ClaudeDesktop", "Wolfram", "MCPServerName" -> "WolframBasic"]
InstallMCPServer["ClaudeDesktop", "WolframLanguage", "MCPServerName" -> "WolframDev"]
```

--------------------------------

### User-Visible Warning for Pi Client Prerequisite

Source: https://github.com/wolframresearch/agenttools/blob/main/client-research/pi.md

A note or warning explaining the hard prerequisite for `InstallMCPServer["Pi", ...]` which is the prior installation of the adapter. This prevents users from reporting inert configurations.

```Markdown
Optional but recommended: A clear user-visible warning (or at least doc note) explaining that `InstallMCPServer["Pi", ...]` has a hard prerequisite — the adapter must already be installed, otherwise the written config is inert. This could be an up-front check in the Pi-specific install branch using `RunProcess[{"pi", "list"}, ...]` or equivalent, but that's fragile; a doc note is probably sufficient.
```

--------------------------------

### Detect Get with Context Path Modification

Source: https://github.com/wolframresearch/agenttools/blob/main/TODO/runtime-needs-hint.md

Identifies functions that use Get with a context that modifies the $ContextPath at runtime. The suggested fix is to use Block[{$ContextPath}, Get["context`"]].

```Wolfram Language
Get["context`"]
```

--------------------------------

### Server Definition Example

Source: https://github.com/wolframresearch/agenttools/blob/main/Specs/PacletExtension.md

Defines a server with its name, initialization, and LLMEvaluator configuration. Used for server definitions.

```Wolfram Language
(* AgentTools/MCPServers/ProjectManagement.wl *)
<|
    "Name"           -> "ProjectManagement",
    "Initialization" :> Needs[ "Wolfram`JIRALink`" ],
    "LLMEvaluator"   -> <|
        "Tools"      -> { "CreateIssue", "DeleteIssue", "GetIssue", "SearchIssues" },
        "MCPPrompts" -> { "IssueText" }
    |>
|>
```

--------------------------------

### Inspect code string example

Source: https://github.com/wolframresearch/agenttools/blob/main/Specs/CodeInspectorTool.md

Example of a Wolfram Language code string passed to the inspector.

```text
"If[a, b, b]"
```

--------------------------------

### Create MCP Server with Tools

Source: https://github.com/wolframresearch/agenttools/blob/main/docs/mcp-apps.md

Use `CreateMCPServer` to define a custom server configuration, specifying the tools to be included.

```wl
CreateMCPServer["MyServer", <|
    "Tools" -> {
        "WolframLanguageEvaluator",
        "WolframAlpha",
        "NotebookViewer"
    }
|>]
```

--------------------------------

### Verify wolframscript installation

Source: https://github.com/wolframresearch/agenttools/blob/main/AgentSkills/Skills/wolfram-paclets/references/GetWolframEngine.md

Execute a simple command to confirm that wolframscript is correctly installed and accessible in the terminal.

```bash
wolframscript -code '1+1'
```

--------------------------------

### Markdown Example Grouping

Source: https://github.com/wolframresearch/agenttools/blob/main/Specs/PacletDocumentationTools.md

Shows how to separate independent code examples in markdown using horizontal rules.

```markdown
Add one to a number:

```wl
MyFunction[5]
```

---

Add one to a symbol:

```wl
MyFunction[x]
```
```

--------------------------------

### Initialize Application and Host Context

Source: https://github.com/wolframresearch/agenttools/blob/main/Assets/Apps/wolframalpha-viewer.html

Sends an initialization request to the host, specifying protocol version and app capabilities, and applies the initial theme from the host context.

```javascript
sendRequest("ui/initialize", { protocolVersion: "2026-01-26", appInfo: { name: "wolframalpha-viewer", version: "2.0.0" }, appCapabilities: { availableDisplayModes: ["inline"], tools: { listChanged: false } } }).then(function(result) { sendNotification("ui/notifications/initialized"); setupAutoResize(); if (result) { applyTheme(result.hostContext || result.context || result); } }).catch(function(err) { showError("Failed to initialize: " + ((err && err.message) || String(err))); }); })();
```

--------------------------------

### List Available MCPServerObjects

Source: https://context7.com/wolframresearch/agenttools/llms.txt

Lists all available MCPServerObjects, including both file-based and paclet-backed servers. Use 'IncludeBuiltIn -> True' to also list built-in servers.

```wl
(* List all server objects (file-based and paclet-backed) *)
MCPServerObjects[]
(* Out: {MCPServerObject["MyServer"], MCPServerObject["PublisherID/MyPaclet/CustomServer"]} *)

(* Include built-in servers *)
MCPServerObjects["IncludeBuiltIn" -> True]
```

--------------------------------

### Install MCP Server for Cursor

Source: https://github.com/wolframresearch/agenttools/blob/main/README.md

Installs an MCP server for use in the Cursor IDE. This command is specific to the Cursor client.

```wl
InstallMCPServer["Cursor"]
```

--------------------------------

### StartMCPServer Functionality

Source: https://github.com/wolframresearch/agenttools/blob/main/Specs/PacletExtension.md

Details the operations performed by StartMCPServer, including paclet installation, definition loading, initialization code execution, and LLMTool construction.

```APIDOC
## StartMCPServer

At start time, all paclet tool and prompt references are fully resolved: definition files are loaded, `Initialization` code is executed, and `LLMTool` objects are constructed. This is the **Execution** trust level. Referenced paclets are automatically installed via `PacletInstall` if not already present.

`StartMCPServer` is responsible for:

1. Installing any referenced paclets that are not yet locally available.
2. Loading definition files for all paclet-qualified tool and prompt strings.
3. Running `"Initialization"` code from paclet server definitions and from all tool definitions.
4. Constructing `LLMTool` objects from association-form definitions and assembling prompt data.
5. Disambiguating MCP name collisions by appending numeric suffixes.

**Behavioral change — start-time initialization:** Tool `"Initialization"` code is executed at server startup by `StartMCPServer`, ensuring initialization runs even when a server is started without a preceding `InstallMCPServer` call. Install-time initialization in `InstallMCPServer` is retained as an early validation step.
```

--------------------------------

### Install WolframLanguage MCP Server

Source: https://github.com/wolframresearch/agenttools/blob/main/docs/servers.md

Installs the WolframLanguage server for development tasks, including notebook support and code inspection.

```wl
InstallMCPServer["ClaudeCode", "WolframLanguage"]
```

--------------------------------

### Server Initialization Code

Source: https://github.com/wolframresearch/agenttools/blob/main/docs/paclet-extensions.md

Demonstrates how to include initialization code in server definitions that runs at server start time using `RuleDelayed`.

```APIDOC
## Server Initialization

Paclet servers can include initialization code that runs at server start time:

```wl
<|
    "Initialization" :> Needs["PublisherID`MyPaclet`"],
    ...
|>
```

Use `RuleDelayed` (`:>`) so the initialization code is evaluated dynamically when the server starts, not when the definition file is loaded.
```

--------------------------------

### Install WolframAlpha MCP Server

Source: https://github.com/wolframresearch/agenttools/blob/main/docs/servers.md

Installs the WolframAlpha server for natural language queries without code execution capabilities.

```wl
InstallMCPServer["ClaudeDesktop", "WolframAlpha"]
```

--------------------------------

### Example MCP Client Entry Structure

Source: https://github.com/wolframresearch/agenttools/blob/main/docs/mcp-clients.md

Define a new MCP client by adding an entry to the $supportedMCPClients association. This includes fields like DisplayName, Aliases, ConfigFormat, and InstallLocation.

```wl
"NewClient" -> <|
    "DisplayName"     -> "New Client",
    "Aliases"         -> { "NC" },
    "ConfigFormat"    -> "JSON",
    "ConfigKey"       -> { "mcpServers" },
    "URL"             -> "https://newclient.example.com",
    "ProjectPath"     -> { ".newclient.json" },
    "InstallLocation" -> <|
        "MacOSX"  :> { $HomeDirectory, ".newclient", "config.json" },
        "Windows" :> { $HomeDirectory, "AppData", "Roaming", "NewClient", "config.json" },
        "Unix"    :> { $HomeDirectory, ".config", "newclient", "config.json" }
    |>
|>
```

--------------------------------

### Append a Scope Example to Documentation

Source: https://github.com/wolframresearch/agenttools/blob/main/Specs/PacletDocumentationTools.md

Append an example demonstrating the scope of a function, such as its behavior with lists, to a specific section in the documentation.

```json
{
  "tool": "EditSymbolPacletDocumentationExamples",
  "parameters": {
    "notebook": "/path/to/MyPaclet/Documentation/English/ReferencePages/Symbols/AddOne.nb",
    "operation": "appendExample",
    "section": "Scope",
    "content": "AddOne works on lists:\n\n```wl\nAddOne[{1, 2, 3}]\n```"
  }
}
```

--------------------------------

### Create Custom MCP Server

Source: https://github.com/wolframresearch/agenttools/blob/main/docs/tools.md

Instantiate a custom server referencing specific tools by name.

```wl
CreateMCPServer[ "MyServer", <|
    "Tools" -> { "WolframLanguageEvaluator", "WolframAlpha" }
|> ]
```

--------------------------------

### Install Specific MCP Server Type

Source: https://github.com/wolframresearch/agenttools/blob/main/README.md

Installs a specific type of MCP server, such as the Wolfram Language evaluator, for a given client.

```wl
InstallMCPServer["ClaudeDesktop", "WolframLanguage"]
```

--------------------------------

### Install and Load AgentTools Paclet

Source: https://context7.com/wolframresearch/agenttools/llms.txt

Installs the AgentTools paclet from the Wolfram Paclet Repository and loads it into your Wolfram Language session.

```Wolfram Language
(* Install the paclet *)
PacletInstall["Wolfram/AgentTools"]

(* Load the package *)
Needs["Wolfram`AgentTools`"]
```

--------------------------------

### Setup Auto-Resize

Source: https://github.com/wolframresearch/agenttools/blob/main/Assets/Apps/notebook-viewer.html

Sets up a ResizeObserver to monitor the size of the application root element and send size change notifications to the parent window. Requires ResizeObserver to be available.

```javascript
function setupAutoResize() {
  if (typeof ResizeObserver === "undefined") return;
  var appRoot = document.getElementById("app-root");
  var observer = new ResizeObserver(function() {
    var width = appRoot.scrollWidth;
    var height = appRoot.scrollHeight;
    sendNotification("ui/notifications/size-changed", {
      width: width,
      height: height
    });
  });
  observer.observe(appRoot);
}
```

--------------------------------

### Install WolframLanguage Server for Zed

Source: https://github.com/wolframresearch/agenttools/blob/main/docs/quickstart-coding.md

Installs the WolframLanguage MCP server for use with Zed. This enables Zed to interact with the Wolfram Language.

```wl
InstallMCPServer["Zed", "WolframLanguage"]
```

--------------------------------

### Install WolframLanguage Server for Goose

Source: https://github.com/wolframresearch/agenttools/blob/main/docs/quickstart-coding.md

Installs the WolframLanguage MCP server for use with Goose. This enables Goose to interact with the Wolfram Language.

```wl
InstallMCPServer["Goose", "WolframLanguage"]
```
Tokens:
Raw