Skip to content

Commit 8a2d96a

Browse files
author
Michelle Hirsch
committed
2026.05.06 release
1 parent c5d0c85 commit 8a2d96a

18 files changed

Lines changed: 325 additions & 257 deletions

File tree

.claude-plugin/marketplace.json

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@
4343
},
4444
{
4545
"name": "matlab-core",
46-
"version": "0.3.0",
46+
"version": "0.3.1",
4747
"description": "Foundational MATLAB skills for AI coding agents. Debugging, testing, code review, and Live Script creation. Every toolkit user needs these skills, and other plugins can assume they are available.",
4848
"author": {
4949
"name": "MathWorks"
@@ -114,7 +114,7 @@
114114
},
115115
{
116116
"name": "signal-processing",
117-
"version": "0.1.0",
117+
"version": "0.1.1",
118118
"description": "Signal processing skills for AI coding agents. Signal Processing Toolbox, DSP System Toolbox, Audio Toolbox, and Wavelet Toolbox.",
119119
"author": {
120120
"name": "MathWorks"
@@ -133,7 +133,7 @@
133133
},
134134
{
135135
"name": "toolkit",
136-
"version": "0.2.3",
136+
"version": "0.2.4",
137137
"description": "Setup and management for the MATLAB Agentic Toolkit. Detects MATLAB, installs the MCP server, registers with your AI coding agent, and verifies the environment.",
138138
"author": {
139139
"name": "MathWorks"

.github/ISSUE_TEMPLATE/config.yml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Copyright 2026 The MathWorks, Inc.
22
blank_issues_enabled: false
33
contact_links:
4-
- name: General Inquiry
5-
url: mailto:genai-support@mathworks.com
6-
about: For general questions not covered by the templates above, email the GenAI support team.
4+
- name: Contact Technical Support
5+
url: https://www.mathworks.com/support/contact_us.html
6+
about: For general questions not covered by the templates above, contact MathWorks Technical Support.

.gitignore

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -182,3 +182,12 @@ builtin_blocks_*.json
182182
# Claude Code local settings (developer-specific, not for distribution)
183183
.claude/settings.local.json
184184
.mcp.json
185+
186+
# Skill qualification results (generated by qualify.sh, local-only)
187+
skills-catalog/skill-evals/*-workspace/
188+
skills-catalog/skill-evals/baselines/
189+
190+
# Skill eval ephemeral artifacts (generated during evaluation, not for distribution)
191+
**/evals/grading.json
192+
**/evals/timing.json
193+
**/evals/benchmark.json

GETTING_STARTED.md

Lines changed: 15 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,7 @@ Full setup clones the toolkit repository, then uses your agent to automate the e
3333

3434
### What Setup Does
3535

36-
1. **Installs the MCP server** — downloads the [MATLAB MCP Core Server](https://github.com/matlab/matlab-mcp-core-server) binary to `~/.local/bin/`
36+
1. **Installs the MCP server** — downloads the [MATLAB MCP Core Server](https://github.com/matlab/matlab-mcp-core-server) binary to `~/.matlab/agentic-toolkits/bin/`
3737
2. **Configures your agent** — connects the MCP server to your agent via global config, defaulting to the most recent MATLAB found (you can change this during setup)
3838
3. **Registers skills** — adds MATLAB skills via the platform's native plugin system or global skill links
3939
4. **Verifies** — confirms the MCP server can reach MATLAB and reports an environment summary
@@ -192,33 +192,34 @@ Go to the [MATLAB MCP Core Server releases](https://github.com/matlab/matlab-mcp
192192

193193
### 2. Install the binary
194194

195-
Place the downloaded binary in a directory on your PATH (e.g., `~/.local/bin/`), rename it to `matlab-mcp-core-server` (or `matlab-mcp-core-server.exe` on Windows), and make it executable:
195+
Place the downloaded binary in `~/.matlab/agentic-toolkits/bin/`, rename it to `matlab-mcp-core-server` (or `matlab-mcp-core-server.exe` on Windows), and make it executable:
196196

197197
**macOS:**
198198
```bash
199-
mkdir -p ~/.local/bin
200-
mv ~/Downloads/matlab-mcp-core-server-maca64 ~/.local/bin/matlab-mcp-core-server
201-
chmod +x ~/.local/bin/matlab-mcp-core-server
202-
xattr -d com.apple.quarantine ~/.local/bin/matlab-mcp-core-server 2>/dev/null
199+
mkdir -p ~/.matlab/agentic-toolkits/bin
200+
mv ~/Downloads/matlab-mcp-core-server-maca64 ~/.matlab/agentic-toolkits/bin/matlab-mcp-core-server
201+
chmod +x ~/.matlab/agentic-toolkits/bin/matlab-mcp-core-server
202+
xattr -d com.apple.quarantine ~/.matlab/agentic-toolkits/bin/matlab-mcp-core-server 2>/dev/null
203203
```
204204

205205
**Linux:**
206206
```bash
207-
mkdir -p ~/.local/bin
208-
mv ~/Downloads/matlab-mcp-core-server-glnxa64 ~/.local/bin/matlab-mcp-core-server
209-
chmod +x ~/.local/bin/matlab-mcp-core-server
207+
mkdir -p ~/.matlab/agentic-toolkits/bin
208+
mv ~/Downloads/matlab-mcp-core-server-glnxa64 ~/.matlab/agentic-toolkits/bin/matlab-mcp-core-server
209+
chmod +x ~/.matlab/agentic-toolkits/bin/matlab-mcp-core-server
210210
```
211211

212212
**Windows (PowerShell):**
213213
```powershell
214-
Move-Item ~\Downloads\matlab-mcp-core-server-win64.exe ~\.local\bin\matlab-mcp-core-server.exe
215-
Unblock-File -Path "$env:USERPROFILE\.local\bin\matlab-mcp-core-server.exe"
214+
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.matlab\agentic-toolkits\bin"
215+
Move-Item ~\Downloads\matlab-mcp-core-server-win64.exe ~\.matlab\agentic-toolkits\bin\matlab-mcp-core-server.exe
216+
Unblock-File -Path "$env:USERPROFILE\.matlab\agentic-toolkits\bin\matlab-mcp-core-server.exe"
216217
```
217218

218219
### 3. Verify the binary runs
219220

220221
```bash
221-
~/.local/bin/matlab-mcp-core-server --version
222+
~/.matlab/agentic-toolkits/bin/matlab-mcp-core-server --version
222223
```
223224

224225
> **macOS note:** If macOS blocks the binary (Gatekeeper), go to **System Settings > Privacy & Security** and click **"Allow Anyway"** next to the blocked binary.
@@ -329,10 +330,10 @@ Then edit `.vscode/mcp.json` to replace the placeholder paths with your actual M
329330
| Problem | Likely Cause | Fix |
330331
|---------|-------------|-----|
331332
| Setup can't find MATLAB | Non-standard install location | Provide the path when prompted |
332-
| MCP server download fails | Network/proxy/firewall | Download manually from [GitHub releases](https://github.com/matlab/matlab-mcp-core-server/releases), place in `~/.local/bin/`, re-run setup |
333+
| MCP server download fails | Network/proxy/firewall | Download manually from [GitHub releases](https://github.com/matlab/matlab-mcp-core-server/releases), place in `~/.matlab/agentic-toolkits/bin/`, re-run setup |
333334
| macOS blocks the MCP server binary | Gatekeeper quarantine | Setup handles this automatically. If still blocked (MDM), go to System Settings > Privacy & Security > Allow Anyway |
334335
| Agent doesn't list MATLAB skills | Plugin not installed or skills not linked | Re-run setup; for Claude Code, try `claude plugin install matlab-core@matlab-agentic-toolkit` |
335-
| MCP tools fail to connect | MCP server binary missing or wrong path in configuration | Re-run setup to regenerate configuration. Verify binary exists: `~/.local/bin/matlab-mcp-core-server --version` |
336+
| MCP tools fail to connect | MCP server binary missing or wrong path in configuration | Re-run setup to regenerate configuration. Verify binary exists: `~/.matlab/agentic-toolkits/bin/matlab-mcp-core-server --version` |
336337
| `evaluate_matlab_code` returns errors | Wrong `--matlab-root` path, license issue, or MATLAB startup failure | Verify MATLAB can start: `<matlab-root>/bin/matlab -nodesktop -r "disp('ok'),quit"`. Check license status. Re-run setup to correct the MATLAB root path |
337338
| Codex tool calls time out | Default tool timeout too short for MATLAB | Add `tool_timeout_sec = 600` (or higher) to `[mcp_servers.matlab]` in `~/.codex/config.toml` |
338339
| Simulink fails in Codex on Windows | Missing `WINDIR` environment variable | Add `env_vars = ['WINDIR']` to `[mcp_servers.matlab]` in `~/.codex/config.toml` |

LICENSE.md

Lines changed: 1 addition & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,7 @@
11
Copyright 2026 The MathWorks, Inc.
22
All rights reserved.
3-
43
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
5-
64
1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
7-
85
2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
9-
10-
3. In all cases, the software is, and all modifications and derivatives of the software shall be, licensed to you solely for use in conjunction with MathWorks products and service offerings.
11-
6+
3. In all cases, the software is, and all modifications and derivatives of the software shall be, licensed to you solely for use in conjunction with MathWorks products and service offerings.
127
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

README.md

Lines changed: 25 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
1-
# MATLAB&reg; Agentic Toolkit
2-
The MATLAB Agentic Toolkit brings trusted MATLAB capabilities to AI agents, making engineering and scientific workflows agent-ready.
1+
# MATLAB Agentic Toolkit
2+
The MATLAB&reg; Agentic Toolkit brings trusted MATLAB capabilities to AI agents, making engineering and scientific workflows agent-ready.
33

44
## What It Does
55
AI coding agents are increasingly capable with MATLAB — but capability isn't expertise. Without guidance, agents reinvent what toolbox functions already provide, miss features they don't know about, and burn through extra steps that an experienced MATLAB user would skip. The MATLAB Agentic Toolkit gives your agent the knowledge and context to work efficiently from the start.
@@ -9,7 +9,7 @@ The toolkit connects your AI agent to MATLAB and equips it with expert knowledge
99
The toolkit works with today's leading AI coding agents and is designed to evolve as the landscape changes.
1010

1111
> [!IMPORTANT]
12-
> To use AI agents with Simulink, install the [Simulink Agentic Toolkit](https://github.com/matlab/simulink-agentic-toolkit).
12+
> To use AI agents with Simulink&reg;, install the [Simulink Agentic Toolkit](https://github.com/matlab/simulink-agentic-toolkit). If you plan to use both toolkits, consider the [alternative installer](#alternative-installer) — it sets up both in one step.
1313
1414
## How It Works
1515
The toolkit has two jobs. First, it gives your agent a live connection to MATLAB — so it can run code, execute tests, and analyze results, not just read and write files. Second, it provides curated expertise (called *skills*) that teach your agent how an experienced MATLAB engineer would approach a task. Your agent reads the relevant skill, then uses the MATLAB connection to do the work.
@@ -69,6 +69,21 @@ Setup looks for your MATLAB installation(s), downloads the MCP server, writes yo
6969
7070
If you installed the [MATLAB MCP Core Server](https://github.com/matlab/matlab-mcp-core-server) yourself, you just need skills. See [Adding Skills Only](GETTING_STARTED.md#adding-skills-only) in the Getting Started guide.
7171
72+
<a id="alternative-installer"></a>
73+
### Alternative Installer (experimental)
74+
75+
The Simulink Agentic Toolkit provides a MATLAB-based installer that can install and configure both toolkits. This installer offers several benefits over the current `matlab-agentic-toolkit-setup` skill:
76+
* It can install both the MATLAB and Simulink Agentic Toolkits. It is recommended for users who would like to use both
77+
* It supports the MATLAB MCP Core Server option to connect to an existing MATLAB session (`--matlab-session-mode=existing`)
78+
* It provides the option to configure your agent to use the toolkits for individual projects, not just globally
79+
* This installer does not consume agent tokens
80+
81+
The tradeoff is that it is newer and less thoroughly tested than the agent-driven setup above.
82+
83+
1. Download `agenticToolkitInstaller.mltbx` from the [Simulink Agentic Toolkit releases page](https://github.com/matlab/simulink-agentic-toolkit/releases).
84+
2. Open the downloaded file to install the installer add-on.
85+
3. In MATLAB, run: `setupAgenticToolkit`
86+
7287
### Verify
7388
Ask your agent:
7489
@@ -113,22 +128,19 @@ Skills are organized in the [skills catalog](skills-catalog/).
113128

114129
<!-- END SKILLS -->
115130

116-
## Trademarks
117-
MATLAB and Simulink are registered trademarks of The MathWorks, Inc. See [mathworks.com/trademarks](https://www.mathworks.com/trademarks) for a list of additional trademarks. Other product or brand names may be trademarks or registered trademarks of their respective holders.
118-
119131
## Contributing
120132
We welcome feedback through [GitHub Issues](https://github.com/matlab/matlab-agentic-toolkit/issues). Pull requests are reviewed for ideas and feedback but are not merged from external contributors. See [CONTRIBUTING.md](CONTRIBUTING.md) for details.
121133

122-
## Licensing and Usage
123-
The MATLAB Agentic Toolkit is licensed with [MathWorks BSD-3 Clause](LICENSE.md). It is solely for use in conjunction with MathWorks products and service offerings.
134+
## Security Considerations
135+
When using the MATLAB Agentic Toolkit and MATLAB MCP Core Server, you should thoroughly review and validate all tool calls before you run them. Always keep a human in the loop for important actions and only proceed once you are confident the call will do exactly what you expect. For more information, see [User Interaction Model (MCP)](https://modelcontextprotocol.io/specification/2025-06-18/server/tools#user-interaction-model) and [Security Considerations (MCP)](https://modelcontextprotocol.io/specification/2025-06-18/server/tools#security-considerations).
124136

125-
## Contact Support
126-
MathWorks encourages you to use this repository and provide feedback. To request technical support or submit an enhancement request, [create a GitHub issue](https://github.com/matlab/matlab-agentic-toolkit/issues) or email [genai-support@mathworks.com](mailto:genai-support@mathworks.com). For MATLAB MCP Core Server issues and support, see the [MATLAB MCP Core Server](https://github.com/matlab/matlab-mcp-core-server) repository.
137+
## Licensing and Usage
138+
The license is available in the [LICENSE.md](LICENSE.md) file in this GitHub repository.
127139

128-
#
129-
When using the MATLAB Agentic Toolkit and MATLAB MCP Core Server, you should thoroughly review and validate all tool calls before you run them. Always keep a human in the loop for important actions and only proceed once you are confident the call will do exactly what you expect. For more information, see [User Interaction Model (MCP)](https://modelcontextprotocol.io/specification/2025-06-18/server/tools#user-interaction-model) and [Security Considerations (MCP)](https://modelcontextprotocol.io/specification/2025-06-18/server/tools#security-considerations).
140+
MCP servers are only permitted to be used with MATLAB in accordance with the MathWorks Software License Agreement, and must not be shared by multiple users. Contact MathWorks if you need to support shared or centralized server use.
130141

131-
The MATLAB MCP Core server may only be used with MATLAB installations that are used as a Personal Automation Server. Use with a central Automation Server is not allowed. Please contact MathWorks if Automation Server use is required. For more information see the [Program Offering Guide (MathWorks)](https://www.mathworks.com/help//pdf_doc/offering/offering.pdf).
142+
## Contact Support
143+
MathWorks encourages you to use this repository and provide feedback. To request technical support or submit an enhancement request, [create a GitHub issue](https://github.com/matlab/matlab-agentic-toolkit/issues) or [contact technical support](https://www.mathworks.com/support/contact_us.html). For MATLAB MCP Core Server issues and support, see the [MATLAB MCP Core Server](https://github.com/matlab/matlab-mcp-core-server) repository.
132144

133145
----
134146

SUPPORT.md

Lines changed: 3 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -2,27 +2,13 @@
22

33
## Getting Help
44

5-
If you need help with the MATLAB Agentic Toolkit, here are the best ways to get support:
5+
To request technical support or submit an enhancement request, [create a GitHub issue](https://github.com/matlab/matlab-agentic-toolkit/issues) or [contact MathWorks Technical Support](https://www.mathworks.com/support/contact_us.html).
66

7-
### GitHub Issues
8-
9-
Use [GitHub Issues](https://github.com/matlab/matlab-agentic-toolkit/issues/new/choose) to report bugs, request enhancements, or ask questions. Issue templates are provided to help you include the right details.
10-
11-
- **Bug Report** — Something is not working as expected
12-
- **Enhancement Request** — Suggest a new feature or improvement
13-
- **Question** — Setup, compatibility, or usage questions
14-
15-
### Email
16-
17-
For general inquiries, contact the GenAI support team at [genai-support@mathworks.com](mailto:genai-support@mathworks.com).
18-
19-
## Response Times
20-
21-
We aim to acknowledge new issues within **2 business days** and apply triage labels within **5 business days**. We do not commit to specific fix timelines for individual issues.
7+
For MATLAB MCP Core Server issues, see the [MATLAB MCP Core Server](https://github.com/matlab/matlab-mcp-core-server) repository.
228

239
## Before You File an Issue
2410

25-
- Check the [Getting Started](https://github.com/matlab/matlab-agentic-toolkit#getting-started) guide for setup and usage instructions.
11+
- Check the [Getting Started](https://github.com/matlab/matlab-agentic-toolkit/blob/main/GETTING_STARTED.md) guide for setup and usage instructions.
2612
- Search [existing issues](https://github.com/matlab/matlab-agentic-toolkit/issues) to see if your question or bug has already been reported.
2713

2814
----

0 commit comments

Comments
 (0)