MCP

Tinypoly is also an MCP (Model Context Protocol) server. With an AI assistant that speaks MCP, such as Claude or Cursor, you ask it in conversation to create objects, edit meshes, paint textures and apply modifiers in your projects. Every change is already there when you open the editor.

Connecting

  1. On the dashboard, open Account, Services tab, and copy the MCP server address.
  2. Add that address as an MCP server in your agent.
  3. The first time, the agent opens a Tinypoly page. Sign in, check the agent's name and click Allow access.

There is no key or token to copy: authorization happens on that page.

The address looks like this:

https://tinypoly.com/api/mcp

Claude Code

claude mcp add --transport http tinypoly https://tinypoly.com/api/mcp

Cursor and other agents

Agents configured through a JSON file accept the server as an HTTP entry:

{
  "mcpServers": {
    "tinypoly": { "url": "https://tinypoly.com/api/mcp" }
  }
}

What the agent can do

The agent acts on behalf of your account, with your roles: it reaches your projects, the ones shared with you and those of the workspaces you belong to. Where you are a Viewer, it only reads.

  • Projects: List, create and read projects, with the hierarchy and the size of each object.
  • Objects: Create primitives, groups, cameras and modifiers, change them and delete them.
  • Mesh: Extrude, inset, bevel, move, scale and delete faces.
  • Materials: Create and change materials and apply them to objects.
  • Appearance variants: Change colors and materials of what is inside a group or an asset, without touching the objects.
  • Textures: Create and paint textures from a description, including images and shape and text layers that stay editable in the editor.
  • Boards: Build Boards like in the editor, with shapes, texts, images, tables, charts, dimensions and model views, and export them as PDF or PNG.
  • Preview: See images of the texture and of the model, from any side, to check the result.
  • Modules: Create and change the objects and modifiers of the installed modules.
  • Documentation: Read these same pages, so it does not have to guess values.

Limitations

  • The agent does not create 3D Text or vector layers, does not resize textures and does not edit materials with a custom shader.
  • A displacement modifier made by the agent only takes noise, not a texture.
  • The preview uses fixed lights and does not show sky or water.
  • Changing a primitive's properties discards the face edits made on it, as in the editor.

Revoking access

The Services tab lists the connected agents. Revoke cuts access right away, and the agent has to be authorized again to come back.