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

Related MCP server: Civitai MCP Server

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