# Aspicio

> Aspicio is an open-source MCP server for design and media. Let an agent inspect DXF and vector PDF drawings: facts, PNG renders and a chat viewer. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Web, API, CLI
- **Website:** https://aspicio.frontsail.app
- **Repository:** https://github.com/frontsail-ai/aspicio
- **MCP Registry name:** io.github.frontsail-ai/aspicio
- **Categories:** design and media, engineering simulation
- **Listing updated:** 2026-11-15

## About

Aspicio's server hands an agent structured facts about a drawing and a rendered PNG of the same file, plus an interactive viewer inside the chat. It reads DXF CAD files and the vector content of PDFs, meaning artwork and dielines rather than scans, and is aimed at PDF/X-4 artwork.

The same engine powers every surface. The README describes a TypeScript, MIT-licensed pipeline that parses a drawing into a normalised model and tessellates it, feeding a WebGL browser viewer, SVG export, a summary of units, bounds, layers and texts, an HTTP API and the MCP server. Web components with React, Vue and Svelte bindings let you embed the viewer, and a headless mode runs in Node or serverless.

The online viewer parses and renders in the browser and does not upload drawings. For the MCP server there are two routes: the npm package `@aspicio/mcp` over stdio, or a hosted streamable HTTP endpoint.

## Features

- **Structured drawing facts:** Describes units, bounds, layers, texts and spaces as JSON.
- **PNG renders:** Gives an agent an image of the same drawing.
- **In-chat viewer:** An interactive viewer appears inside the conversation.
- **DXF and vector PDF:** Reads CAD files and PDFs that carry artwork or dielines.
- **Embeddable components:** Web components with React, Vue and Svelte bindings.
- **Local or hosted:** Run `@aspicio/mcp` over stdio or use the remote endpoint.

## Good for

- Check layers and bounds of a DXF before sending it to a cutter
- Preview packaging dielines in a chat
- Generate thumbnails of drawings in a pipeline
- Embed a drawing viewer in a web app
- Export a drawing to SVG or PNG

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http aspicio https://aspicio-api.frontsail.app/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://aspicio-api.frontsail.app/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "aspicio": {
      "url": "https://aspicio-api.frontsail.app/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "aspicio": {
      "type": "http",
      "url": "https://aspicio-api.frontsail.app/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "aspicio": {
      "serverUrl": "https://aspicio-api.frontsail.app/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "aspicio": {
      "type": "http",
      "url": "https://aspicio-api.frontsail.app/mcp"
    }
  }
}
```

## FAQ

### Are drawings uploaded in the online viewer?

No. The viewer parses and renders in the browser and drawings are never uploaded.

### What file types does it handle?

DXF, and the vector content of PDF.

### What licence is it under?

MIT.

### How do I run the MCP server?

Install the npm package @aspicio/mcp for stdio, or point a client at the hosted streamable HTTP endpoint.

### Is Aspicio free?

Yes. Aspicio is open source, so you can use and self-host it for free.

### How do I add Aspicio to Claude Code?

Run this command in your terminal: claude mcp add --transport http aspicio https://aspicio-api.frontsail.app/mcp

### What are the best alternatives to Aspicio?

The closest alternatives to Aspicio are HyperFrames by HeyGen, ffmpeg-skill, AvatarSay — Fictional Character & Talking Video MCP, ChartAnt and VfxSmith.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.

---
Source: https://ai-powered.com/mcp/aspicio
