AI Tools Library
AI tools are the actions SmartHopper's AI can perform on your behalf — reading your Grasshopper canvas, placing or wiring components, writing scripts, searching the McNeel and Ladybug forums, converting files and web pages to Markdown, or capturing screenshots of your viewport.
You don't need to call these tools by name yourself. When you ask the assistant a question in plain language, it automatically picks and chains the right tools to get the job done.
Where AI tools are used
The same tool library powers three parts of SmartHopper:
1. The Canvas Assistant and AI Chat component
When you chat with the Canvas Assistant or an AI Chat component, the AI model uses these tools to inspect your open document, look up documentation or forum answers, and propose changes to your definition.
2. External AI apps via the MCP Server
When you drop the SmartHopper MCP Server component onto your canvas, external Model Context Protocol clients — such as Claude Desktop, Cursor, VS Code, or Claude Code — can call these same tools to inspect and work with your live Grasshopper session.
3. SmartHopper components on the canvas
Many SmartHopper components (such as Get GhJSON, Place GhJSON, AI Script Generate, Web To Markdown, and the forum search components) run these tools under the hood so you can use the exact same capabilities inside a parametric data flow.
Safety and permissions
SmartHopper separates tools that only read information from tools that change your canvas or reach outside Grasshopper:
You review every canvas edit before it happens
Whenever a tool wants to add, replace, wire, move, group, or remove components on your canvas, SmartHopper pauses and opens the canvas change review dialog. You can inspect every proposed change, select which items to apply, or cancel the whole operation — and anything applied can be undone with Ctrl+Z.
Read-only by default for external MCP clients
When an external client connects through the MCP Server component, only local, read-only tools are available by default. You decide what else to unlock on that component:
- Allow Editing unlocks tools that modify the canvas or scripts (still protected by the review dialog unless you also enable Auto-approve changes).
- Allow View Control unlocks tools that pan or zoom your Grasshopper viewport.
- Allow External Tools unlocks tools that read local files, capture screenshots, fetch web or forum pages, or run AI model calls that use your provider credits.
Built-in reference guides for the AI
The library includes self-documentation tools (smarthopper_readme, smarthopper_workflows, smarthopper_tool_help, and smarthopper_ghjson_reference) that give the AI up-to-date instructions on how Grasshopper, GhJSON, and SmartHopper work — so it doesn't have to guess parameter formats or workflows.
Browse tools by category
| Category | What the AI can do |
|---|---|
| Canvas — Read | Inspect your Grasshopper document, selected components, runtime errors, installed component types, and open files. |
| Canvas — Edit | Generate and place components, wire parameters, change slider/panel/toggle values, arrange layouts, group, lock, preview, or patch definitions. |
| Scripting | Create new C#, Python, VB.NET, or IronPython script components, edit existing scripts on the canvas, and run static + AI code reviews. |
| Knowledge, Web & Files | Search and summarize the McNeel Discourse forum, the Ladybug Tools forum, or any Discourse forum; convert web pages and local documents to Markdown. |
| Data & Lists | Generate text, structured JSON, lists, and boolean evaluations, or filter and reorder lists using natural-language rules. |
| Media, Vision & Viewport | Generate and analyze images, synthesize speech, capture canvas or Rhino viewport screenshots, and pan/zoom the canvas view to highlight components. |
| Providers & Models | Check which AI providers and models are available in your SmartHopper setup and assign a provider or model to a component. |
| Assistant Guides & Planning | Built-in reference guides, clarifying questions (ask_user), step-by-step plans, tool search, and background subagents. |
| Experimental Tools | Preview of upcoming parameter-modifier and Rhino .3dm geometry inspection tools (disabled in standard builds while under validation). |
For the assistant to use tools during a conversation, your selected AI model must support tool calling (function calling). You can check which models support tool calling with the AI Models component. Looking to build your own tool in C#? See Writing AI tools in the Developer Guide.