Servers Playground How we check Submit a server

3DLogo.io

Working · 3.0 s

io.github.cottom/3dlogov1.3.0

3DLogo.io, a browser 3D logo maker: 3D logos, 3D coins, 3D models from photos or prompts, embeds.

Design & Creative

Website Registry entry

Try it

Call this server's tools from your browser. Nothing to install.

https://3dlogo.io/api/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

browse_looks

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.

This tool takes no arguments.

3DLogo.io MCP server | mcptry

Tools (29)

browse_looks

read-only

No arguments.

Input schema (JSON)

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

build_coin_studio_link

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.

read-only

Argument	Type	Description
font	string
look	string
text*	string	The mark text, up to 24 characters
blank	string
motion	string
coinColor	string	Hex colour, e.g. #1a1a1a
logoColor	string	Hex colour, e.g. #1a1a1a
background	string	Hex colour, e.g. #1a1a1a
environment	string	Lighting room

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "text"
  ],
  "properties": {
    "font": {
      "enum": [
        "outfit",
        "oswald",
        "montserrat",
        "archivo",
        "bebas",
        "anton",
        "russo",
        "orbitron",
        "blackops",
        "pacifico"
      ],
      "type": "string"
    },
    "look": {
      "enum": [
        "gold",
        "chrome",
        "silver",
        "bronze"
      ],
      "type": "string"
    },
    "text": {
      "type": "string",
      "maxLength": 24,
      "minLength": 1,
      "description": "The mark text, up to 24 characters"
    },
    "blank": {
      "enum": [
        "reeded",
        "milled",
        "smooth"
      ],
      "type": "string"
    },
    "motion": {
      "enum": [
        "none",
        "rotate",
        "tumble",
        "reveal",
        "float",
        "bounce"
      ],
      "type": "string"
    },
    "coinColor": {
      "type": "string",
      "pattern": "^#[0-9a-fA-F]{6}$",
      "description": "Hex colour, e.g. #1a1a1a"
    },
    "logoColor": {
      "type": "string",
      "pattern": "^#[0-9a-fA-F]{6}$",
      "description": "Hex colour, e.g. #1a1a1a"
    },
    "background": {
      "type": "string",
      "pattern": "^#[0-9a-fA-F]{6}$",
      "description": "Hex colour, e.g. #1a1a1a"
    },
    "environment": {
      "enum": [
        "studio",
        "sunset",
        "dawn",
        "night",
        "warehouse",
        "forest",
        "apartment",
        "city"
      ],
      "type": "string",
      "description": "Lighting room"
    }
  }
}

build_logo_editor_link

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.

read-only

Argument	Type	Description
font	string
mark	string	Mark id from upload_logo_image or request_logo_image_upload
text	string	The wordmark, up to 40 characters (omit when passing mark or upload)
depth	number	Extrusion depth, default 30
motion	string
upload	boolean	Open on the upload panel with the look prepared; the person drops their own file
material	string	Material id from list_materials (e.g. gold-clean-optimised)
background	string	Hex colour, e.g. #1a1a1a
environment	string

create_image_logo_project

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.

Argument	Type	Description
mark*	string	Mark id from upload_logo_image or request_logo_image_upload
depth	number	Extrusion depth, default 30
title	string	Project name; defaults to the file name
motion	string
material	string	Material id from list_materials (e.g. gold-clean-optimised)
background	string	Hex colour, e.g. #1a1a1a
environment	string	Lighting room

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "mark"
  ],
  "properties": {
    "mark": {
      "type": "string",
      "pattern": "^m[a-z0-9]{31}$",
      "description": "Mark id from upload_logo_image or request_logo_image_upload"
    },
    "depth": {
      "type": "number",
      "maximum": 500,
      "minimum": 1,
      "description": "Extrusion depth, default 30"
    },
    "title": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Project name; defaults to the file name"
    },
    "motion": {
      "enum": [
        "none",
        "orbit",
        "rotate",
        "tumble",
        "reveal",
        "pulse"
      ],
      "type": "string"
    },
    "material": {
      "type": "string",
      "description": "Material id from list_materials (e.g. gold-clean-optimised)"
    },
    "background": {
      "type": "string",
      "pattern": "^#[0-9a-fA-F]{6}$",
      "description": "Hex colour, e.g. #1a1a1a"
    },
    "environment": {
      "enum": [
        "studio",
        "sunset",
        "dawn",
        "night",
        "warehouse",
        "forest",
        "apartment",
        "city"
      ],
      "type": "string",
      "description": "Lighting room"
    }
  }
}

