Available Tools
Your assistant lists the tools automatically. Some clients show the tool names with the server name in front, for example mcp__sesam__workspace__list_scenarios.
Workspace
| Tool | What it does |
|---|---|
workspace__list_projects |
Lists your projects. |
workspace__create_project |
Creates a project with a name and an optional comment. |
workspace__remove_project |
Deletes a project and all scenarios in it. |
workspace__list_scenarios |
Lists your scenarios. Can be limited to scenarios whose name contains a text or to one project. |
workspace__get_scenario |
Shows the details of a scenario: size, coordinate system, traffic demand, vehicle types and log. |
workspace__update_scenario |
Changes the name or the comment of a scenario, moves it into a project or takes it out of a project. |
workspace__duplicate_scenario |
Creates a copy of a scenario, without its simulations. |
workspace__export_scenario_zip |
Exports a scenario as a ZIP archive and returns a download link. |
workspace__upload_scenario |
Creates a scenario from a SUMO scenario ZIP archive that is available at a public https link. |
workspace__remove_scenario |
Deletes a scenario and all simulations based on it. |
Builder
| Tool | What it does |
|---|---|
builder__build_custom_scenario |
Builds a new scenario for a geographic area, optionally with random traffic and traffic flows, and waits until it is ready. |
Account
| Tool | What it does |
|---|---|
accounts__get_plan_and_usage |
Shows your plan, its limits (for example scenario area, upload size) and your remaining quota. |
Good to know
Deleting needs confirmation
Removing a project or a scenario that contains data deletes everything in it permanently. The tools refuse to do this unless the assistant explicitly confirms it. Most assistants additionally ask you before they run such a tool. Read the request carefully before you approve it.
Plan and limits
MCP uses the same limits as the web interface and the REST API. Builds, uploads and ZIP downloads count against your daily quota or may not be part of your plan. If SESAM refuses an action because of your plan, the assistant tells you so. You can ask it to show your plan and remaining quota (accounts__get_plan_and_usage).
Changing comments
workspace__update_scenario replaces the comment of a scenario. To add a sentence to an existing comment, the assistant first reads the current comment and then writes the combined text.
ZIP export
The export is created in the background and the assistant waits up to two minutes for it. You receive a download link that you open in your browser.
Warning
The download link is not protected by a login. Anyone who has the link can download the archive, so do not share it.
Uploading scenarios
workspace__upload_scenario does not transfer files from your computer. SESAM downloads the ZIP archive from a public https link that you provide, for example from a file hosting service. Links to private or internal addresses, links with a username and password, and files larger than your plan allows are rejected.
Optional settings are the scenario name and comment, the project, the begin time and duration, and whether the floating car data (FCD) output is disabled. For the simulation options the following values are allowed:
| Option | Allowed values (in seconds / meters) |
|---|---|
| Time step length | 0.1, 0.5, 1 (default: 0.5 and 1) |
| Lateral resolution | -1, 0.1, 0.4, 0.8, 1.6 (default: -1 and 1.6) |
A lateral resolution of -1 switches the sublane model off. See the Simulator for the meaning of these options.
Every upload attempt counts against your daily upload quota. The tool therefore checks your plan and the file size before it starts.
Waiting times
Building and uploading take some time. The assistant waits up to 10 minutes and shows the progress. If this time is exceeded, the process keeps running in SESAM and the scenario appears in your Workspace when it is finished.