The API and MCP server
Agents and scripts can search the models, download their files and get the credit line. No key, no account, no rate card.
Connect an agent
The MCP server speaks Streamable HTTP at https://cozu.xyz/mcp. In Claude Code:
claude mcp add --transport http cozu https://cozu.xyz/mcp
In clients configured with JSON (Claude Desktop, Cursor, VS Code and others):
{
"mcpServers": {
"cozu": {
"type": "http",
"url": "https://cozu.xyz/mcp"
}
}
}Tools
| Tool | Arguments | What it returns |
|---|---|---|
search_assets | query, category, format, limit | Finds models by words, category (vehicles, props...) and format (GLB, OBJ). Returns each match with its page, licence, credit line and main downloads. |
get_asset | id | The full record of one model: every file with its URL, size and SHA-256, the stats, previews and the credit line. |
get_attribution | id, format | The credit line to add to your project, as text, HTML or Markdown. |
list_categories | none | The categories with how many models each holds. |
An agent that adds a model to a project should also add its credit line to the project's credits, for example a CREDITS.md file. get_attribution returns it ready to paste.
JSON API
Plain HTTPS with open CORS, so it works from a browser too. Base URL https://cozu.xyz.
| Request | Returns |
|---|---|
GET /api/v1/assets.json | The whole catalog: every model as a full record. |
GET /api/v1/assets/{id}.json | One model, for example /api/v1/assets/ravenhall-tractor.json. |
GET /api/v1/search?q=truck&category=vehicles&format=GLB&limit=10 | Search, the same as the MCP tool. |
GET /api/v1/openapi.json | The OpenAPI 3.1 description of these endpoints. |
GET /assets/{id}.md | A model's page as Markdown. |
GET /llms.txt | A short index for language models; /llms-full.txt holds every record. |
curl -s https://cozu.xyz/api/v1/assets/ravenhall-tractor.json
Downloading files
Every file URL in a record is a direct download from Cozu's storage: no redirects through the site and no sign-in. Each file lists its size in bytes and its SHA-256, so a script can check what it got. A model's files never change under the same version number; a fix ships as a new version with its own URLs.
Fair use
There is no key and no hard limit. Cache the catalog rather than fetching it on every request, and download a package once rather than per build.