Content
# [Wolfram/MCPServer](https://paclets.com/Wolfram/MCPServer)
[](LICENSE)
[](https://www.wolfram.com/language/)
Implements a [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server using Wolfram Language, enabling LLMs to access Wolfram Language computation capabilities.
## Table of Contents
- [Features](#features)
- [Requirements](#requirements)
- [Installation](#installation)
- [Quick Start](#quick-start)
- [Predefined Servers](#predefined-servers)
- [Supported Clients](#supported-clients)
- [Available Tools](#available-tools)
- [Creating Custom Servers](#creating-custom-servers)
- [API Reference](#api-reference)
- [Development](#development)
- [License](#license)
## Features
- **Predefined servers** for common use cases (general computation, Wolfram\|Alpha queries, development)
- **Semantic search** across Wolfram documentation and Wolfram\|Alpha results
- **Code evaluation** with Wolfram Language directly in AI conversations
- **Notebook support** for reading and writing Wolfram notebooks
- **Custom servers** with tailored tools for specific needs
- **Wide client support** including Claude Desktop, Cursor, VS Code, and more
- **MCP prompts** for enhanced context and workflows
## Requirements
- Wolfram Language 14.2 or higher
- An MCP-compatible client application (see [Supported Clients](#supported-clients))
- Optional: [LLMKit subscription](https://www.wolfram.com/notebook-assistant-llm-kit) for enhanced semantic search capabilities
## Installation
### Install the Paclet
```wl
PacletInstall["Wolfram/MCPServer"]
```
### Load the Package
```wl
Needs["Wolfram`MCPServer`"]
```
## Quick Start
Install a Wolfram MCP server for Claude Desktop:
```wl
InstallMCPServer["ClaudeDesktop"]
(* Out: Success["InstallMCPServer", <|...|>] *)
```
After restarting Claude Desktop, it will have access to Wolfram knowledge and tools:
To install a specific server type:
```wl
InstallMCPServer["ClaudeDesktop", "WolframLanguage"]
```
To uninstall:
```wl
UninstallMCPServer["ClaudeDesktop"] (* Remove all servers *)
UninstallMCPServer["ClaudeDesktop", "Wolfram"] (* Remove specific server *)
```
## Predefined Servers
MCPServer includes four predefined server configurations, each optimized for different use cases:
| Server | Best For | Tools |
|--------|----------|-------|
| **Wolfram** (default) | General-purpose use combining computational power with natural language | `WolframContext`, `WolframLanguageEvaluator`, `WolframAlpha` |
| **WolframAlpha** | Natural language queries without code execution | `WolframAlphaContext`*, `WolframAlpha` |
| **WolframLanguage** | Wolfram Language development and learning | `WolframLanguageContext`, `WolframLanguageEvaluator`, `ReadNotebook`, `WriteNotebook`, `SymbolDefinition`, `CodeInspector`, `TestReport` |
| **WolframPacletDevelopment** | Developing and maintaining Wolfram paclets | All WolframLanguage tools plus documentation tools (`CreateSymbolDoc`, `EditSymbolDoc`, `EditSymbolDocExamples`) |
*\*Requires [LLMKit subscription](https://www.wolfram.com/notebook-assistant-llm-kit)*
Install a specific server:
```wl
InstallMCPServer["ClaudeDesktop", "WolframLanguage"]
```
See [docs/servers.md](docs/servers.md) for detailed information about each server and guidance on choosing the right one.
## Supported Clients
MCPServer can be installed into the following MCP client applications:
| Client | Name | Project Support |
|--------|------|-----------------|
| [Claude Code](https://code.claude.com) | `"ClaudeCode"` | Yes |
| [Claude Desktop](https://claude.ai/download) | `"ClaudeDesktop"` | No |
| [Cline](https://cline.bot) | `"Cline"` | No |
| [Copilot CLI](https://github.com/features/copilot/cli) | `"CopilotCLI"` | No |
| [Cursor](https://www.cursor.com) | `"Cursor"` | No |
| [Gemini CLI](https://github.com/google-gemini/gemini-cli) | `"GeminiCLI"` | No |
| [Google Antigravity](https://antigravity.google) | `"Antigravity"` | No |
| [OpenAI Codex](https://openai.com/codex) | `"Codex"` | No |
| [OpenCode](https://opencode.ai) | `"OpenCode"` | Yes |
| [Visual Studio Code](https://code.visualstudio.com) | `"VisualStudioCode"` | Yes |
| [Windsurf](https://codeium.com/windsurf) | `"Windsurf"` | No |
| [Zed](https://zed.dev) | `"Zed"` | Yes |
### Project-Level Installation
Clients with project support can have servers installed for specific projects:
```wl
InstallMCPServer[{"ClaudeCode", "/path/to/project"}, "WolframLanguage"]
```
### Claude Desktop
Claude Desktop offers an excellent integration experience with MCPServer, providing seamless access to Wolfram Language's computational capabilities.
### Cursor
Install an MCP server for use in Cursor:
```wl
InstallMCPServer["Cursor"]
(* Out: Success["InstallMCPServer", <|...|>] *)
```
Check the MCP tab in Cursor settings to verify the server connection:
Your Wolfram tools will now be available in Cursor agent chat:
### Other Clients
MCPServer works with any stdio-based MCP client. See [docs/mcp-clients.md](docs/mcp-clients.md) for manual configuration instructions.
## Available Tools
MCPServer provides a variety of tools organized by category:
### Context Tools (Semantic Search)
Search Wolfram resources using semantic similarity:
- **WolframContext** - Combines the functionality of `WolframLanguageContext` and `WolframAlphaContext` in a single tool
- **WolframAlphaContext** - Semantic search of Wolfram\|Alpha results (requires [LLMKit](https://www.wolfram.com/notebook-assistant-llm-kit))
- **WolframLanguageContext** - Semantic search of Wolfram Language documentation and other resources
> **Note:** Since `WolframContext` combines the other two, a server should only include one of these three tools. Without LLMKit, `WolframContext` is effectively the same as `WolframLanguageContext` since the Wolfram\|Alpha semantic search functionality is disabled.
Documentation search includes the [Function Repository](https://resources.wolframcloud.com/FunctionRepository), [Data Repository](https://datarepository.wolframcloud.com), [Neural Net Repository](https://resources.wolframcloud.com/NeuralNetRepository), [Paclet Repository](https://resources.wolframcloud.com/PacletRepository), and more.
While only `WolframAlphaContext` *requires* an [LLMKit subscription](https://www.wolfram.com/notebook-assistant-llm-kit), having LLMKit greatly improves search results for all context tools by enabling reranking and filtering.
### Code Execution Tools
- **WolframLanguageEvaluator** - Execute Wolfram Language code with time constraints
- **WolframAlpha** - Natural language queries to Wolfram\|Alpha
- **SymbolDefinition** - Retrieve symbol definitions in readable markdown format
### Notebook Tools
- **ReadNotebook** - Read Wolfram notebooks (.nb) as markdown text
- **WriteNotebook** - Convert markdown to Wolfram notebooks
### Testing Tools
- **TestReport** - Run Wolfram Language test files (.wlt) and return reports
### Code Analysis Tools
- **CodeInspector** - Inspect Wolfram Language code for issues and return formatted reports
### Documentation Tools (Paclet Development)
- **CreateSymbolDoc** - Create new symbol documentation pages
- **EditSymbolDoc** - Edit existing symbol documentation pages
- **EditSymbolDocExamples** - Edit example sections of documentation
See [docs/tools.md](docs/tools.md) for detailed information about each tool.
## Creating Custom Servers
Create custom MCP servers with your own tools using [LLMConfiguration](https://reference.wolfram.com/language/ref/LLMConfiguration.html):
```wl
config = LLMConfiguration[<|
"Tools" -> {LLMTool["PrimeFinder", {"n" -> "Integer"}, Prime[#n]&]}
|>];
server = CreateMCPServer["My MCP Server", config]
(* Out: MCPServerObject[...] *)
```
Install for use in Claude Desktop:
```wl
InstallMCPServer["ClaudeDesktop", server]
(* Out: Success["InstallMCPServer", <|...|>] *)
```
After restarting Claude Desktop, your custom tools will be available:
You can also mix predefined tools with custom tools:
```wl
CreateMCPServer["My MCP Server", <|
"Tools" -> {
"WolframLanguageEvaluator", (* Predefined tool *)
"WolframAlpha", (* Predefined tool *)
LLMTool["MyCustomTool", ...] (* Custom tool *)
}
|>];
```
## API Reference
### Core Functions
| Function | Description |
|----------|-------------|
| `CreateMCPServer[name, config]` | Create a custom MCP server |
| `InstallMCPServer[client]` | Install the default server for a client |
| `InstallMCPServer[client, server]` | Install a specific server for a client |
| `UninstallMCPServer[client]` | Remove all servers from a client |
| `UninstallMCPServer[client, name]` | Remove a specific server from a client |
### Server Objects
| Symbol | Description |
|--------|-------------|
| `MCPServerObject[...]` | Data structure representing an MCP server |
| `MCPServerObjectQ[expr]` | Test if an expression is a valid server object |
| `MCPServerObjects[]` | List all created server objects |
### Predefined Resources
| Symbol | Description |
|--------|-------------|
| `$DefaultMCPServers` | Association of predefined server configurations |
| `$DefaultMCPTools` | Association of available tool definitions |
| `$DefaultMCPPrompts` | Association of available prompt definitions |
## Development
See the [developer documentation](docs/README.md) for information on:
- [Getting started](docs/getting-started.md) with development
- [Writing and running tests](docs/testing.md)
- [Building the paclet](docs/building.md)
- [Adding new tools](docs/tools.md)
- [Error handling](docs/error-handling.md)
For AI agents working on this codebase, see [AGENTS.md](AGENTS.md).
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## Author
Richard Hennigan (Wolfram Research)