create_invite_link

A link that lets a signed-in person join the project as an editor or viewer (up to 50 uses, 7 days). Owner only.

Argument	Type	Description
id*	string
role	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "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)$"
    },
    "role": {
      "enum": [
        "editor",
        "viewer"
      ],
      "type": "string",
      "default": "editor"
    }
  }
}

create_share_link

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.

Argument	Type	Description
id*	string
title	string	Title on the share page; defaults to the project title
visibility	string
allow_download	boolean	Let viewers download the file from the page

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "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)$"
    },
    "title": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Title on the share page; defaults to the project title"
    },
    "visibility": {
      "enum": [
        "unlisted",
        "public"
      ],
      "type": "string",
      "default": "unlisted"
    },
    "allow_download": {
      "type": "boolean",
      "default": true,
      "description": "Let viewers download the file from the page"
    }
  }
}

create_text_logo_project

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.

Argument	Type	Description
font	string
text*	string
depth	number
title	string	Project name; defaults to the text
motion	string
material	string	Material id from list_materials
background	string	Hex colour, e.g. #1a1a1a
environment	string	Lighting room

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "text"
  ],
  "properties": {
    "font": {
      "enum": [
        "outfit",
        "oswald",
        "montserrat",
        "archivo",
        "bebas",
        "anton",
        "russo",
        "orbitron",
        "blackops",
        "pacifico"
      ],
      "type": "string"
    },
    "text": {
      "type": "string",
      "maxLength": 40,
      "minLength": 1
    },
    "depth": {
      "type": "number",
      "maximum": 500,
      "minimum": 1
    },
    "title": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Project name; defaults to the text"
    },
    "motion": {
      "enum": [
        "none",
        "orbit",
        "rotate",
        "tumble",
        "reveal",
        "pulse"
      ],
      "type": "string"
    },
    "material": {
      "type": "string",
      "description": "Material id from list_materials"
    },
    "background": {
      "type": "string",
      "pattern": "^#[0-9a-fA-F]{6}$",
      "description": "Hex colour, e.g. #1a1a1a"
    },
    "environment": {
      "enum": [
        "studio",
        "sunset",
        "dawn",
        "night",
        "warehouse",
        "forest",
        "apartment",
        "city"
      ],
      "type": "string",
      "description": "Lighting room"
    }
  }
}

delete_project

Permanently deletes a saved project, its share page and invites. Confirm with the user first. Owner only.

destructive

Argument	Type	Description
id*	string
confirm*	boolean	Must be true

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id",
    "confirm"
  ],
  "properties": {
    "id": {
      "type": "string",
      "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)$"
    },
    "confirm": {
      "type": "boolean",
      "const": true,
      "description": "Must be true"
    }
  }
}

duplicate_project

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.

Argument	Type	Description
id*	string
title	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "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)$"
    },
    "title": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1
    }
  }
}

fetch

Full detail for one project id returned by search (the ChatGPT fetch contract): a text summary, the opening URL and metadata.

read-only

Argument	Type	Description
id*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "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)$"
    }
  }
}

generate_3d_model

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.

Argument	Type	Description
mode*	string
prompt	string	For text mode
density	string
texture	boolean
image_url	string	For image mode: a public https image (PNG/JPEG/WebP)

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "mode"
  ],
  "properties": {
    "mode": {
      "enum": [
        "text",
        "image"
      ],
      "type": "string"
    },
    "prompt": {
      "type": "string",
      "maxLength": 1024,
      "description": "For text mode"
    },
    "density": {
      "enum": [
        "fast",
        "standard",
        "pro",
        "ultra"
      ],
      "type": "string",
      "default": "standard"
    },
    "texture": {
      "type": "boolean",
      "default": true
    },
    "image_url": {
      "type": "string",
      "format": "uri",
      "description": "For image mode: a public https image (PNG/JPEG/WebP)"
    }
  }
}

get_account

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.

read-only

No arguments.

Input schema (JSON)

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

