DXF MCP Server
Aspicio ships an MCP server that lets AI agents open, inspect, and render DXF/CAD drawings — built on the same open-source parse → tessellate pipeline as the interactive viewer. Use the hosted endpoint with zero install, or run it locally for private files.
Tools
| Tool | Returns | Use for |
|---|---|---|
describe_dxf |
Structured JSON: units, bounds and size, entity and segment counts, layers with the color actually drawn, per-type entity counts, skipped types | Structural questions — layers, counts, dimensions, units |
render_dxf |
A PNG image of the drawing | Visual questions — what the drawing looks like |
view_dxf |
An interactive, pannable, layer-toggling viewer inside the conversation (hosted server, on MCP Apps hosts such as ChatGPT and Claude) | Letting the user explore the drawing themselves |
Hosted endpoint — no install
Remote MCP over Streamable HTTP, stateless, no accounts, rate-limited per IP. Sources: http(s) URLs or inline DXF text.
https://aspicio-api.frontsail.app/mcpLocal server — private files
The @aspicio/mcp stdio
server adds local file paths as a source form and reads drawings in-process — nothing is
uploaded.
# Claude Code / Claude Desktop
claude mcp add aspicio -- npx -y @aspicio/mcp
# Codex
codex mcp add aspicio -- npx -y @aspicio/mcp
Any other MCP client: register the stdio command npx -y @aspicio/mcp. For a
one-step install with bundled usage skills, use the
aspicio plugin for Claude
Code and Codex.
Guardrails
- URL fetches are guarded: private-network blocking, size caps, redirect validation, and timeouts.
- No accounts and no stored drawings — see the privacy policy.
- Unsupported entity types are counted and reported, never fatal; failures come back as proper protocol errors an agent can read.
More
-
Prefer plain HTTP?
GET /describe?src=<dxf-url>andGET /render?src=<dxf-url>&format=png|svg, self-described via OpenAPI 3.1. - Source on GitHub — MIT licensed.
- Library and embedding docs for using the viewer in your own app.