Server definition
- Hash
- sha256:023464de6efe11ddad8b190d514b44c9708e60f04e25dca9b9febe48f4c760cd
- What it is
- What a remote MCP server returned when asked what it offers: 29 tools
The blob, as servednamed by its sha256
{
"instructions": "3DLogo.io is a browser-based 3D logo maker. It makes 3D logos and 3D coins in the browser and turns photos or prompts into 3D meshes.\nUse build_logo_editor_link / build_coin_studio_link to hand the user a link that opens the studio already set up (text, material, lighting). Material ids come from list_materials; coin looks from list_coin_looks. Links open without an account. Exports on the free plan carry a small 3dlogo.io mark; Pro removes it and adds 4K stills and HD MP4. Generate runs on credits, from a Pro or Ultra plan or a one-time credit pack; get_plans has the ladder.\nFor an existing logo image: upload_logo_image stores it (an attached file, a public image_url, or small base64 image_data) and returns a styled editor link; request_logo_image_upload gives a one-shot PUT URL for a file on the user's machine; build_logo_editor_link with upload=true opens the editor on the upload panel when the file cannot be sent.\nThe account tools (projects, previews, share links, Generate) are listed but this connection is not signed in yet. Calling one makes the host ask the user to connect their 3DLogo.io account; after that the same call works. The catalogue and studio-link tools work now.",
"tools": [
{
"description": "Use when the user wants to see what is possible or pick a style before designing: the example looks (chrome, gold, glass, holographic, brushed metal, gradient, 3D text, animated), each with a rendered example image, what it is best for, the presets behind it, and an editor link that applies it. Works without an account. Do not use to get material ids for another tool; list_materials has the full catalogue.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {},
"type": "object"
},
"name": "browse_looks",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"looks": {
"items": {
"additionalProperties": false,
"properties": {
"bestFor": {
"items": {
"type": "string"
},
"type": "array"
},
"editorUrl": {
"description": "Opens the editor with the look applied",
"format": "uri",
"type": "string"
},
"guideUrl": {
"description": "The guide page for the look",
"format": "uri",
"type": "string"
},
"imageUrl": {
"description": "A render of the look",
"format": "uri",
"type": "string"
},
"name": {
"type": "string"
},
"presets": {
"items": {
"additionalProperties": false,
"properties": {
"editorUrl": {
"description": "Absolute https URL the user can open",
"format": "uri",
"type": "string"
},
"name": {
"type": "string"
},
"note": {
"type": "string"
}
},
"required": [
"name",
"note",
"editorUrl"
],
"type": "object"
},
"type": "array"
},
"slug": {
"type": "string"
},
"summary": {
"type": "string"
}
},
"required": [
"slug",
"name",
"summary",
"imageUrl",
"editorUrl",
"guideUrl",
"bestFor",
"presets"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"looks"
],
"type": "object"
}
},
{
"description": "Returns a link that opens the 3D coin studio with a mark struck into a coin. Looks: gold, chrome, silver, bronze. Works without an account.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"background": {
"description": "Hex colour, e.g. #1a1a1a",
"pattern": "^#[0-9a-fA-F]{6}$",
"type": "string"
},
"blank": {
"enum": [
"reeded",
"milled",
"smooth"
],
"type": "string"
},
"coinColor": {
"description": "Hex colour, e.g. #1a1a1a",
"pattern": "^#[0-9a-fA-F]{6}$",
"type": "string"
},
"environment": {
"description": "Lighting room",
"enum": [
"studio",
"sunset",
"dawn",
"night",
"warehouse",
"forest",
"apartment",
"city"
],
"type": "string"
},
"font": {
"enum": [
"outfit",
"oswald",
"montserrat",
"archivo",
"bebas",
"anton",
"russo",
"orbitron",
"blackops",
"pacifico"
],
"type": "string"
},
"logoColor": {
"description": "Hex colour, e.g. #1a1a1a",
"pattern": "^#[0-9a-fA-F]{6}$",
"type": "string"
},
"look": {
"enum": [
"gold",
"chrome",
"silver",
"bronze"
],
"type": "string"
},
"motion": {
"enum": [
"none",
"rotate",
"tumble",
"reveal",
"float",
"bounce"
],
"type": "string"
},
"text": {
"description": "The mark text, up to 24 characters",
"maxLength": 24,
"minLength": 1,
"type": "string"
}
},
"required": [
"text"
],
"type": "object"
},
"name": "build_coin_studio_link",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"text": {
"type": "string"
},
"url": {
"description": "Absolute https URL the user can open",
"format": "uri",
"type": "string"
}
},
"required": [
"url",
"text"
],
"type": "object"
}
},
{
"description": "Returns a link that opens the 3D logo editor already styled, from a wordmark (text), from a stored logo image (mark, see upload_logo_image), or on the upload panel (upload=true) when the person will drop the file themselves. Works without an account. Use list_materials for material ids.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"background": {
"description": "Hex colour, e.g. #1a1a1a",
"pattern": "^#[0-9a-fA-F]{6}$",
"type": "string"
},
"depth": {
"description": "Extrusion depth, default 30",
"maximum": 500,
"minimum": 1,
"type": "number"
},
"environment": {
"description": "Lighting room",
"enum": [
"studio",
"sunset",
"dawn",
"night",
"warehouse",
"forest",
"apartment",
"city"
],
"type": "string"
},
"font": {
"enum": [
"outfit",
"oswald",
"montserrat",
"archivo",
"bebas",
"anton",
"russo",
"orbitron",
"blackops",
"pacifico"
],
"type": "string"
},
"mark": {
"description": "Mark id from upload_logo_image or request_logo_image_upload",
"pattern": "^m[a-z0-9]{31}$",
"type": "string"
},
"material": {
"description": "Material id from list_materials (e.g. gold-clean-optimised)",
"type": "string"
},
"motion": {
"enum": [
"none",
"orbit",
"rotate",
"tumble",
"reveal",
"pulse"
],
"type": "string"
},
"text": {
"description": "The wordmark, up to 40 characters (omit when passing mark or upload)",
"maxLength": 40,
"minLength": 1,
"type": "string"
},
"upload": {
"description": "Open on the upload panel with the look prepared; the person drops their own file",
"type": "boolean"
}
},
"type": "object"
},
"name": "build_logo_editor_link",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"mark": {
"type": [
"string",
"null"
]
},
"material": {
"type": [
"string",
"null"
]
},
"text": {
"type": [
"string",
"null"
]
},
"upload": {
"type": "boolean"
},
"url": {
"description": "Absolute https URL the user can open",
"format": "uri",
"type": "string"
}
},
"required": [
"url",
"text",
"mark",
"upload",
"material"
],
"type": "object"
}
},
{
"description": "Saves a new 3D logo project from a mark stored with upload_logo_image or request_logo_image_upload, with a material and lighting, so it appears in the user's Projects. The image is traced into 3D the first time the project opens; open it once and save before publishing. Does not spend credits.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"background": {
"description": "Hex colour, e.g. #1a1a1a",
"pattern": "^#[0-9a-fA-F]{6}$",
"type": "string"
},
"depth": {
"description": "Extrusion depth, default 30",
"maximum": 500,
"minimum": 1,
"type": "number"
},
"environment": {
"description": "Lighting room",
"enum": [
"studio",
"sunset",
"dawn",
"night",
"warehouse",
"forest",
"apartment",
"city"
],
"type": "string"
},
"mark": {
"description": "Mark id from upload_logo_image or request_logo_image_upload",
"pattern": "^m[a-z0-9]{31}$",
"type": "string"
},
"material": {
"description": "Material id from list_materials (e.g. gold-clean-optimised)",
"type": "string"
},
"motion": {
"enum": [
"none",
"orbit",
"rotate",
"tumble",
"reveal",
"pulse"
],
"type": "string"
},
"title": {
"description": "Project name; defaults to the file name",
"maxLength": 200,
"minLength": 1,
"type": "string"
}
},
"required": [
"mark"
],
"type": "object"
},
"name": "create_image_logo_project",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"id": {
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
},
"inputType": {
"type": [
"string",
"null"
]
},
"isPublic": {
"type": "boolean"
},
"kind": {
"enum": [
"logo",
"coin",
"mesh"
],
"type": "string"
},
"kindLabel": {
"type": "string"
},
"mark": {
"type": "string"
},
"modelUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
],
"description": "Public GLB, for published meshes"
},
"note": {
"type": "string"
},
"shareUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
],
"description": "Public page, when published"
},
"thumbnailUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
],
"description": "Saved thumbnail; needs the owner's browser session"
},
"title": {
"type": "string"
},
"updatedAt": {
"description": "ISO 8601",
"type": [
"string",
"null"
]
},
"url": {
"description": "Opens the project in its studio",
"format": "uri",
"type": "string"
}
},
"required": [
"id",
"title",
"kind",
"kindLabel",
"inputType",
"isPublic",
"url",
"shareUrl",
"modelUrl",
"thumbnailUrl",
"updatedAt",
"mark",
"note"
],
"type": "object"
}
},
{
"description": "A link that lets a signed-in person join the project as an editor or viewer (up to 50 uses, 7 days). Owner only.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
},
"role": {
"default": "editor",
"enum": [
"editor",
"viewer"
],
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "create_invite_link",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"expiresAt": {
"type": "string"
},
"role": {
"enum": [
"editor",
"viewer"
],
"type": "string"
},
"url": {
"description": "Absolute https URL the user can open",
"format": "uri",
"type": "string"
}
},
"required": [
"url",
"role",
"expiresAt"
],
"type": "object"
}
},
{
"description": "Use when the user wants to send a saved design to someone, post it, or embed it on a site: returns the share page, the iframe embed snippet, the oEmbed endpoint and a poster image URL. Unlisted (default) works for anyone holding the link without making the project public; public makes the page indexable. Reuses the project's active link of the same visibility, so calling twice is safe. The project must have been opened and saved once. Owner only. Do not use to let someone edit; create_invite_link does that.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"allow_download": {
"default": true,
"description": "Let viewers download the file from the page",
"type": "boolean"
},
"id": {
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
},
"title": {
"description": "Title on the share page; defaults to the project title",
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"visibility": {
"default": "unlisted",
"enum": [
"unlisted",
"public"
],
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "create_share_link",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"allowDownload": {
"type": "boolean"
},
"createdAt": {
"type": "string"
},
"embedEnabled": {
"type": "boolean"
},
"embedHtml": {
"description": "Copy-paste iframe snippet with attribution",
"type": "string"
},
"embedUrl": {
"description": "The iframe source",
"format": "uri",
"type": "string"
},
"expiresAt": {
"type": [
"string",
"null"
]
},
"kind": {
"enum": [
"logo",
"coin",
"mesh"
],
"type": "string"
},
"modelUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
],
"description": "The GLB, for shares of generated meshes"
},
"oembedUrl": {
"description": "oEmbed endpoint for this share",
"format": "uri",
"type": "string"
},
"posterUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
],
"description": "Rendered still of the design, when one exists"
},
"projectId": {
"anyOf": [
{
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
},
{
"type": "null"
}
]
},
"status": {
"enum": [
"active",
"revoked",
"expired",
"removed"
],
"type": "string"
},
"title": {
"type": "string"
},
"token": {
"type": "string"
},
"url": {
"description": "The share page",
"format": "uri",
"type": "string"
},
"videoUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
],
"description": "Turntable MP4, when one has been rendered"
},
"viewCount": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"visibility": {
"enum": [
"unlisted",
"public"
],
"type": "string"
}
},
"required": [
"token",
"url",
"embedUrl",
"posterUrl",
"videoUrl",
"modelUrl",
"oembedUrl",
"embedHtml",
"kind",
"title",
"visibility",
"status",
"expiresAt",
"allowDownload",
"embedEnabled",
"viewCount",
"projectId",
"createdAt"
],
"type": "object"
}
},
{
"description": "Saves a new 3D logo project from a wordmark with a material and lighting, so it appears in the user's Projects and opens in the editor. Does not spend credits.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"background": {
"description": "Hex colour, e.g. #1a1a1a",
"pattern": "^#[0-9a-fA-F]{6}$",
"type": "string"
},
"depth": {
"maximum": 500,
"minimum": 1,
"type": "number"
},
"environment": {
"description": "Lighting room",
"enum": [
"studio",
"sunset",
"dawn",
"night",
"warehouse",
"forest",
"apartment",
"city"
],
"type": "string"
},
"font": {
"enum": [
"outfit",
"oswald",
"montserrat",
"archivo",
"bebas",
"anton",
"russo",
"orbitron",
"blackops",
"pacifico"
],
"type": "string"
},
"material": {
"description": "Material id from list_materials",
"type": "string"
},
"motion": {
"enum": [
"none",
"orbit",
"rotate",
"tumble",
"reveal",
"pulse"
],
"type": "string"
},
"text": {
"maxLength": 40,
"minLength": 1,
"type": "string"
},
"title": {
"description": "Project name; defaults to the text",
"maxLength": 200,
"minLength": 1,
"type": "string"
}
},
"required": [
"text"
],
"type": "object"
},
"name": "create_text_logo_project",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"id": {
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
},
"inputType": {
"type": [
"string",
"null"
]
},
"isPublic": {
"type": "boolean"
},
"kind": {
"enum": [
"logo",
"coin",
"mesh"
],
"type": "string"
},
"kindLabel": {
"type": "string"
},
"modelUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
],
"description": "Public GLB, for published meshes"
},
"note": {
"type": "string"
},
"shareUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
],
"description": "Public page, when published"
},
"thumbnailUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
],
"description": "Saved thumbnail; needs the owner's browser session"
},
"title": {
"type": "string"
},
"updatedAt": {
"description": "ISO 8601",
"type": [
"string",
"null"
]
},
"url": {
"description": "Opens the project in its studio",
"format": "uri",
"type": "string"
}
},
"required": [
"id",
"title",
"kind",
"kindLabel",
"inputType",
"isPublic",
"url",
"shareUrl",
"modelUrl",
"thumbnailUrl",
"updatedAt",
"note"
],
"type": "object"
}
},
{
"description": "Permanently deletes a saved project, its share page and invites. Confirm with the user first. Owner only.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"confirm": {
"const": true,
"description": "Must be true",
"type": "boolean"
},
"id": {
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
}
},
"required": [
"id",
"confirm"
],
"type": "object"
},
"name": "delete_project",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"deleted": {
"const": true,
"type": "boolean"
},
"id": {
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
}
},
"required": [
"id",
"deleted"
],
"type": "object"
}
},
{
"description": "Use when the user wants a variant without touching the original (\"a gold version of this one\"): copies a saved logo or coin project with its artwork, optionally under a new title; restyle the copy with update_project. Counts against the project cap. Does not spend credits.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
},
"title": {
"maxLength": 200,
"minLength": 1,
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "duplicate_project",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"id": {
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
},
"inputType": {
"type": [
"string",
"null"
]
},
"isPublic": {
"type": "boolean"
},
"kind": {
"enum": [
"logo",
"coin",
"mesh"
],
"type": "string"
},
"kindLabel": {
"type": "string"
},
"modelUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
],
"description": "Public GLB, for published meshes"
},
"shareUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
],
"description": "Public page, when published"
},
"thumbnailUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
],
"description": "Saved thumbnail; needs the owner's browser session"
},
"title": {
"type": "string"
},
"updatedAt": {
"description": "ISO 8601",
"type": [
"string",
"null"
]
},
"url": {
"description": "Opens the project in its studio",
"format": "uri",
"type": "string"
}
},
"required": [
"id",
"title",
"kind",
"kindLabel",
"inputType",
"isPublic",
"url",
"shareUrl",
"modelUrl",
"thumbnailUrl",
"updatedAt"
],
"type": "object"
}
},
{
"description": "Full detail for one project id returned by search (the ChatGPT fetch contract): a text summary, the opening URL and metadata.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "fetch",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"id": {
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
},
"metadata": {
"additionalProperties": false,
"properties": {
"isPublic": {
"type": "boolean"
},
"kind": {
"enum": [
"logo",
"coin",
"mesh"
],
"type": "string"
},
"modelUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
]
},
"shareUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"kind",
"isPublic",
"shareUrl",
"modelUrl"
],
"type": "object"
},
"text": {
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"description": "Absolute https URL the user can open",
"format": "uri",
"type": "string"
}
},
"required": [
"id",
"title",
"text",
"url",
"metadata"
],
"type": "object"
}
},
{
"description": "Starts an AI generate from a text prompt or a public image URL. Spends the user's credits (see quote_generation). Returns a run id to poll with get_generation_status.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"density": {
"default": "standard",
"enum": [
"fast",
"standard",
"pro",
"ultra"
],
"type": "string"
},
"image_url": {
"description": "For image mode: a public https image (PNG/JPEG/WebP)",
"format": "uri",
"type": "string"
},
"mode": {
"enum": [
"text",
"image"
],
"type": "string"
},
"prompt": {
"description": "For text mode",
"maxLength": 1024,
"type": "string"
},
"texture": {
"default": true,
"type": "boolean"
}
},
"required": [
"mode"
],
"type": "object"
},
"name": "generate_3d_model",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"creditsCharged": {
"type": "number"
},
"runId": {
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
},
"status": {
"type": "string"
},
"statusUrl": {
"description": "Absolute https URL the user can open",
"format": "uri",
"type": "string"
}
},
"required": [
"runId",
"status",
"creditsCharged",
"statusUrl"
],
"type": "object"
}
},
{
"description": "Use to know what the connected account can do before acting: plan, remaining Generate credits (period and purchased), project and share-link counts against their caps, and export limits. Read-only.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {},
"type": "object"
},
"name": "get_account",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"accountUrl": {
"description": "Absolute https URL the user can open",
"format": "uri",
"type": "string"
},
"canExportHdVideo": {
"type": "boolean"
},
"canUsePaidDensity": {
"type": "boolean"
},
"creditsExpireAt": {
"type": [
"string",
"null"
]
},
"creditsRemaining": {
"type": "number"
},
"creditsRollOver": {
"type": "boolean"
},
"email": {
"type": "string"
},
"exportWatermark": {
"type": "boolean"
},
"isPro": {
"type": "boolean"
},
"isUltra": {
"type": "boolean"
},
"maxImagePx": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"name": {
"type": [
"string",
"null"
]
},
"periodCreditsRemaining": {
"type": "number"
},
"plan": {
"type": "string"
},
"projectCount": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"projectLimit": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"purchasedCredits": {
"type": "number"
},
"purchasedCreditsExpireAt": {
"type": [
"string",
"null"
]
},
"shareLimit": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
}
},
"required": [
"name",
"email",
"plan",
"isPro",
"isUltra",
"creditsRemaining",
"periodCreditsRemaining",
"purchasedCredits",
"purchasedCreditsExpireAt",
"creditsRollOver",
"canUsePaidDensity",
"creditsExpireAt",
"projectCount",
"projectLimit",
"shareLimit",
"exportWatermark",
"canExportHdVideo",
"maxImagePx",
"accountUrl"
],
"type": "object"
}
},
{
"description": "Use once get_generation_status reports completed with hasPreview true: returns a signed URL of the provider's render of the mesh, valid for an hour, and the image inline when include_image_data is true (only on hosts that display image content). Do not use for saved logo or coin projects; get_project_preview covers those.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"include_image_data": {
"default": false,
"description": "Also return the image inline as image content",
"type": "boolean"
},
"run_id": {
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
}
},
"required": [
"run_id"
],
"type": "object"
},
"name": "get_generation_preview",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"bytes": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
},
"contentType": {
"type": "string"
},
"expiresAt": {
"description": "ISO 8601, when imageUrl stops working",
"type": "string"
},
"imageUrl": {
"description": "Signed image URL, valid about an hour; fetch or show it before then",
"format": "uri",
"type": "string"
},
"openUrl": {
"description": "The studio page for it",
"format": "uri",
"type": "string"
},
"runId": {
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
}
},
"required": [
"imageUrl",
"expiresAt",
"contentType",
"bytes",
"openUrl",
"runId"
],
"type": "object"
}
},
{
"description": "Status of a run started by generate_3d_model (or from the user's history). When completed, save it with save_generation_as_project.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"run_id": {
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
}
},
"required": [
"run_id"
],
"type": "object"
},
"name": "get_generation_status",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"creditsCharged": {
"type": [
"number",
"null"
]
},
"error": {
"type": [
"string",
"null"
]
},
"hasPreview": {
"description": "True once a render of the mesh exists; get_generation_preview returns it",
"type": "boolean"
},
"modelName": {
"type": "string"
},
"openUrl": {
"description": "The run in the Generate studio",
"format": "uri",
"type": "string"
},
"queuePosition": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
},
"refunded": {
"type": "boolean"
},
"runId": {
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
},
"status": {
"enum": [
"queued",
"processing",
"completed",
"failed",
"cancelled",
"expired"
],
"type": "string"
}
},
"required": [
"runId",
"status",
"modelName",
"queuePosition",
"creditsCharged",
"refunded",
"error",
"openUrl",
"hasPreview"
],
"type": "object"
}
},
{
"description": "Use when the user asks what is free, what Pro or Ultra add, or what a Generate run costs in credits: the plan features (exports, watermark, credits, saves) and the one-time credit packs, with what packs do and do not unlock. Read-only. Do not use to check the connected user's own plan; get_account does that.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {},
"type": "object"
},
"name": "get_plans",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"creditPackNotes": {
"items": {
"type": "string"
},
"type": "array"
},
"creditPacks": {
"items": {
"additionalProperties": false,
"properties": {
"credits": {
"type": "number"
},
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"priceUsd": {
"type": "number"
}
},
"required": [
"id",
"name",
"priceUsd",
"credits"
],
"type": "object"
},
"type": "array"
},
"free": {
"items": {
"additionalProperties": false,
"properties": {
"included": {
"type": "boolean"
},
"label": {
"type": "string"
}
},
"required": [
"label",
"included"
],
"type": "object"
},
"type": "array"
},
"pricingUrl": {
"description": "Absolute https URL the user can open",
"format": "uri",
"type": "string"
},
"pro": {
"additionalProperties": false,
"properties": {
"features": {
"items": {
"additionalProperties": false,
"properties": {
"included": {
"type": "boolean"
},
"label": {
"type": "string"
}
},
"required": [
"label",
"included"
],
"type": "object"
},
"type": "array"
},
"priceUsd": {
"additionalProperties": false,
"properties": {
"monthly": {
"additionalProperties": false,
"properties": {
"amountUsd": {
"type": "number"
},
"label": {
"type": "string"
},
"period": {
"type": "string"
}
},
"required": [
"amountUsd",
"label",
"period"
],
"type": "object"
},
"yearly": {
"additionalProperties": false,
"properties": {
"amountUsd": {
"type": "number"
},
"label": {
"type": "string"
},
"monthlyEquivalent": {
"type": "string"
},
"period": {
"type": "string"
}
},
"required": [
"amountUsd",
"label",
"period",
"monthlyEquivalent"
],
"type": "object"
}
},
"required": [
"monthly",
"yearly"
],
"type": "object"
}
},
"required": [
"priceUsd",
"features"
],
"type": "object"
},
"ultra": {
"additionalProperties": false,
"properties": {
"features": {
"items": {
"additionalProperties": false,
"properties": {
"included": {
"type": "boolean"
},
"label": {
"type": "string"
}
},
"required": [
"label",
"included"
],
"type": "object"
},
"type": "array"
},
"priceUsd": {
"additionalProperties": false,
"properties": {
"monthly": {
"additionalProperties": false,
"properties": {
"amountUsd": {
"type": "number"
},
"label": {
"type": "string"
},
"period": {
"type": "string"
}
},
"required": [
"amountUsd",
"label",
"period"
],
"type": "object"
},
"yearly": {
"additionalProperties": false,
"properties": {
"amountUsd": {
"type": "number"
},
"label": {
"type": "string"
},
"monthlyEquivalent": {
"type": "string"
},
"period": {
"type": "string"
}
},
"required": [
"amountUsd",
"label",
"period",
"monthlyEquivalent"
],
"type": "object"
}
},
"required": [
"monthly",
"yearly"
],
"type": "object"
}
},
"required": [
"priceUsd",
"features"
],
"type": "object"
}
},
"required": [
"free",
"pro",
"ultra",
"creditPacks",
"creditPackNotes",
"pricingUrl"
],
"type": "object"
}
},
{
"description": "Details and links for one saved project by id: where it opens, its public page if published, the GLB for meshes, and with include_config the saved workspace settings (material, lighting, motion). For a picture of it, call get_project_preview.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
},
"include_config": {
"default": false,
"description": "Also return the saved workspace config (large)",
"type": "boolean"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_project",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"accessRole": {
"type": "string"
},
"canEdit": {
"type": "boolean"
},
"config": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"hasArtwork": {
"description": "False until the project has been opened and saved once in the studio",
"type": "boolean"
},
"id": {
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
},
"inputType": {
"type": [
"string",
"null"
]
},
"isPublic": {
"type": "boolean"
},
"kind": {
"enum": [
"logo",
"coin",
"mesh"
],
"type": "string"
},
"kindLabel": {
"type": "string"
},
"modelUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
],
"description": "Public GLB, for published meshes"
},
"shareUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
],
"description": "Public page, when published"
},
"thumbnailUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
],
"description": "Saved thumbnail; needs the owner's browser session"
},
"title": {
"type": "string"
},
"updatedAt": {
"description": "ISO 8601",
"type": [
"string",
"null"
]
},
"url": {
"description": "Opens the project in its studio",
"format": "uri",
"type": "string"
}
},
"required": [
"id",
"title",
"kind",
"kindLabel",
"inputType",
"isPublic",
"url",
"shareUrl",
"modelUrl",
"thumbnailUrl",
"updatedAt",
"accessRole",
"canEdit",
"hasArtwork"
],
"type": "object"
}
},
{
"description": "Use when the user wants to see a saved project, or you need to describe it: returns a signed URL of the studio's last saved render, valid for an hour, and the PNG inline when include_image_data is true (only on hosts that display image content; elsewhere it costs many tokens for nothing). Nothing to show until the project has been opened and saved once. Do not use for Generate runs; get_generation_preview covers those.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
},
"include_image_data": {
"default": false,
"description": "Also return the image inline as image content",
"type": "boolean"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_project_preview",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"bytes": {
"anyOf": [
{
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
},
"contentType": {
"type": "string"
},
"expiresAt": {
"description": "ISO 8601, when imageUrl stops working",
"type": "string"
},
"imageUrl": {
"description": "Signed image URL, valid about an hour; fetch or show it before then",
"format": "uri",
"type": "string"
},
"openUrl": {
"description": "The studio page for it",
"format": "uri",
"type": "string"
},
"projectId": {
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
}
},
"required": [
"imageUrl",
"expiresAt",
"contentType",
"bytes",
"openUrl",
"projectId"
],
"type": "object"
}
},
{
"description": "Use before build_coin_studio_link or a coin restyle: the preset looks (gold, chrome, silver, bronze), blank edges (reeded, milled, smooth), motions, lighting rooms and fonts the coin studio accepts. Read-only, no account needed.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {},
"type": "object"
},
"name": "list_coin_looks",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"blanks": {
"items": {
"additionalProperties": false,
"properties": {
"hint": {
"type": "string"
},
"id": {
"type": "string"
},
"label": {
"type": "string"
}
},
"required": [
"id",
"label",
"hint"
],
"type": "object"
},
"type": "array"
},
"environments": {
"items": {
"type": "string"
},
"type": "array"
},
"fonts": {
"items": {
"type": "string"
},
"type": "array"
},
"looks": {
"items": {
"additionalProperties": false,
"properties": {
"coinColor": {
"type": "string"
},
"id": {
"type": "string"
},
"label": {
"type": "string"
},
"logoColor": {
"type": "string"
}
},
"required": [
"id",
"label",
"coinColor",
"logoColor"
],
"type": "object"
},
"type": "array"
},
"motions": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"looks",
"blanks",
"motions",
"environments",
"fonts"
],
"type": "object"
}
},
{
"description": "Use to find an earlier Generate run (to check, preview or save it): the recent runs with status, prompt and whether a render exists, newest first. Read-only.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"default": 12,
"maximum": 24,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"name": "list_generations",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"runs": {
"items": {
"additionalProperties": false,
"properties": {
"createdAt": {
"type": [
"string",
"null"
]
},
"hasPreview": {
"type": "boolean"
},
"mode": {
"type": "string"
},
"modelName": {
"type": "string"
},
"openUrl": {
"description": "Absolute https URL the user can open",
"format": "uri",
"type": "string"
},
"prompt": {
"type": [
"string",
"null"
]
},
"runId": {
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
},
"status": {
"type": "string"
}
},
"required": [
"runId",
"mode",
"status",
"prompt",
"modelName",
"createdAt",
"hasPreview",
"openUrl"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"runs"
],
"type": "object"
}
},
{
"description": "Use when you need a material id: the presets the 3D logo editor renders (chrome, gold, glass, holographic, neon, clay, wood...), each with its category and whether it needs Pro. Ids are exact strings for build_logo_editor_link, create_text_logo_project and update_project. Do not use to show the user what a look is like; browse_looks has example images.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"category": {
"description": "Only this category",
"enum": [
"chrome",
"gold",
"abstract",
"holographic",
"metal",
"gradient",
"glass",
"plastic",
"clay",
"neon",
"fabric",
"composite",
"wood",
"stone",
"enamel",
"anodized"
],
"type": "string"
}
},
"type": "object"
},
"name": "list_materials",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"categories": {
"additionalProperties": {
"type": "string"
},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"materials": {
"items": {
"additionalProperties": false,
"properties": {
"category": {
"type": "string"
},
"categoryLabel": {
"type": "string"
},
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"pro": {
"type": "boolean"
}
},
"required": [
"id",
"name",
"category",
"categoryLabel",
"pro"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"materials",
"categories"
],
"type": "object"
}
},
{
"description": "The user's saved logos, coins and generated meshes, newest first. Optional title search and kind filter.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"kind": {
"enum": [
"logo",
"coin",
"mesh"
],
"type": "string"
},
"page": {
"default": 1,
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"query": {
"description": "Match against the title",
"maxLength": 40,
"type": "string"
}
},
"type": "object"
},
"name": "list_projects",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"page": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"projects": {
"items": {
"additionalProperties": false,
"properties": {
"id": {
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
},
"inputType": {
"type": [
"string",
"null"
]
},
"isPublic": {
"type": "boolean"
},
"kind": {
"enum": [
"logo",
"coin",
"mesh"
],
"type": "string"
},
"kindLabel": {
"type": "string"
},
"modelUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
],
"description": "Public GLB, for published meshes"
},
"shareUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
],
"description": "Public page, when published"
},
"thumbnailUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
],
"description": "Saved thumbnail; needs the owner's browser session"
},
"title": {
"type": "string"
},
"updatedAt": {
"description": "ISO 8601",
"type": [
"string",
"null"
]
},
"url": {
"description": "Opens the project in its studio",
"format": "uri",
"type": "string"
}
},
"required": [
"id",
"title",
"kind",
"kindLabel",
"inputType",
"isPublic",
"url",
"shareUrl",
"modelUrl",
"thumbnailUrl",
"updatedAt"
],
"type": "object"
},
"type": "array"
},
"total": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"totalPages": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
}
},
"required": [
"projects",
"total",
"page",
"totalPages"
],
"type": "object"
}
},
{
"description": "The account's active share links, or one project's when id is given, each with page, embed and poster URLs and a view count.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"id": {
"description": "Only this project's links",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
}
},
"type": "object"
},
"name": "list_share_links",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"shares": {
"items": {
"additionalProperties": false,
"properties": {
"allowDownload": {
"type": "boolean"
},
"createdAt": {
"type": "string"
},
"embedEnabled": {
"type": "boolean"
},
"embedHtml": {
"description": "Copy-paste iframe snippet with attribution",
"type": "string"
},
"embedUrl": {
"description": "The iframe source",
"format": "uri",
"type": "string"
},
"expiresAt": {
"type": [
"string",
"null"
]
},
"kind": {
"enum": [
"logo",
"coin",
"mesh"
],
"type": "string"
},
"modelUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
],
"description": "The GLB, for shares of generated meshes"
},
"oembedUrl": {
"description": "oEmbed endpoint for this share",
"format": "uri",
"type": "string"
},
"posterUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
],
"description": "Rendered still of the design, when one exists"
},
"projectId": {
"anyOf": [
{
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
},
{
"type": "null"
}
]
},
"status": {
"enum": [
"active",
"revoked",
"expired",
"removed"
],
"type": "string"
},
"title": {
"type": "string"
},
"token": {
"type": "string"
},
"url": {
"description": "The share page",
"format": "uri",
"type": "string"
},
"videoUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
],
"description": "Turntable MP4, when one has been rendered"
},
"viewCount": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"visibility": {
"enum": [
"unlisted",
"public"
],
"type": "string"
}
},
"required": [
"token",
"url",
"embedUrl",
"posterUrl",
"videoUrl",
"modelUrl",
"oembedUrl",
"embedHtml",
"kind",
"title",
"visibility",
"status",
"expiresAt",
"allowDownload",
"embedEnabled",
"viewCount",
"projectId",
"createdAt"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"shares"
],
"type": "object"
}
},
{
"description": "Use before generate_3d_model so the user knows the cost: the credits a text or image run charges at a density. Read-only, spends nothing.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"density": {
"default": "standard",
"enum": [
"fast",
"standard",
"pro",
"ultra"
],
"type": "string"
},
"mode": {
"enum": [
"text",
"image"
],
"type": "string"
}
},
"required": [
"mode"
],
"type": "object"
},
"name": "quote_generation",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"density": {
"enum": [
"fast",
"standard",
"pro",
"ultra"
],
"type": "string"
},
"mode": {
"enum": [
"text",
"image"
],
"type": "string"
},
"quote": {
"description": "Credits the run will charge",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
}
},
"required": [
"mode",
"density",
"quote"
],
"type": "object"
}
},
{
"description": "For a logo file on the user's machine that cannot be sent inside a tool call: returns a mark id and a one-shot HTTPS PUT URL. Upload the raw file bytes to it (for example `curl -T logo.png \"<uploadUrl>\"`), then call build_logo_editor_link with the mark id (or create_image_logo_project when signed in). Accepts PNG, JPEG, GIF, WebP (8 MB) and SVG (1 MB).",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"file_name": {
"description": "The file name, used as the project title later",
"maxLength": 120,
"type": "string"
}
},
"type": "object"
},
"name": "request_logo_image_upload",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"accept": {
"items": {
"type": "string"
},
"type": "array"
},
"example": {
"type": "string"
},
"markId": {
"type": "string"
},
"maxBytes": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"maxSvgBytes": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"method": {
"const": "PUT",
"type": "string"
},
"next": {
"type": "string"
},
"uploadUrl": {
"description": "Absolute https URL the user can open",
"format": "uri",
"type": "string"
}
},
"required": [
"markId",
"uploadUrl",
"method",
"accept",
"maxBytes",
"maxSvgBytes",
"example",
"next"
],
"type": "object"
}
},
{
"description": "Turns a share link off by token: the page, the embed and the poster stop serving within minutes. Cannot be undone; create_share_link makes a fresh one. Owner only.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"token": {
"pattern": "^[A-Za-z0-9_-]{22}$",
"type": "string"
}
},
"required": [
"token"
],
"type": "object"
},
"name": "revoke_share_link",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"allowDownload": {
"type": "boolean"
},
"createdAt": {
"type": "string"
},
"embedEnabled": {
"type": "boolean"
},
"embedHtml": {
"description": "Copy-paste iframe snippet with attribution",
"type": "string"
},
"embedUrl": {
"description": "The iframe source",
"format": "uri",
"type": "string"
},
"expiresAt": {
"type": [
"string",
"null"
]
},
"kind": {
"enum": [
"logo",
"coin",
"mesh"
],
"type": "string"
},
"modelUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
],
"description": "The GLB, for shares of generated meshes"
},
"oembedUrl": {
"description": "oEmbed endpoint for this share",
"format": "uri",
"type": "string"
},
"posterUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
],
"description": "Rendered still of the design, when one exists"
},
"projectId": {
"anyOf": [
{
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
},
{
"type": "null"
}
]
},
"status": {
"enum": [
"active",
"revoked",
"expired",
"removed"
],
"type": "string"
},
"title": {
"type": "string"
},
"token": {
"type": "string"
},
"url": {
"description": "The share page",
"format": "uri",
"type": "string"
},
"videoUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
],
"description": "Turntable MP4, when one has been rendered"
},
"viewCount": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"visibility": {
"enum": [
"unlisted",
"public"
],
"type": "string"
}
},
"required": [
"token",
"url",
"embedUrl",
"posterUrl",
"videoUrl",
"modelUrl",
"oembedUrl",
"embedHtml",
"kind",
"title",
"visibility",
"status",
"expiresAt",
"allowDownload",
"embedEnabled",
"viewCount",
"projectId",
"createdAt"
],
"type": "object"
}
},
{
"description": "Keeps a completed run in Projects (idempotent per run). With public=true it is also published, which gives a share page and a public GLB URL the user can download.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"public": {
"default": false,
"type": "boolean"
},
"run_id": {
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
},
"title": {
"maxLength": 200,
"minLength": 1,
"type": "string"
}
},
"required": [
"run_id"
],
"type": "object"
},
"name": "save_generation_as_project",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"id": {
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
},
"inputType": {
"type": [
"string",
"null"
]
},
"isPublic": {
"type": "boolean"
},
"kind": {
"enum": [
"logo",
"coin",
"mesh"
],
"type": "string"
},
"kindLabel": {
"type": "string"
},
"modelUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
],
"description": "Public GLB, for published meshes"
},
"shareUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
],
"description": "Public page, when published"
},
"thumbnailUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
],
"description": "Saved thumbnail; needs the owner's browser session"
},
"title": {
"type": "string"
},
"updatedAt": {
"description": "ISO 8601",
"type": [
"string",
"null"
]
},
"url": {
"description": "Opens the project in its studio",
"format": "uri",
"type": "string"
}
},
"required": [
"id",
"title",
"kind",
"kindLabel",
"inputType",
"isPublic",
"url",
"shareUrl",
"modelUrl",
"thumbnailUrl",
"updatedAt"
],
"type": "object"
}
},
{
"description": "Searches the user's saved projects by title and returns ids with links (the ChatGPT search contract). Use fetch for the detail of one result; list_projects for browsing with filters.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"query": {
"maxLength": 40,
"minLength": 1,
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "search",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"results": {
"items": {
"additionalProperties": false,
"properties": {
"id": {
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"description": "Absolute https URL the user can open",
"format": "uri",
"type": "string"
}
},
"required": [
"id",
"title",
"url"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"results"
],
"type": "object"
}
},
{
"description": "Use when the user wants an existing project changed without opening the studio: its title, whether it is public (a public project has a share page and, for meshes, a public GLB URL), and on logo and coin projects the style: material, lighting room, background, motion, depth, font, the wordmark on text projects; on coins also the look, coin and mark colours, and the blank edge. Only the fields given change. Making a project public needs a saved render. Style changes render the next time the project is opened and saved. Do not use for a share link that keeps the project private (create_share_link) or to make something new (create_text_logo_project, duplicate_project).",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"background": {
"description": "Hex colour, e.g. #1a1a1a",
"pattern": "^#[0-9a-fA-F]{6}$",
"type": "string"
},
"blank": {
"description": "Coin projects: the edge",
"enum": [
"reeded",
"milled",
"smooth"
],
"type": "string"
},
"coin_color": {
"description": "Coin projects: the coin body",
"pattern": "^#[0-9a-fA-F]{6}$",
"type": "string"
},
"depth": {
"description": "Extrusion depth; logo projects",
"maximum": 500,
"minimum": 1,
"type": "number"
},
"environment": {
"description": "Lighting room",
"enum": [
"studio",
"sunset",
"dawn",
"night",
"warehouse",
"forest",
"apartment",
"city"
],
"type": "string"
},
"font": {
"enum": [
"outfit",
"oswald",
"montserrat",
"archivo",
"bebas",
"anton",
"russo",
"orbitron",
"blackops",
"pacifico"
],
"type": "string"
},
"id": {
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
},
"logo_color": {
"description": "Coin projects: the struck mark",
"pattern": "^#[0-9a-fA-F]{6}$",
"type": "string"
},
"look": {
"description": "Coin projects",
"enum": [
"gold",
"chrome",
"silver",
"bronze"
],
"type": "string"
},
"material": {
"description": "Material id from list_materials; logo projects",
"type": "string"
},
"motion": {
"enum": [
"none",
"orbit",
"rotate",
"tumble",
"reveal",
"pulse",
"float",
"bounce"
],
"type": "string"
},
"public": {
"description": "Turn the public page on or off; owner only",
"type": "boolean"
},
"text": {
"description": "New wordmark; text projects only (coins: 24 characters)",
"maxLength": 40,
"minLength": 1,
"type": "string"
},
"title": {
"description": "New project title",
"maxLength": 200,
"minLength": 1,
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "update_project",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"changed": {
"items": {
"type": "string"
},
"type": "array"
},
"id": {
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
},
"inputType": {
"type": [
"string",
"null"
]
},
"isPublic": {
"type": "boolean"
},
"kind": {
"enum": [
"logo",
"coin",
"mesh"
],
"type": "string"
},
"kindLabel": {
"type": "string"
},
"modelUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
],
"description": "Public GLB, for published meshes"
},
"note": {
"type": "string"
},
"shareUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
],
"description": "Public page, when published"
},
"thumbnailUrl": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
],
"description": "Saved thumbnail; needs the owner's browser session"
},
"title": {
"type": "string"
},
"updatedAt": {
"description": "ISO 8601",
"type": [
"string",
"null"
]
},
"url": {
"description": "Opens the project in its studio",
"format": "uri",
"type": "string"
}
},
"required": [
"id",
"title",
"kind",
"kindLabel",
"inputType",
"isPublic",
"url",
"shareUrl",
"modelUrl",
"thumbnailUrl",
"updatedAt",
"changed",
"note"
],
"type": "object"
}
},
{
"description": "Stores a logo image (PNG, JPEG, GIF, WebP up to 8 MB; SVG up to 1 MB) so the 3D logo editor can extrude it, and returns a mark id plus an editor link already styled. Give exactly one source: image (a file the user attached in chat), image_url (a public https link to the image file itself, not a page), or image_data (a base64 data URL, small files only). Marks expire after 7 days. For a file on the user's own machine use request_logo_image_upload instead.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"background": {
"description": "Hex colour, e.g. #1a1a1a",
"pattern": "^#[0-9a-fA-F]{6}$",
"type": "string"
},
"depth": {
"description": "Extrusion depth, default 30",
"maximum": 500,
"minimum": 1,
"type": "number"
},
"environment": {
"description": "Lighting room",
"enum": [
"studio",
"sunset",
"dawn",
"night",
"warehouse",
"forest",
"apartment",
"city"
],
"type": "string"
},
"file_name": {
"description": "Shown in the editor; defaults to the file name",
"maxLength": 120,
"type": "string"
},
"image": {
"description": "The image the user attached in chat",
"properties": {
"download_url": {
"description": "Temporary download URL for the attached file",
"format": "uri",
"type": "string"
},
"file_id": {
"description": "The host's file id",
"minLength": 1,
"type": "string"
},
"file_name": {
"type": "string"
},
"mime_type": {
"type": "string"
}
},
"required": [
"download_url",
"file_id"
],
"type": "object"
},
"image_data": {
"description": "data:image/png;base64,... for small images only; most hosts cap this well under 1 MB",
"maxLength": 3000000,
"type": "string"
},
"image_url": {
"description": "Public https URL of the image file",
"format": "uri",
"maxLength": 2048,
"type": "string"
},
"material": {
"description": "Material id from list_materials (e.g. gold-clean-optimised)",
"type": "string"
},
"motion": {
"enum": [
"none",
"orbit",
"rotate",
"tumble",
"reveal",
"pulse"
],
"type": "string"
}
},
"type": "object"
},
"name": "upload_logo_image",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"bytes": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"contentType": {
"type": "string"
},
"editorUrl": {
"description": "Absolute https URL the user can open",
"format": "uri",
"type": "string"
},
"expiresAt": {
"type": "string"
},
"fileName": {
"type": "string"
},
"markId": {
"type": "string"
},
"material": {
"type": [
"string",
"null"
]
}
},
"required": [
"markId",
"editorUrl",
"contentType",
"bytes",
"fileName",
"expiresAt",
"material"
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:023464de6efe11ddad8b190d514b44c9708e60f04e25dca9b9febe48f4c760cd | sha256sum