get_generation_preview

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.

read-only

Argument	Type	Description
run_id*	string
include_image_data	boolean	Also return the image inline as image content

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "run_id"
  ],
  "properties": {
    "run_id": {
      "type": "string",
      "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)$"
    },
    "include_image_data": {
      "type": "boolean",
      "default": false,
      "description": "Also return the image inline as image content"
    }
  }
}

get_generation_status

Status of a run started by generate_3d_model (or from the user's history). When completed, save it with save_generation_as_project.

read-only

Argument	Type	Description
run_id*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "run_id"
  ],
  "properties": {
    "run_id": {
      "type": "string",
      "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)$"
    }
  }
}

get_plans

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.

read-only

No arguments.

Input schema (JSON)

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

get_project

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.

read-only

Argument	Type	Description
id*	string
include_config	boolean	Also return the saved workspace config (large)

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "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)$"
    },
    "include_config": {
      "type": "boolean",
      "default": false,
      "description": "Also return the saved workspace config (large)"
    }
  }
}

get_project_preview

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.

read-only

Argument	Type	Description
id*	string
include_image_data	boolean	Also return the image inline as image content

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "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)$"
    },
    "include_image_data": {
      "type": "boolean",
      "default": false,
      "description": "Also return the image inline as image content"
    }
  }
}

list_coin_looks

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.

read-only

No arguments.

Input schema (JSON)

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

list_generations

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.

read-only

Argument	Type	Description
limit	integer

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 12,
      "maximum": 24,
      "minimum": 1
    }
  }
}

list_materials

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.

read-only

Argument	Type	Description
category	string	Only this category

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "category": {
      "enum": [
        "chrome",
        "gold",
        "abstract",
        "holographic",
        "metal",
        "gradient",
        "glass",
        "plastic",
        "clay",
        "neon",
        "fabric",
        "composite",
        "wood",
        "stone",
        "enamel",
        "anodized"
      ],
      "type": "string",
      "description": "Only this category"
    }
  }
}

list_projects

The user's saved logos, coins and generated meshes, newest first. Optional title search and kind filter.

read-only

Argument	Type	Description
kind	string
page	integer
query	string	Match against the title

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "kind": {
      "enum": [
        "logo",
        "coin",
        "mesh"
      ],
      "type": "string"
    },
    "page": {
      "type": "integer",
      "default": 1,
      "maximum": 9007199254740991,
      "minimum": 1
    },
    "query": {
      "type": "string",
      "maxLength": 40,
      "description": "Match against the title"
    }
  }
}

list_share_links

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.

read-only

Argument	Type	Description
id	string	Only this project's links

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "id": {
      "type": "string",
      "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)$",
      "description": "Only this project's links"
    }
  }
}

quote_generation

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.

read-only

Argument	Type	Description
mode*	string
density	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "mode"
  ],
  "properties": {
    "mode": {
      "enum": [
        "text",
        "image"
      ],
      "type": "string"
    },
    "density": {
      "enum": [
        "fast",
        "standard",
        "pro",
        "ultra"
      ],
      "type": "string",
      "default": "standard"
    }
  }
}

request_logo_image_upload

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).

Argument	Type	Description
file_name	string	The file name, used as the project title later

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "file_name": {
      "type": "string",
      "maxLength": 120,
      "description": "The file name, used as the project title later"
    }
  }
}

revoke_share_link

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.

destructive

Argument	Type	Description
token*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "token"
  ],
  "properties": {
    "token": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{22}$"
    }
  }
}

save_generation_as_project

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.

Argument	Type	Description
title	string
public	boolean
run_id*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "run_id"
  ],
  "properties": {
    "title": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1
    },
    "public": {
      "type": "boolean",
      "default": false
    },
    "run_id": {
      "type": "string",
      "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)$"
    }
  }
}

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.

read-only

Argument	Type	Description
query*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 40,
      "minLength": 1
    }
  }
}

update_project

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).

Argument	Type	Description
id*	string
font	string
look	string	Coin projects
text	string	New wordmark; text projects only (coins: 24 characters)
blank	string	Coin projects: the edge
depth	number	Extrusion depth; logo projects
title	string	New project title
motion	string
public

upload_logo_image

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.

