# Freecad Mcp Functional Print Designer

> Codex/OpenAI skill for designing functional 3D-printable FreeCAD parts via MCP.

- **Type:** MCP server
- **Install:** `agentstack add mcp-pgrignaffini-freecad-mcp-functional-print-designer`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [pgrignaffini](https://agentstack.voostack.com/s/pgrignaffini)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [pgrignaffini](https://github.com/pgrignaffini)
- **Source:** https://github.com/pgrignaffini/freecad-mcp-functional-print-designer

## Install

```sh
agentstack add mcp-pgrignaffini-freecad-mcp-functional-print-designer
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# FreeCAD MCP Functional Print Designer

Codex/OpenAI skill for designing functional, 3D-printable FreeCAD parts through the `freecad` MCP server.

## Format

This repository is already in the correct skill format:

- `SKILL.md`: skill entrypoint and loading rules
- `agents/openai.yaml`: UI metadata
- `references/`: local reference material and curated wiki extracts
- `scripts/`: maintenance scripts, including wiki extract refresh

## Requirements

- An agent runtime that supports `SKILL.md`-based skills
- A configured MCP tool named `freecad`
- FreeCAD available through the `neka-nat/freecad-mcp` server or an equivalent compatible server

## Install For Codex / OpenAI Agents

Clone the repo anywhere, then symlink it into your skills directory.

```bash
git clone  /path/to/freecad-mcp-functional-print-designer
mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"
ln -s /path/to/freecad-mcp-functional-print-designer \
  "${CODEX_HOME:-$HOME/.codex}/skills/freecad-mcp-functional-print-designer"
```

If your environment does not use `CODEX_HOME`, the default skills directory is usually `~/.codex/skills`.

If you already have the repository locally, you only need the symlink step:

```bash
mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"
ln -s /absolute/path/to/freecad-mcp-functional-print-designer \
  "${CODEX_HOME:-$HOME/.codex}/skills/freecad-mcp-functional-print-designer"
```

Example for this repository when it lives under `~/Builds/freecad`:

```bash
mkdir -p ~/.codex/skills
ln -s ~/Builds/freecad/freecad-mcp-functional-print-designer \
  ~/.codex/skills/freecad-mcp-functional-print-designer
```

After creating the symlink, restart Codex or refresh the Skills view so the skill is discovered.
If the Skills tab still looks empty, clear any search filter before checking again.

To verify the install from a shell:

```bash
ls -la ~/.codex/skills
readlink ~/.codex/skills/freecad-mcp-functional-print-designer
```

Using a symlink is recommended because edits in the repository are picked up without reinstalling the skill.

## Install For Other Agent Setups

If your agent uses a different skills root, symlink or copy this repository into that skills directory under the folder name `freecad-mcp-functional-print-designer`.

Example:

```bash
mkdir -p ~/.agents/skills
ln -s /path/to/freecad-mcp-functional-print-designer \
  ~/.agents/skills/freecad-mcp-functional-print-designer
```

## Verify

After installation, the skill should be discoverable as:

```text
$freecad-mcp-functional-print-designer
```

It also expects the `freecad` MCP dependency declared in `agents/openai.yaml` to be available at runtime.

## Refresh Wiki Extracts

To rebuild the curated FreeCAD wiki references:

```bash
./scripts/fetch_freecad_wiki_extracts.py
```

This regenerates:

- `references/wiki-extracts-index.md`
- `references/wiki-extracts/*.md`

## Notes

- The skill is MCP-first. It is written so the agent performs the CAD actions; the user should not have to click through FreeCAD.
- The raw wiki material is not on the default path. The skill opens it only for narrow, exact-option lookups.

## License

MIT. See [LICENSE](LICENSE).

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [pgrignaffini](https://github.com/pgrignaffini)
- **Source:** [pgrignaffini/freecad-mcp-functional-print-designer](https://github.com/pgrignaffini/freecad-mcp-functional-print-designer)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-pgrignaffini-freecad-mcp-functional-print-designer
- Seller: https://agentstack.voostack.com/s/pgrignaffini
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.