You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: .claude-plugin/marketplace.json
+3-3Lines changed: 3 additions & 3 deletions
Original file line number
Diff line number
Diff line change
@@ -43,7 +43,7 @@
43
43
},
44
44
{
45
45
"name": "matlab-core",
46
-
"version": "0.3.0",
46
+
"version": "0.3.1",
47
47
"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.",
48
48
"author": {
49
49
"name": "MathWorks"
@@ -114,7 +114,7 @@
114
114
},
115
115
{
116
116
"name": "signal-processing",
117
-
"version": "0.1.0",
117
+
"version": "0.1.1",
118
118
"description": "Signal processing skills for AI coding agents. Signal Processing Toolbox, DSP System Toolbox, Audio Toolbox, and Wavelet Toolbox.",
119
119
"author": {
120
120
"name": "MathWorks"
@@ -133,7 +133,7 @@
133
133
},
134
134
{
135
135
"name": "toolkit",
136
-
"version": "0.2.3",
136
+
"version": "0.2.4",
137
137
"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.",
Copy file name to clipboardExpand all lines: GETTING_STARTED.md
+15-14Lines changed: 15 additions & 14 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -33,7 +33,7 @@ Full setup clones the toolkit repository, then uses your agent to automate the e
33
33
34
34
### What Setup Does
35
35
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/`
37
37
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)
38
38
3.**Registers skills** — adds MATLAB skills via the platform's native plugin system or global skill links
39
39
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
192
192
193
193
### 2. Install the binary
194
194
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:
> **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
329
330
| Problem | Likely Cause | Fix |
330
331
|---------|-------------|-----|
331
332
| 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 |
333
334
| macOS blocks the MCP server binary | Gatekeeper quarantine | Setup handles this automatically. If still blocked (MDM), go to System Settings > Privacy & Security > Allow Anyway |
334
335
| 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`|
336
337
|`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 |
337
338
| 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`|
338
339
| Simulink fails in Codex on Windows | Missing `WINDIR` environment variable | Add `env_vars = ['WINDIR']` to `[mcp_servers.matlab]` in `~/.codex/config.toml`|
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
5
-
6
4
1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
7
-
8
5
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.
12
7
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.
Copy file name to clipboardExpand all lines: README.md
+25-13Lines changed: 25 additions & 13 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,5 +1,5 @@
1
-
# MATLAB® 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® Agentic Toolkit brings trusted MATLAB capabilities to AI agents, making engineering and scientific workflows agent-ready.
3
3
4
4
## What It Does
5
5
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
9
9
The toolkit works with today's leading AI coding agents and is designed to evolve as the landscape changes.
10
10
11
11
> [!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®, 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.
13
13
14
14
## How It Works
15
15
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
69
69
70
70
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.
71
71
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
+
72
87
### Verify
73
88
Ask your agent:
74
89
@@ -113,22 +128,19 @@ Skills are organized in the [skills catalog](skills-catalog/).
113
128
114
129
<!-- END SKILLS -->
115
130
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
-
119
131
## Contributing
120
132
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.
121
133
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).
124
136
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.
127
139
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.
130
141
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.
Copy file name to clipboardExpand all lines: SUPPORT.md
+3-17Lines changed: 3 additions & 17 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,27 +2,13 @@
2
2
3
3
## Getting Help
4
4
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).
6
6
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.
22
8
23
9
## Before You File an Issue
24
10
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.
26
12
- Search [existing issues](https://github.com/matlab/matlab-agentic-toolkit/issues) to see if your question or bug has already been reported.
0 commit comments