Skip to main content
Glama
FreeCAD Tutor MCP
by alex-r-t

pad_sketch

Extrude a sketch into a solid inside a PartDesign Body using Pad; invalid operations roll back automatically to keep models safe.

Instructions

Extrude a Sketch inside a PartDesign Body using Pad (undoable; rolls back if invalid).

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "sketch_name": "<sketch_name>"
    },
    "name": "pad_sketch"
  }
}

Input Schema

NameRequiredDescriptionDefault
nameNo
lengthNo
doc_nameNo
reversedNo
symmetricNo
sketch_nameYes

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observedv0.2.0

TDQS

B3.4/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare the mutation profile (readOnlyHint=false, destructiveHint=false, idempotentHint=false), so the bar is lower. The description still adds genuinely new behavioral information: the operation is undoable and is transactional, rolling back if the result is invalid — exactly the kind of failure-mode context annotations cannot express.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

A single front-loaded sentence with the action first and the transactional caveat parenthesized. No filler and nothing buried.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so return values need not be described, but a six-parameter mutation tool with 0% schema description coverage needs the description to explain length, reversed, and symmetric semantics and it does not. An agent can identify the tool but cannot confidently populate its arguments from this definition alone.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0% across six parameters, so the description must carry the load. It only conveys sketch_name and the body scoping; length, reversed, symmetric, name, and doc_name are left entirely unexplained, with no units or defaults given for the pad length.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description names a specific verb (Extrude) plus the resource (Sketch), the FreeCAD operation used (Pad), and the required context (inside a PartDesign Body), which is far more than a restatement of the name. It does not explicitly contrast itself with the sibling pocket_sketch, but the material operation is unambiguous.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The phrase 'inside a PartDesign Body' conveys the structural prerequisite, which is real implied usage guidance. There is no statement of when to prefer Pad over pocket_sketch or other siblings, and no mention of what to do when no body/sketch is active.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.