WOLFRAM

Wolfram Language & System Documentation Center

InstallMCPServer["application"]

installs a predefined Wolfram MCP server for the specified application.

InstallMCPServer["application",server]

installs the MCPServerObject specified by server.

InstallMCPServer[File[…],server]

installs the MCP server to the specified file.

InstallMCPServer[{"application",directory},server]

installs the MCP server for a project contained in directory.

Details
Details and Options Details and Options
Examples  
Basic Examples  
Scope  
Generalizations & Extensions  
Options  
ApplicationName  
EnableMCPApps  
ProcessEnvironment  
ToolOptions  
Possible Issues  
See Also
Wolfram`AgentTools`
Wolfram`AgentTools`

InstallMCPServer

InstallMCPServer["application"]

installs a predefined Wolfram MCP server for the specified application.

InstallMCPServer["application",server]

installs the MCPServerObject specified by server.

InstallMCPServer[File[…],server]

installs the MCP server to the specified file.

InstallMCPServer[{"application",directory},server]

installs the MCP server for a project contained in directory.

Details

  • The value for server can be one of the following:
  • "name"the name of an existing MCPServerObject
    <|…|>an association corresponding to an LLMConfiguration
    LLMConfiguration[…]an LLMConfiguration
    MCPServerObject[…]an MCPServerObject
  • Some predefined MCP servers that can be specified by name are:
  • "WolframAlpha"an MCP server that is optimized for retrieving information from Wolfram|Alpha
    "WolframLanguage"an MCP server that is optimized for writing and evaluating Wolfram Language code
    "Wolfram"a blend of Wolfram|Alpha and Wolfram Language functionality
  • Additionally, any other MCP servers you have created with CreateMCPServer can be referenced by name.
  • Some possible values for "application" are:
  • "ClaudeCode"Claude Code
    "ClaudeDesktop"Claude Desktop
    "Codex"Codex
    "CopilotCLI"GitHub Copilot CLI
    "Cursor"Cursor
    "GeminiCLI"Gemini CLI
    "OpenCode"OpenCode
    "VisualStudioCode"Visual Studio Code
  • InstallMCPServer[{"application",directory},server] is used for applications that support directory-based projects, such as "ClaudeCode" and "OpenCode".
  • InstallMCPServer accepts the following options:
  • ApplicationNameAutomaticspecify the application name when installing to a file
    EnableMCPAppsTruewhether to enable MCP Apps support
    ProcessEnvironmentAutomaticadditional environment variables to supply
    ToolOptions options to customize behavior of default tools
  • The value given for ToolOptions should be an association with keys that correspond to default tool names, and values specified as an association of tool options.
  • Evaluate $DefaultMCPToolOptions to get the full set of available options and their default values.

Examples

open all close all
Wolfram Language code: Needs["Wolfram`AgentTools`"]

Basic Examples  (1)

Install the default MCP server for Claude Desktop:

Wolfram Language code: InstallMCPServer["ClaudeDesktop"]

Uninstall it:

Wolfram Language code: UninstallMCPServer["ClaudeDesktop"]

Scope  (4)

Install a Wolfram|Alpha-specific MCP server:

Wolfram Language code: InstallMCPServer["ClaudeDesktop", "WolframAlpha"]

Uninstall it:

Wolfram Language code: UninstallMCPServer["ClaudeDesktop", "WolframAlpha"]

Install a Wolfram Language MCP server for Cursor:

Wolfram Language code: InstallMCPServer["Cursor", "WolframLanguage"]

The installed MCP server:

Wolfram Language code: %["MCPServerObject"]

The tools available to the server:

Wolfram Language code: %["Tools"]

Uninstall:

Wolfram Language code: UninstallMCPServer["Cursor", "WolframLanguage"]

Install a custom MCP server defined by an LLMConfiguration:

