cults3d-mcp

cults3d-mcp

An MCP (Model Context Protocol) server for Cults3D — the leading marketplace for 3D printing designs.

Enables AI agents to upload designs, track stats, manage listings, and monitor community engagement on Cults3D.

First open-source MCP server for Cults3D.

---

Features

| Tool | Description | |------|-------------| | upload_design | Upload a new STL/ZIP with title, description, tags, category, price | | update_design | Edit metadata on an existing listing | | list_my_designs | List all your published designs with status and stats | | get_design_stats | Downloads, likes, comments, revenue for a design | | search_designs | Search public designs by keyword (competitor research) | | get_trending | Trending designs in a category | | get_comments | Read comments on a design | | reply_to_comment | Post a reply to a comment | | list_collections | List your Cults3D collections | | add_to_collection | Add a design to a collection |

---

Installation

pip install cults3d-mcp

Or run directly with uvx:

uvx cults3d-mcp

---

Configuration

Create a .env file (see .env.template):

CULTS3D_EMAIL=your@email.com
CULTS3D_PASSWORD=yourpassword

Authentication uses Cults3D's token-based auth (JWT). The server logs in on startup and refreshes the token automatically.

---

MCP Client Setup

Add to your MCP config (~/.config/claude/claude_desktop_config.json or equivalent):

{
  "mcpServers": {
    "cults3d": {
      "command": "uvx",
      "args": ["cults3d-mcp"],
      "env": {
        "CULTS3D_EMAIL": "your@email.com",
        "CULTS3D_PASSWORD": "yourpassword"
      }
    }
  }
}

---

Development

git clone https://github.com/clugtu/cults3d-mcp
cd cults3d-mcp
pip install -e ".[dev]"
pre-commit install
pytest

This repo uses pre-commit with ruff for linting and formatting. Install pre-commit if you don't have it:

pip install pre-commit

Then run pre-commit install once to register the hooks — they'll run automatically on every git commit.

---

API Notes

Cults3D uses an internal GraphQL API (https://cults3d.com/graphql). This server uses reverse-engineered queries from the web interface. It is not an officially supported integration.

• Rate limits: Be respectful — add delays between bulk operations
• Auth: Session-based JWT, refreshed every ~24h
• File uploads: Multipart form-data for STL/ZIP files

---

License

MIT — see LICENSE

---

Related

• pinterest-mcp — Pinterest MCP server