Skip to main content
Glama

3DAssets.dev for agents

Free, web-optimised CC0 GLB models and game asset packs for three.js, React Three Fiber, Blender, Godot, Unity and any glTF-capable tool. This repository holds the machine-readable pieces of https://3dassets.dev in one place for directories and agent tooling that index GitHub:

  • SKILL.md: the agent skill, a copy of https://3dassets.dev/skill.md (kept in sync daily by a workflow)

  • bin/3dassets-mcp.js: the 3dassets-mcp npm package, a stdio bridge to the hosted server

  • .mcp.json: MCP client configuration for the hosted server

  • server.json: the official MCP Registry entry

  • llms-install.md: setup notes for agents that install from a README

The site, the API and the MCP server itself are hosted at 3dassets.dev, so the only code here is the thin stdio bridge; the catalogue is at https://3dassets.dev/assets.

MCP server

Two ways in. Hosted (Streamable HTTP) needs nothing installed; the npm package runs the same server over stdio for clients that only speak stdio or want a pinned dependency. Both expose the same tools.

# stdio, via npm (bridges to the hosted server; no local state)
npx -y 3dassets-mcp
{
  "mcpServers": {
    "3dassets": { "command": "npx", "args": ["-y", "3dassets-mcp"] }
  }
}

Set THREEDASSETS_API_KEY in the environment to submit models on the user's behalf; leave it unset for read-only use.

Hosted endpoint

Streamable HTTP endpoint: https://3dassets.dev/mcp. Search and download need no auth. Submitting models on a user's behalf takes their API key as a Bearer token; https://3dassets.dev/auth.md explains how an agent obtains one without the user ever handling a password.

# Claude Code
claude mcp add --transport http 3dassets https://3dassets.dev/mcp

# Codex CLI
codex mcp add 3dassets --url https://3dassets.dev/mcp

# VS Code
code --add-mcp '{"name":"3dassets","type":"http","url":"https://3dassets.dev/mcp"}'

Cursor, Windsurf or any mcp.json:

{
  "mcpServers": {
    "3dassets": { "url": "https://3dassets.dev/mcp" }
  }
}

Tools: search_assets, search_packs, get_pack, list_demos, get_demo, get_asset, get_asset_usage, list_categories, list_tags, list_licenses, list_ai_models, create_account, verify_account, submit_asset_from_url, get_upload_url, finalize_upload, my_assets, update_asset, submit_pack, my_packs. Full reference: https://3dassets.dev/docs/mcp.

Related MCP server: sketchfab-mcp-server

Skill

npx skills add 3dassets-dev/3dassets

Or point any agent at https://3dassets.dev/skill.md directly. The skill uses plain HTTP, so it works without MCP.

REST API

Base https://3dassets.dev/api/v1, OpenAPI at https://3dassets.dev/api/v1/openapi.json, guide at https://3dassets.dev/docs/api. Every asset also has a Markdown view at https://3dassets.dev/assets/{slug}.md.

Discovery documents

Licence

Every asset on the site is CC0 1.0. The files in this repository are CC0 1.0 too.

Questions: hello@3dassets.dev

Available Tools

20 tools
create_accountCreate accountAInspect

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.

Inputs: email (required), username (required), name, website.

finalize_uploadFinalize uploadAInspect

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

Inputs: title (required), summary (required), category (required), attestation (required), +8 more.

get_assetGet assetAInspect

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

Inputs: slug (required).

get_asset_usageGet usage snippetCInspect

Code or steps to load an asset in three.js, React Three Fiber, , Blender, Godot or Unity.

Inputs: slug (required), framework.

get_demoGet a walkable pack demo layoutBInspect

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.

Inputs: slug (required).

get_packGet a complete game asset packAInspect

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.

Inputs: slug (required).

get_upload_urlGet upload URLAInspect

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.

Inputs: filename (required), contentLength (required), withPreview.

list_ai_modelsFind AI modelsBInspect

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

Inputs: q.

list_categoriesList categoriesAInspect

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

Inputs: no named parameters.

list_demosList walkable pack demosAInspect

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.

Inputs: no named parameters.

list_licensesList licencesAInspect

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

Inputs: no named parameters.

list_tagsList tagsAInspect

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

Inputs: no named parameters.

my_assetsMy assetsAInspect

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.

Inputs: no named parameters.

my_packsMy packsAInspect

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

Inputs: no named parameters.

search_assetsSearch assetsAInspect

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.

Inputs: q, tag, page, sort, +5 more.

search_packsSearch game asset packsAInspect

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.

Inputs: q, query, style, theme.

submit_asset_from_urlSubmit asset from URLAInspect

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.

Inputs: url (required), title (required), summary (required), category (required), +7 more.

submit_packPropose a packAInspect

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.

Inputs: title (required), assets (required), summary (required), description.

update_assetUpdate assetAInspect

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.

Inputs: slug (required), tags, title, aiModel, +4 more.

verify_accountVerify accountAInspect

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.

Inputs: code (required), email (required).

Tool Schema Changelog

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

  1. 20 tool updatesv1.0.0
    • First observedcreate_account
    • First observedfinalize_upload
    • First observedget_asset
    • First observedget_asset_usage
    • First observedget_demo
    • First observedget_pack
    • First observedget_upload_url
    • First observedlist_ai_models
    • First observedlist_categories
    • First observedlist_demos
    • First observedlist_licenses
    • First observedlist_tags
    • First observedmy_assets
    • First observedmy_packs
    • First observedsearch_assets
    • First observedsearch_packs
    • First observedsubmit_asset_from_url
    • First observedsubmit_pack
    • First observedupdate_asset
    • First observedverify_account

TDQS

A3.7/5.0

Scored across 20 tools

Disambiguation5/5

Each tool has a clearly distinct purpose: account management, asset upload steps, asset and pack queries, metadata lists, and usage examples. The stepwise upload flow (get_upload_url, submit_asset_from_url, finalize_upload) is well-separated, and user-specific vs. general queries are unambiguous.

Naming Consistency3/5

Most tools follow a verb-first pattern (get_, list_, search_, submit_, create_, verify_, finalize_), but 'my_assets' and 'my_packs' break this convention by using a noun phrase. This inconsistency is noticeable but not chaotic, as the verbs are otherwise regular.

Tool Count4/5

With 20 tools, the server is slightly above the typical 3-15 range, but the breadth is justified by covering accounts, assets, packs, demos, metadata, and usage. It feels comprehensive rather than bloated, and each tool serves a distinct function.

Completeness5/5

The surface covers the full asset lifecycle: account creation/verification, both upload methods, asset retrieval/search/update, pack creation/search, demo listing, and supporting metadata (categories, tags, licenses, AI models). No obvious missing operations like delete are required given the immutable design (assets cannot be changed after upload).

Maintenance

ActivityStale
ResponsivenessLimited data

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    D
    maintenance
    Enables AI assistants to search and retrieve metadata and download links for CC0 HDRIs, textures, and 3D models from PolyHaven's public library.
    6
    ISC
  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables a single AI-driven search across nine 3D asset sites (Sketchfab, Poly Haven, ambientCG, Poly Pizza, Kenney, Quaternius, Gazebo Fuel, NASA 3D Resources and Tripo) that returns one ranked list with each item's license and download cost, plus filters for commercial or CC0 use and asset type. Users can download the chosen model, texture, pack or HDRI with a credit file, with paid downloads guarded by an explicit cost confirmation and a daily credit cap.
    MIT