Wolfram Language code: config = LLMConfiguration[<|"Tools" -> {LLMTool["PrimeFinder", {"n" -> "Integer"}, Prime[#n]&]}|>]
Wolfram Language code: server = CreateMCPServer["My MCP Server", config]
Wolfram Language code: InstallMCPServer["ClaudeDesktop", server]

Deleting an MCP server automatically uninstalls it:

Wolfram Language code: DeleteObject[server]

Install an MCP server for a specific OpenCode project directory:

Wolfram Language code: InstallMCPServer[{"OpenCode", File["MCPServer"]}, "WolframLanguage"]

Use the same pattern to uninstall it:

Wolfram Language code: UninstallMCPServer[{"OpenCode", File["MCPServer"]}, "WolframLanguage"]

Generalizations & Extensions  (1)

Using a named application for the first argument is a convenient shortcut for specifying the proper configuration file:

Wolfram Language code: installed = InstallMCPServer["Cursor", "WolframLanguage"]

Using a named application chooses an appropriate configuration file based on the current operating system:

Wolfram Language code: location = installed["Location"]
Wolfram Language code: UninstallMCPServer["Cursor", "WolframLanguage"]

This is equivalent to InstallMCPServer["Cursor", "WolframLanguage"]:

Wolfram Language code: InstallMCPServer[location, "WolframLanguage"]

View the configuration file:

Wolfram Language code: FilePrint[location]

UninstallMCPServer removes the appropriate entry:

Wolfram Language code: UninstallMCPServer["Cursor", "WolframLanguage"]
Wolfram Language code: FilePrint[location]

Options  (6)

ApplicationName  (2)

Specify the application when installing to a specific file:

Wolfram Language code: InstallMCPServer[File[FileNameJoin[{$TemporaryDirectory, CreateUUID[]}]], "ApplicationName" -> "OpenCode"]
Wolfram Language code: FilePrint[%["Location"]]

Specifying a different application name can imply a different configuration format:

Wolfram Language code: InstallMCPServer[File[FileNameJoin[{$TemporaryDirectory, CreateUUID[]}]], "ApplicationName" -> "Codex"]
Wolfram Language code: FilePrint[%["Location"]]

EnableMCPApps  (1)

In applications that support the MCP Apps extension, some tool calls will have rich interactive formatting:

Wolfram Language code: [image]

To disable this feature, set EnableMCPApps to False:

Wolfram Language code: InstallMCPServer["ClaudeDesktop", "EnableMCPApps" -> False]

When disabled, the outputs of tool calls may be hidden by default, depending on the application:

Wolfram Language code: [image]
Wolfram Language code: [image]

ProcessEnvironment  (1)

Customize the environment variables that should be passed to the MCP server:

Wolfram Language code: installed = InstallMCPServer["ClaudeDesktop", ProcessEnvironment -> <|"MY_VARIABLE" -> 1337|>]

View the configuration file:

Wolfram Language code: FilePrint[installed["Location"]]
Wolfram Language code: UninstallMCPServer["ClaudeDesktop", "Wolfram"]

ToolOptions  (2)

Use a separate sandboxed local kernel for the WolframLanguageEvaluatorTool:

Wolfram Language code: InstallMCPServer["Claude", "Wolfram", "ToolOptions" -> <|"WolframLanguageEvaluator" -> <|"Method" -> "Local"|>|>]

Get all the available options and their default values for built-in tools with $DefaultMCPToolOptions:

Wolfram Language code: $DefaultMCPToolOptions

Possible Issues  (1)

If the target JSON configuration file contains comments, installation will fail:

Wolfram Language code: InstallMCPServer["Cursor", "WolframLanguage"]
Wolfram Language code: FilePrint[File["C:/Users/rhennigan/.cursor/mcp.json"]]

To work around this, you can copy the relevant part of the JSON configuration for an MCP server and manually insert it:

Wolfram Language code: MCPServerObject["WolframLanguage"]["JSONConfiguration"]
Wolfram Language code: FilePrint[File["C:/Users/rhennigan/.cursor/mcp.json"]]