How do I
how_do_iMap a natural-language goal to the specific tool that achieves it. Get guidance on which tool to use for SVG editing.
Instructions
Map a natural-language goal to the concrete inkscape-mcp tool(s) that achieve it.
When to use: when you know what you want in words but not which typed tool does it. To browse
the whole map at once read the intents section of list_capabilities; to then resolve an
object id for an id-taking edit use find_objects. Guidance only — not a portmanteau or raw
tool (ADR-002/003); it executes nothing.
Key params: goal is a natural-language description, e.g. "draw a rectangle", "make my svg
smaller for web", "find the red shapes", "export a png".
Return shape: HowDoIResult — exactly one of: an in-scope hit (out_of_scope=False, matches
best-first, each {goal_pattern, tools, how_to, group}); an out-of-scope goal (edit a
JPEG/photo's pixels, run an arbitrary Action/extension/script, fetch from a URL, execute code) →
out_of_scope=True, empty matches, note naming WHY (vector-only / ADR-003 / no-network /
no-exec); or no match → out_of_scope=False, empty matches, note suggesting
list_capabilities / inspect_document.
Example: how_do_i("make my svg smaller for web")
Risk class: low (read-only guidance; no snapshot / Operation Record).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| goal | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| goal | Yes | The goal string that was matched (echoed back). | |
| note | No | Reason (out-of-scope) or suggestion (no match); empty on a confident match. | |
| matches | No | Best-matching guidance entries (tool name(s) + one-line how-to + group). | |
| out_of_scope | No | True when the goal is a known out-of-scope category (see `note` for why). |