---
name: 3dlogo
description: Make 3D logos, 3D coins, and AI-generated 3D meshes with 3DLogo.io through its MCP connector. Use when the user wants a 3D logo, a chrome/gold/glass wordmark, a 3D coin or medal, a 3D model from a photo or prompt, or wants to save, share, publish, or export those as PNG, GLB, OBJ, STL, or MP4.
license: MIT
compatibility: Needs the 3DLogo.io MCP server (https://3dlogo.io/api/mcp, or /api/mcp/public without an account) connected in the host.
metadata:
  author: 3dlogo.io
  version: "1.0"
  homepage: https://3dlogo.io/integrations
---

# 3DLogo.io

3DLogo.io renders 3D wordmarks and uploaded marks in the browser (chrome, gold, glass,
holographic, neon, clay, wood...), strikes marks into 3D coins, and turns a photo or a
prompt into a 3D mesh. Everything the user sees is a link they open; exports happen in
their browser.

## Which endpoint

- `https://3dlogo.io/api/mcp/public` — no account. Catalogues and studio links.
- `https://3dlogo.io/api/mcp` — OAuth (the user signs in once). Everything public plus
  saved projects, publishing, invites, and Generate runs that spend credits.

## Workflows

**Design a logo (most common).** Ask for the wordmark and the feel. Pick a material with
`list_materials` (categories: chrome, gold, gradient, holographic, glass, plastic, clay,
neon, fabric, composite, wood, stone), a lighting room (`studio` is neutral, `sunset`
warm, `night` moody), and a motion (`rotate` for a turntable). Call
`build_logo_editor_link` and hand back the URL. Say what to expect: the editor opens with
the wordmark typed, they can change anything, and Export gives PNG, GLB, OBJ, STL, or a
480p MP4. Free exports carry a small 3dlogo.io mark; Pro removes it and adds 4K and HD
MP4 (`get_plans`).

**Start from the user's existing logo image.** `upload_logo_image` stores the file and
returns a styled editor link: pass `image` when the host attached the file to the
tool call (ChatGPT does this), `image_url` when the user gives a public link to the
image itself, or `image_data` (base64) only for tiny files. For a file on the user's
machine in a coding agent, call `request_logo_image_upload`, run the returned `curl -T`
line, then `build_logo_editor_link` with the `mark`. If none of those apply (the host
shows you the image but cannot hand it over), call `build_logo_editor_link` with
`upload: true` and the chosen look: the editor opens on the upload panel and the user
drops the file there. Marks expire after 7 days. PNG, JPEG, GIF, WebP up to 8 MB; SVG
up to 1 MB with no scripts or external references. Signed in, `create_image_logo_project`
keeps it as a project (open it once so the image is traced and saved).

**Design a coin.** `list_coin_looks` for looks (gold, chrome, silver, bronze) and blank
edges (reeded, milled, smooth), then `build_coin_studio_link`. Coin text should be short
(a name, initials, a year).

**Keep it in their account** (signed-in endpoint only). `create_text_logo_project` saves
a wordmark as a project and returns an editor link; the artwork renders when they open
it. `set_project_public` needs the project to have rendered artwork, so ask them to open
and save once before publishing a project created this way.

**Generate a 3D model.** `quote_generation` first and tell the user the credit cost.
`generate_3d_model` with a prompt (text) or a public image URL (image). Poll
`get_generation_status` every ~10 seconds; runs take 20-90 seconds. When `completed`,
`save_generation_as_project` (with `public: true` if they want a link) returns the
project page, the share page, and a downloadable GLB URL.

**Find and manage work.** `list_projects` / `search` / `get_project` / `fetch`,
`rename_project`, `create_invite_link` (editor or viewer), `set_project_public`.
`delete_project` is permanent: confirm with the user before calling it.

## Rules of thumb

- Always return the absolute URLs the tools give you; never invent ids or links.
- A `paywall` field in an error means the plan blocks it; relay the `upgradeUrl`.
- Material ids are exact (`gold-clean-optimised`, not "gold"); look them up.
- Colours are 6-digit hex (`#1a1a1a`).
- Do not describe an export as done; the user downloads it from the studio.

See [references/TOOLS.md](references/TOOLS.md) for every tool's inputs and outputs.