Skip to main content
Glama

Quady3D developer tools

Create 3D assets from text or a selected image, recover the original task, and save the model file to your project. Official MIT-licensed clients from Quady3D AI.

Developer API · API documentation · Supported models · Plans and credits

Choose your client

Install the official versioned packages from npm and PyPI, or add the Skill from this repository.

Product

Install / source

Official guide

MCP server

npm install --global --ignore-scripts @quady3d/mcp@0.1.2

MCP setup

Agent Skill

npx skills add quady3dai/quady3d-tools --skill quady3d -a codex · source

Skill setup

TypeScript / JavaScript SDK

npm install --ignore-scripts @quady3d/sdk@0.1.2

TypeScript SDK

Python SDK

python -m pip install quady3d==0.1.2

Python SDK

Registry listings: MCP on npm · SDK on npm · Python on PyPI.

Versioned archive downloads and checksums: GitHub Releases and Quady3D downloads.

Related MCP server: meshy-youtube-mcp

From an idea to a game prop

Pair the MCP with the Skill, then ask your agent to create a wooden treasure chest or a camping lantern for your game project. The workflow checks available models and account access, quotes the request, asks for the authorized credit limit when needed, follows the original task, and saves its GLB. Inspect materials, scale and geometry before using the asset in a game scene. Blender workflow · Unity import guide.

Cloud generation uses Quady3D account credits. Client installation does not add credits or unlock download access. Create a narrowly limited API key and keep it in the host or application environment. Read-only account/model checks and quotes do not create paid generations. Do not place permanent keys in browser code or commit them.

Build from source

Use Node.js 22+, pnpm 10.16.1 and Python 3.10+.

pnpm install --frozen-lockfile --ignore-scripts
pnpm --dir packages/mcp typecheck
pnpm --dir packages/mcp build

The JavaScript SDK ships directly usable source and type declarations. To build the Python wheel and source distribution, use a Python environment with build, setuptools 77+ and wheel, then run python -m build packages/python. Keep bundled third-party notices with the MCP.

Compatibility and delivery

The standalone Codex MCP + Skill flow is verified on macOS arm64. Other operating systems are not covered by that verification; Node/Python minimum versions are runtime requirements. Claude remains pending verification. This basic release exposes eight MCP tools for text or single-image generation, quotes, account/model discovery, recovery and file delivery. Native plugins, advanced operations and scene generation are separate releases.

SDK request timeouts default to 120 seconds. Waiting has its own deadline. Downloads stream to the caller's writer with a default 512 MiB limit. On interruption, retain the original action/job/asset identity and retry that task or asset; byte-range resume is not implemented. Full examples preserve existing destinations and clean up handled partial transfers. Inspect file paths and work inside trusted project directories.

License and support

The MIT license covers these clients. The hosted service, models and generated assets have their own terms. Changelog · Issues · Official support.

Build the versioned archives and checksums with QUADY3D_BUILD_PYTHON=/absolute/path/to/build-venv/bin/python python3 scripts/release.py. The selected Python environment must contain setuptools 77+ and wheel; install uv from its official distribution. This command builds locally and does not publish anything.

Available Tools

8 tools
quady3d_create_jobQuady3D create jobA
Idempotent

Start a user-authorized generation within max_credits using a saved quote and a ready project directory. Reuse the exact client_action_id, quote and limit after interruption, including when the directory needs reconnecting. Returns immediately; query the same job. This reserves credits.

Inputs: quote_id (required), max_credits (required), client_action_id (required).

quady3d_download_assetQuady3D download assetA
Idempotent

Save an owned result to an existing allowed project directory without replacing an existing file. Retry downloads independently of generation. Returns actual path, size and a locally computed SHA-256. Does not generate; download access still applies.

Inputs: asset_id (required), target_path (required).

quady3d_get_accountQuady3D get accountA
Read-onlyIdempotent

Read balance, download access, credit limits, local_workspace readiness and local_recovery across-key support. Authenticates this connection before associating saved requests with its account. Check ready_for_new_generation before a new task. No generation charge.

Inputs: no named parameters.

quady3d_get_jobQuady3D get jobA
Read-onlyIdempotent

Query the original task, optionally waiting up to 30 seconds. A local timeout does not fail or cancel the cloud task and must not trigger a replacement generation.

Inputs: job_id (required), wait_seconds.

quady3d_list_jobsQuady3D list jobsB
Read-onlyIdempotent

List this account's API tasks for recovery. Does not generate or charge.

Inputs: limit, cursor, status.

quady3d_list_modelsQuady3D list modelsA
Read-onlyIdempotent

List model availability, input limits and parameter_schema with defaults, enums, ranges and conditional constraints. Select an explicit available model and respect its parameter definitions before quoting. Older APIs may omit definitions; use defaults instead of guessing custom values. No generation charge.

Inputs: operation.

quady3d_quoteQuady3D quoteA
Read-onlyIdempotent

Quote an explicit text or single-image generation without charging. Saves this connection's input for create_job. The quote expires in five minutes.

quady3d_upload_fileQuady3D upload fileA

Upload one explicitly selected PNG, JPG or WebP from an allowed project root (up to 8 MiB). No generation charge; upload expires after 30 minutes.

Inputs: file_path (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 8 tools

    Disambiguation5/5

    Each tool has a distinct role in the generation workflow: account inspection, model listing, file upload, quoting, job creation, job querying, job listing, and asset download. Potential confusion between quote and create_job or get_job and list_jobs is resolved by clear descriptions of when each should be used.

    Naming Consistency5/5

    All tools use the same quady3d_ prefix followed by snake_case verb_noun naming. The only slight variation is quady3d_quote, but it still reads as a clear action and fits the overall convention.

    Tool Count5/5

    Eight tools are well-scoped for a generation workflow that needs account checks, model selection, upload, quoting, job management, and download. Each tool earns its place without obvious redundancy.

    Completeness4/5

    The core lifecycle is covered from model listing and upload through quote, job creation, querying, listing, and asset download. Minor gaps exist around job cancellation or asset/job cleanup, but agents can still complete the primary generation workflow.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers