3DAssets.dev

Find cohesive free GLB game kits by text, theme or style. Returns file counts, total bytes and starter scene URLs. Use get_pack for every individual model and loader snippet.

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Free-text search over pack titles and summaries",
      "type": "string",
      "maxLength": 120
    },
    "q": {
      "description": "Alias for query, as spelled by the REST API",
      "type": "string",
      "maxLength": 120
    },
    "theme": {
      "description": "Theme tag slug, e.g. sci-fi, fantasy, modern",
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
    },
    "style": {
      "description": "Style tag slug, e.g. low-poly, realistic, voxel",
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Get a free pack manifest with direct CDN URLs, licences, geometry budgets, loader snippets and its assembled starter scene. Download models individually or use the starter scene.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

List the walkable demo scenes staff have built from single packs. Each is a small environment a person can walk through on the site and an agent can load as a layout. Use get_demo for the placements.

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Get one demo: the pack, the spawn point, the walkable bounds, the points of interest, and every placement (public asset slug, position in metres, yaw in degrees) with the CDN URL and bounds of each model placed. Load the models with a plain GLTFLoader and apply the transforms to reproduce the scene.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Search the free GLB catalogue on 3dassets.dev (three.js, Blender, Godot, Unity) by text, category (what it is), theme (what world) and style (what look). Returns direct CDN URLs (CORS *, immutable) that load with a plain GLTFLoader. Published models use CC0 1.0 Universal: free personal and commercial use without attribution. Licence metadata is retained in each result.

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Free-text search over title and summary",
      "type": "string",
      "maxLength": 120
    },
    "q": {
      "description": "Alias for query, as spelled by the REST API",
      "type": "string",
      "maxLength": 120
    },
    "category": {
      "description": "Category slug from list_categories",
      "type": "string"
    },
    "tag": {
      "description": "Any tag slug from list_tags",
      "type": "string"
    },
    "theme": {
      "description": "Theme tag slug, e.g. sci-fi, fantasy, modern",
      "type": "string"
    },
    "style": {
      "description": "Style tag slug, e.g. low-poly, realistic, voxel",
      "type": "string"
    },
    "sort": {
      "description": "Default: best match for a query, newest otherwise",
      "type": "string",
      "enum": [
        "relevance",
        "newest",
        "popular",
        "title"
      ]
    },
    "limit": {
      "default": 10,
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "page": {
      "default": 1,
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Full details for one asset by slug: CDN URL, licence + attribution text, stats, bounding box, animations, and ready-to-paste loader snippets.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Code or steps to load an asset in three.js, React Three Fiber, <model-viewer>, Blender, Godot or Unity.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
    },
    "framework": {
      "default": "threejs",
      "type": "string",
      "enum": [
        "threejs",
        "r3f",
        "model-viewer",
        "blender",
        "godot",
        "unity"
      ]
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

List categories available on 3dassets.dev (slugs are what other tools accept).

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

List tags available on 3dassets.dev (slugs are what other tools accept).

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Returns the sole accepted submission dedication: CC0 1.0 Universal. No licence selection is needed.

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Search model suggestions from OpenRouter, refreshed hourly. Custom model/tool names are accepted; the list is not exhaustive. Unavailable suggestions never block uploads.

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "maxLength": 200
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Create a contributor account for the user. Needs only a username and email. There is no password anywhere in this product, so never ask the user for one. A 6-digit code is emailed to them; ask the user to read it to you, then call verify_account to receive their API key. Only do this with the user’s explicit consent.

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "format": "email",
      "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
    },
    "username": {
      "type": "string",
      "pattern": "^[a-z0-9](?:[a-z0-9-]{1,30}[a-z0-9])?$",
      "description": "Public handle, lowercase letters/numbers/hyphens"
    },
    "name": {
      "description": "Optional display name shown on assets; defaults to the username",
      "type": "string",
      "minLength": 2,
      "maxLength": 80
    },
    "website": {
      "type": "string",
      "format": "uri"
    }
  },
  "required": [
    "email",
    "username"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Exchange the emailed 6-digit code for the account’s API key. Show the key to the user and tell them to configure it as the Bearer token for this MCP server.

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "format": "email",
      "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
    },
    "code": {
      "type": "string",
      "pattern": "^\\d{6}$"
    }
  },
  "required": [
    "email",
    "code"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Submit a .glb hosted at a public https URL on the user’s behalf (requires their API key). We download it, validate and re-encode it, then a human reviews it before publishing. CC0 is automatic, but the user must accept its irrevocable dedication before submission. Max 25 MB, 1M triangles, embedded textures only.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "format": "uri"
    },
    "title": {
      "type": "string",
      "minLength": 2,
      "maxLength": 120
    },
    "summary": {
      "type": "string",
      "minLength": 10,
      "maxLength": 280,
      "description": "Plain 1–2 sentence description"
    },
    "description": {
      "description": "Markdown: scale, pivot, what is included",
      "type": "string",
      "maxLength": 5000
    },
    "category": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
      "description": "From list_categories"
    },
    "license": {
      "default": "cc0-1.0",
      "description": "Fixed CC0 1.0 Universal dedication; no licence selection",
      "type": "string",
      "const": "cc0-1.0"
    },
    "tags": {
      "default": [],
      "maxItems": 12,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 64,
        "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
      }
    },
    "sourceUrl": {
      "description": "Where the original was first published",
      "type": "string",
      "format": "uri"
    },
    "aiGenerated": {
      "default": false,
      "description": "AI helped create geometry, code or textures; not merely uploading",
      "type": "boolean"
    },
    "aiModel": {
      "description": "Contributor-reported model ID or custom model/tool name; use list_ai_models for suggestions. Omit if unknown.",
      "type": "string",
      "minLength": 1,
      "maxLength": 160
    },
    "attestation": {
      "type": "boolean",
      "const": true,
      "description": "Required contributor acceptance (including for agent submissions): I confirm that I created this asset or hold the rights to publish it under CC0 1.0 Universal, and agree to dedicate it to the public domain under CC0 so anyone can use, modify and redistribute it for personal or commercial purposes without attribution. I understand this dedication is irrevocable and the asset will be reviewed before publishing."
    }
  },
  "required": [
    "url",
    "title",
    "summary",
    "category",
    "attestation"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

For clients that can upload bytes: returns a presigned PUT URL for a .glb (and optionally a PNG preview). Then call finalize_upload with the returned keys.

{
  "type": "object",
  "properties": {
    "filename": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "contentLength": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 26214400
    },
    "withPreview": {
      "default": true,
      "type": "boolean"
    }
  },
  "required": [
    "filename",
    "contentLength"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

After PUTting the file to the URL from get_upload_url, describe the asset and submit it for processing and review.

{
  "type": "object",
  "properties": {
    "quarantineKey": {
      "type": "string"
    },
    "previewKey": {
      "type": "string"
    },
    "title": {
      "type": "string",
      "minLength": 2,
      "maxLength": 120
    },
    "summary": {
      "type": "string",
      "minLength": 10,
      "maxLength": 280,
      "description": "Plain 1–2 sentence description"
    },
    "description": {
      "description": "Markdown: scale, pivot, what is included",
      "type": "string",
      "maxLength": 5000
    },
    "category": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
      "description": "From list_categories"
    },
    "license": {
      "default": "cc0-1.0",
      "description": "Fixed CC0 1.0 Universal dedication; no licence selection",
      "type": "string",
      "const": "cc0-1.0"
    },
    "tags": {
      "default": [],
      "maxItems": 12,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 64,
        "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
      }
    },
    "sourceUrl": {
      "description": "Where the original was first published",
      "type": "string",
      "format": "uri"
    },
    "aiGenerated": {
      "default": false,
      "description": "AI helped create geometry, code or textures; not merely uploading",
      "type": "boolean"
    },
    "aiModel": {
      "description": "Contributor-reported model ID or custom model/tool name; use list_ai_models for suggestions. Omit if unknown.",
      "type": "string",
      "minLength": 1,
      "maxLength": 160
    },
    "attestation": {
      "type": "boolean",
      "const": true,
      "description": "Required contributor acceptance (including for agent submissions): I confirm that I created this asset or hold the rights to publish it under CC0 1.0 Universal, and agree to dedicate it to the public domain under CC0 so anyone can use, modify and redistribute it for personal or commercial purposes without attribution. I understand this dedication is irrevocable and the asset will be reviewed before publishing."
    }
  },
  "required": [
    "quarantineKey",
    "title",
    "summary",
    "category",
    "attestation"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

List the user’s submissions with status (processing, pending review, published, rejected + reason, failed + reason). `pendingEdit` means the user has metadata changes waiting for review; the published version is unchanged until they are approved.

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Group 2–50 of the user’s own uploads (any that are processing, pending or published) into a pack proposal. Upload the models first with finalize_upload or submit_asset_from_url, then pass their slugs here. Each model is still reviewed on its own; a person approves the pack as a whole, which publishes any members still pending and creates the pack page. Nothing goes live until then. The user is emailed the outcome.

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "minLength": 2,
      "maxLength": 120
    },
    "summary": {
      "type": "string",
      "minLength": 10,
      "maxLength": 280
    },
    "description": {
      "type": "string",
      "maxLength": 5000
    },
    "assets": {
      "minItems": 2,
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 64,
        "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
      }
    }
  },
  "required": [
    "title",
    "summary",
    "assets"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

List the user’s pack proposals with status (submitted, approved + pack URL, rejected + reason) and the status of each member model.

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Edit the metadata of one of the user’s own assets. The uploaded GLB can never be changed. Editing an asset that is already published does not change it: the proposal goes to the review queue and the live version keeps serving until a person approves it.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
    },
    "aiGenerated": {
      "type": "boolean"
    },
    "aiModel": {
      "description": "Model ID or custom name; empty string clears attribution",
      "type": "string",
      "maxLength": 160
    },
    "title": {
      "type": "string",
      "minLength": 2,
      "maxLength": 120
    },
    "summary": {
      "type": "string",
      "minLength": 10,
      "maxLength": 280
    },
    "description": {
      "type": "string",
      "maxLength": 5000
    },
    "category": {
      "description": "From list_categories",
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
    },
    "tags": {
      "maxItems": 12,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 64,
        "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
      }
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}