Back to Browse

Printables MCP Server

Developer ToolsModerate6.2MCP RegistryLocal
Free

Server data from the Official MCP Registry

Search Printables.com 3D models, read model cards, list files and get download links.

About

Search Printables.com 3D models, read model cards, list files and get download links.

Security Report

6.2
Moderate6.2Moderate Risk

The printables-mcp server is a read-only, anonymous client for the public Printables GraphQL API with no hardcoded credentials, no shell execution, no dynamic code execution, and no data exfiltration paths; its only network destination is api.printables.com and related media hosts. Permissions (network_http for the public API, plus logging to stderr) match its stated purpose, and the code is clean and well-tested, with only minor observations such as the undocumented API dependency. Supply chain analysis found 5 known vulnerabilities in dependencies (1 critical, 1 high severity). Package verification found 1 issue.

10 files analyzed · 9 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-feodor-ra-printables-mcp": {
      "args": [
        "printables-mcp"
      ],
      "command": "uvx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

printables-mcp

English · Русский

PyPI - Version PyPI - Python Version PyPI - Status CI

MCP Registry feodor-ra/printables-mcp MCP server

An MCP server for Printables.com: lets an AI agent search 3D models, read model cards, list files and get direct download links.

It talks to the public Printables GraphQL API directly: no HTML scraping, no browser, no account. All tools are read-only and return structured results (JSON with an output schema), so agents get exact fields instead of prose.

Installation

uv tool install printables-mcp

Then register the printables-mcp command with your MCP client. Claude Code:

claude mcp add printables -s user -- printables-mcp

Any other client that speaks stdio:

{
  "mcpServers": {
    "printables": { "command": "printables-mcp" }
  }
}

Without installing: uvx printables-mcp.

Tools

ToolWhat it does
search_modelsText search with pagination (limit, offset, total count) and filters: category, price (free / paid), licenses, published within N days, has user prints. Orderings: best match, popular, latest, rating, makes count.
get_modelFull model card: description as Markdown, tags, category path, license, materials, printer, print time, filament weight, images, PDF, remix sources, stats, price.
list_model_filesEvery file group in one request: model files (STL/3MF/STEP…), G-code with printer, material, layer height, nozzle and print time, SLA files, other files, ZIP packs.
get_download_linksDirect download URLs (valid 24 h) for all or selected files, fetched in parallel. Files of paid or club-only models come back with a per-file reason instead of failing the call.
list_categoriesAll categories with their full paths (IDs for the search filter).
list_licensesAll licenses (IDs for the search filter).
get_authorAuthor profile by ID, handle or profile URL.
list_author_modelsAn author's models, cursor-paginated, ordered by newest, oldest, likes, downloads, rating or makes.

Models and authors can be passed as IDs or as printables.com URLs (locale prefixes such as /de/ are fine).

Limitations

  • Anonymous access only: paid and Printables Club models are visible, but their files cannot be downloaded.
  • The API is undocumented and may change without notice; the end-to-end suite (just test-live) checks it against the live service.

Development

uv sync
just lint       # ruff format/check + ty
just test       # pytest with 100% branch coverage
just test-live  # end-to-end tests against the real API

License

MIT

Reviews

No reviews yet

Be the first to review this server!