RustGIS
RustGIS is a desktop and browser GIS with an accompanying
rustgis-cli. The CLI exposes MCP tools over standard input/output. Choose
which project the user wants to operate on before starting the server.
Choose the session
| User's goal |
Entry point |
| Install RustGIS or make its CLI available to the agent |
Read install-from-agent; detect the user's platform, install the app and CLI, verify the CLI, then register MCP. |
| Manage the map already open in the desktop app |
Start MCP Relay in the app's Command Search (Ctrl+K), confirm 127.0.0.1:8767, then register rustgis-cli mcp --attach. |
| Work in a separate headless project |
Register rustgis-cli mcp --sample, --project file.rgis, or repeatable --data file.geojson. This is the agent's own project, not the desktop app. |
| Use the browser app |
Open https://web.rustgis.app. The desktop loopback relay is not a browser-management interface. |
For the open app, --attach is mandatory. Do not silently fall back to a
private project if the relay is unavailable. Do not combine --attach with
--sample, --project or --data; the CLI rejects that combination.
Connect to the open desktop app
Ensure the app and rustgis-cli are installed on the user's machine. Use the
install reference to resolve PATH and MCP client configuration.
In the open RustGIS desktop app, ask the user to tick Let your Agents
Control RustGIS in the AI Assistant's settings (it also lets attached
agents use files and the network), or open Command Search (Ctrl+K) and run
MCP Relay (ui.mcpRelay). Confirm the status bar says
MCP relay listening on 127.0.0.1:8767. The listener is off until started
and remains active until the app closes.
Register the attached server in the agent, for example:
claude mcp add rustgis-app -- rustgis-cli mcp --attach
# Or:
codex mcp add rustgis-app -- rustgis-cli mcp --attach
The MCP client launches the stdio process; do not start a separate HTTP
server. Add --yes only when the user's task authorizes file/network access.
Call list_layers and view_map to establish that this is the user's open
map before changing it. If connection fails, check that the app is still
open, MCP Relay is active, and the selected port matches. Do not claim
remote management from an unattached session.
The agent process must run on the same machine as the desktop app: the relay
binds only to 127.0.0.1. Remote management here means an external agent
controlling that open app, not an exposed internet service. For a nondefault
port, start the app command with ui.mcpRelay {"port": 9000} and use
rustgis-cli mcp --attach 9000.
Operate through RustGIS's tools
- Inspect:
list_layers supplies layer names, fields, feature counts,
selections and the current view. Use read_features for attribute rows and
view_map for a PNG of the current map.
- Discover: use
search_commands before choosing a command id; use
search_tools and describe_tool before geoprocessing. Use search_docs
and read_doc for command details and workflows. Do not guess parameter
names or borrow tools from another GIS.
- Execute:
run_command runs a discovered command with JSON parameters;
run_tool runs a discovered geoprocessing tool and adds its output to the
map. Inspect returned layersAdded and notices, including ignored
parameters. Each command run is one undo step.
- Verify: inspect the resulting layers/attributes and call
view_map
again. For persistence, discover the save/export command and use the
user's destination. An in-memory edit is not evidence of a saved file.
Access and project boundaries
- File and network commands still require
--yes when attached, just as
in a private server, unless the user ticked Let your Agents Control
RustGIS, which allows them for attached agents. It also permits plugin commands and opening project
text, which can bring in web layers. Do not enable it to conceal a refusal.
- Plugin management, scripts, tasks, models and the GeoLibre runner are not
available through this MCP surface;
--yes does not unlock them.
- In attached mode, opening, replacing, undoing and saving act on the user's
open project. Inspect first and preserve their work; do not overwrite it
merely to create an example. In private mode, the project belongs to the
agent and stays in memory until saved.
view_map can fetch tiles for web tile layers already in the project.
Do not describe the default access policy as a complete offline guarantee.
Installation and client setup reference
Read references/install-from-agent.md for
agent-runnable platform detection, package-manager and checked release installs,
PATH confirmation, Claude/Codex/mcp.json/VS Code registration, and the attached
relay procedure. Canonical upstream documentation:
https://rustgis.app/installation/ and https://rustgis.app/mcp/.
1---2name: rustgis3description: |4 Use RustGIS from an agent: list layers, read features, view the map, run commands and geoprocessing, and save. Trigger for the already-open desktop app (MCP Relay, then rustgis-cli mcp --attach), a headless project, or rustgis-cli MCP in Claude, Codex, Cursor, or VS Code. Installing RustGIS is a trigger, not the task.5metadata:6 source: https://skillmd.com/skills/opengeos/rustgis7---89# RustGIS1011[RustGIS](https://rustgis.app) is a desktop and browser GIS with an accompanying12`rustgis-cli`. The CLI exposes MCP tools over standard input/output. Choose13which project the user wants to operate on **before** starting the server.1415## Choose the session1617| User's goal | Entry point |18| --- | --- |19| Install RustGIS or make its CLI available to the agent | Read [install-from-agent](references/install-from-agent.md); detect the user's platform, install the app and CLI, verify the CLI, then register MCP. |20| Manage the map already open in the desktop app | Start **MCP Relay** in the app's Command Search (Ctrl+K), confirm `127.0.0.1:8767`, then register `rustgis-cli mcp --attach`. |21| Work in a separate headless project | Register `rustgis-cli mcp --sample`, `--project file.rgis`, or repeatable `--data file.geojson`. This is the agent's own project, not the desktop app. |22| Use the browser app | Open <https://web.rustgis.app>. The desktop loopback relay is not a browser-management interface. |2324**For the open app, `--attach` is mandatory.** Do not silently fall back to a25private project if the relay is unavailable. Do not combine `--attach` with26`--sample`, `--project` or `--data`; the CLI rejects that combination.2728## Connect to the open desktop app29301. Ensure the app and `rustgis-cli` are installed on the user's machine. Use the31 install reference to resolve PATH and MCP client configuration.322. In the open RustGIS desktop app, ask the user to tick **Let your Agents33 Control RustGIS** in the AI Assistant's settings (it also lets attached34 agents use files and the network), or open Command Search (Ctrl+K) and run35 **MCP Relay** (`ui.mcpRelay`). Confirm the status bar says36 `MCP relay listening on 127.0.0.1:8767`. The listener is off until started37 and remains active until the app closes.383. Register the attached server in the agent, for example:3940 ```sh41 claude mcp add rustgis-app -- rustgis-cli mcp --attach42 # Or:43 codex mcp add rustgis-app -- rustgis-cli mcp --attach44 ```4546 The MCP client launches the stdio process; do not start a separate HTTP47 server. Add `--yes` only when the user's task authorizes file/network access.484. Call `list_layers` and `view_map` to establish that this is the user's open49 map before changing it. If connection fails, check that the app is still50 open, MCP Relay is active, and the selected port matches. Do not claim51 remote management from an unattached session.5253The agent process must run on the same machine as the desktop app: the relay54binds only to `127.0.0.1`. Remote management here means an external agent55controlling that open app, not an exposed internet service. For a nondefault56port, start the app command with `ui.mcpRelay {"port": 9000}` and use57`rustgis-cli mcp --attach 9000`.5859## Operate through RustGIS's tools60611. **Inspect:** `list_layers` supplies layer names, fields, feature counts,62 selections and the current view. Use `read_features` for attribute rows and63 `view_map` for a PNG of the current map.642. **Discover:** use `search_commands` before choosing a command id; use65 `search_tools` and `describe_tool` before geoprocessing. Use `search_docs`66 and `read_doc` for command details and workflows. Do not guess parameter67 names or borrow tools from another GIS.683. **Execute:** `run_command` runs a discovered command with JSON parameters;69 `run_tool` runs a discovered geoprocessing tool and adds its output to the70 map. Inspect returned `layersAdded` and `notices`, including ignored71 parameters. Each command run is one undo step.724. **Verify:** inspect the resulting layers/attributes and call `view_map`73 again. For persistence, discover the save/export command and use the74 user's destination. An in-memory edit is not evidence of a saved file.7576## Access and project boundaries7778- File and network commands **still require `--yes` when attached**, just as79 in a private server, unless the user ticked **Let your Agents Control80 RustGIS**, which allows them for attached agents. It also permits plugin commands and opening project81 text, which can bring in web layers. Do not enable it to conceal a refusal.82- Plugin management, scripts, tasks, models and the GeoLibre runner are not83 available through this MCP surface; `--yes` does not unlock them.84- In attached mode, opening, replacing, undoing and saving act on the user's85 open project. Inspect first and preserve their work; do not overwrite it86 merely to create an example. In private mode, the project belongs to the87 agent and stays in memory until saved.88- `view_map` can fetch tiles for web tile layers already in the project.89 Do not describe the default access policy as a complete offline guarantee.9091## Installation and client setup reference9293Read [references/install-from-agent.md](references/install-from-agent.md) for94agent-runnable platform detection, package-manager and checked release installs,95PATH confirmation, Claude/Codex/`mcp.json`/VS Code registration, and the attached96relay procedure. Canonical upstream documentation:97<https://rustgis.app/installation/> and <https://rustgis.app/mcp/>.