Argument	Type	Description
depth	number	Extrusion depth, default 30
image	object	The image the user attached in chat
motion	string
material	string	Material id from list_materials (e.g. gold-clean-optimised)
file_name	string	Shown in the editor; defaults to the file name
image_url	string	Public https URL of the image file
background	string	Hex colour, e.g. #1a1a1a
image_data	string	data:image/png;base64,... for small images only; most hosts cap this well under 1 MB
environment

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "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)$"
    },
    "font": {
      "enum": [
        "outfit",
        "oswald",
        "montserrat",
        "archivo",
        "bebas",
        "anton",
        "russo",
        "orbitron",
        "blackops",
        "pacifico"
      ],
      "type": "string"
    },
    "look": {
      "enum": [
        "gold",
        "chrome",
        "silver",
        "bronze"
      ],
      "type": "string",
      "description": "Coin projects"
    },
    "text": {
      "type": "string",
      "maxLength": 40,
      "minLength": 1,
      "description": "New wordmark; text projects only (coins: 24 characters)"
    },
    "blank": {
      "enum": [
        "reeded",
        "milled",
        "smooth"
      ],
      "type": "string",
      "description": "Coin projects: the edge"
    },
    "depth": {
      "type": "number",
      "maximum": 500,
      "minimum": 1,
      "description": "Extrusion depth; logo projects"
    },
    "title": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "New project title"
    },
    "motion": {
      "enum": [
        "none",
        "orbit",
        "rotate",
        "tumble",
        "reveal",
        "pulse",
        "float",
        "bounce"
      ],
      "type": "string"
    },
    "public": {
      "type": "boolean",
      "description": "Turn the public page on or off; owner only"
    },
    "material": {
      "type": "string",
      "description": "Material id from list_materials; logo projects"
    },
    "background": {
      "type": "string",
      "pattern": "^#[0-9a-fA-F]{6}$",
      "description": "Hex colour, e.g. #1a1a1a"
    },
    "coin_color": {
      "type": "string",
      "pattern": "^#[0-9a-fA-F]{6}$",
      "description": "Coin projects: the coin body"
    },
    "logo_color": {
      "type": "string",
      "pattern": "^#[0-9a-fA-F]{6}$",
      "description": "Coin projects: the struck mark"
    },
    "environment": {
      "enum": [
        "studio",
        "sunset",
        "dawn",
        "night",
        "warehouse",
        "forest",
        "apartment",
        "city"
      ],
      "type": "string",
      "description": "Lighting room"
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "depth": {
      "type": "number",
      "maximum": 500,
      "minimum": 1,
      "description": "Extrusion depth, default 30"
    },
    "image": {
      "type": "object",
      "required": [
        "download_url",
        "file_id"
      ],
      "properties": {
        "file_id": {
          "type": "string",
          "minLength": 1,
          "description": "The host's file id"
        },
        "file_name": {
          "type": "string"
        },
        "mime_type": {
          "type": "string"
        },
        "download_url": {
          "type": "string",
          "format": "uri",
          "description": "Temporary download URL for the attached file"
        }
      },
      "description": "The image the user attached in chat"
    },
    "motion": {
      "enum": [
        "none",
        "orbit",
        "rotate",
        "tumble",
        "reveal",
        "pulse"
      ],
      "type": "string"
    },
    "material": {
      "type": "string",
      "description": "Material id from list_materials (e.g. gold-clean-optimised)"
    },
    "file_name": {
      "type": "string",
      "maxLength": 120,
      "description": "Shown in the editor; defaults to the file name"
    },
    "image_url": {
      "type": "string",
      "format": "uri",
      "maxLength": 2048,
      "description": "Public https URL of the image file"
    },
    "background": {
      "type": "string",
      "pattern": "^#[0-9a-fA-F]{6}$",
      "description": "Hex colour, e.g. #1a1a1a"
    },
    "image_data": {
      "type": "string",
      "maxLength": 3000000,
      "description": "data:image/png;base64,... for small images only; most hosts cap this well under 1 MB"
    },
    "environment": {
      "enum": [
        "studio",
        "sunset",
        "dawn",
        "night",
        "warehouse",
        "forest",
        "apartment",
        "city"
      ],
      "type": "string",
      "description": "Lighting room"
    }
  }
}