# Printables

> Printables is an open-source MCP server for design and media. Search Printables.com 3D models and fetch files and download links from an agent. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Repository:** https://github.com/feodor-ra/printables-mcp
- **MCP Registry name:** io.github.feodor-ra/printables-mcp
- **Categories:** [design and media](https://ai-powered.com/categories/design-and-media)
- **Listing updated:** 2026-11-18

## About

The server talks straight to the public Printables GraphQL API, so there is no HTML scraping, browser or account involved. Every tool is read-only and returns structured JSON with an output schema, which gives an agent exact fields rather than prose.

Search can be filtered by category, free or paid price, licence, recency and whether a model has user prints, and ordered by best match, popularity, latest, rating or makes. A model card returns the Markdown description, tags, licence, materials, printer, print time and filament weight. File listings split out model files such as STL, 3MF and STEP, G-code with printer, material, layer height and nozzle, SLA files and ZIP packs. Models and authors can be given as IDs or printables.com URLs.

Access is anonymous. Paid and Printables Club models show up in results, but their files cannot be downloaded, and the tool reports a reason per file instead of failing. The README warns that the API is undocumented and may change without notice.

## Features

- **Filtered model search:** Search by category, price, licence, age and prints, with several sort orders.
- **Full model cards:** Read description, materials, printer, print time and stats.
- **Grouped file lists:** See model files, G-code, SLA files and ZIP packs in one request.
- **Download links:** Get direct URLs valid for 24 hours.
- **Author lookups:** Fetch a profile and browse an author's models.
- **URL or ID input:** Pass printables.com links, including locale prefixes.

## Good for

- Find a free, permissively licensed 3D model for a project
- Check print time and filament weight before downloading
- Pull G-code for a specific printer and nozzle
- Browse a favourite designer's newest models

## Install

### Claude Code (Terminal)

```sh
claude mcp add printables-mcp -- uvx printables-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "printables-mcp": {
      "command": "uvx",
      "args": [
        "printables-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "printables-mcp": {
      "command": "uvx",
      "args": [
        "printables-mcp"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "printables-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "printables-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "printables-mcp": {
      "command": "uvx",
      "args": [
        "printables-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "printables-mcp": {
      "command": "uvx",
      "args": [
        "printables-mcp"
      ]
    }
  }
}
```

## Tools

- `search_models`: Text search with filters, pagination and several orderings.
- `get_model`: Returns the full model card.
- `list_model_files`: Lists every file group for a model.
- `get_download_links`: Returns direct download URLs valid for 24 hours.
- `list_categories`: Lists categories with full paths.
- `list_licenses`: Lists licences with IDs for filtering.
- `get_author`: Returns an author profile by ID, handle or URL.
- `list_author_models`: Lists an author's models, cursor-paginated.

## FAQ

### Do I need a Printables account?

No. Access is anonymous.

### Can it download paid models?

No. Their files cannot be downloaded, though the models are visible.

### Is it read-only?

Yes, all tools are read-only.

### How do I install it?

Run uv tool install printables-mcp, or use uvx printables-mcp without installing.

### Is Printables free?

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

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

Run this command in your terminal: claude mcp add printables-mcp -- uvx printables-mcp

### What are the best alternatives to Printables?

The closest alternatives to Printables are HyperFrames by HeyGen, next-ai-draw-io, mcp-for-blender, ffmpeg-skill and cursor-talk-to-figma-mcp.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [next-ai-draw-io](https://ai-powered.com/mcp/next-ai-draw-io-2): next-ai-draw-io is an open-source MCP server for ai models and llm tooling.
- [mcp-for-blender](https://ai-powered.com/mcp/mcp-for-blender): mcp-for-blender is an open-source 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.
- [cursor-talk-to-figma-mcp](https://ai-powered.com/mcp/cursor-talk-to-figma-mcp): cursor-talk-to-figma-mcp is an open-source MCP server for design and media.
- [Design Feeds](https://ai-powered.com/mcp/design-feeds): Design Feeds is a freemium MCP server for design and media.
- [Meigen AI MCP](https://ai-powered.com/mcp/meigen-ai-mcp): Meigen AI MCP is an open-source MCP server for design and media.
- [Z-Image MCP](https://ai-powered.com/mcp/z-image-mcp): Z-Image MCP is a freemium MCP server for design and media.

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