Sign inOpen editor

MCP

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

Connecting

  1. In 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 if you haven't yet, check the agent's name and click Allow access.

There is no key or token to copy: authorization happens on that page, and the agent receives access on its own.

The address has this format:

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 and with your roles. It reaches the projects that are yours, the ones shared with you and the ones in the workspaces you belong to. In a project where you are Viewer, it can only read.

  • Projects: List, create and read a whole project, with the hierarchy, transforms and measurements of each object.
  • Objects: Create primitives, groups and modifiers, change properties, position, color and hierarchy, and delete.
  • Mesh: Inspect faces and extrude, inset, bevel, move, scale and delete faces picked by direction, region or index.
  • Modules: Create and change the objects and modifiers of the installed modules.
  • Documentation: Read these same pages and what each property accepts, so it doesn't have to guess values.

Limitations

  • The agent can't create 3D text.
  • The displacer modifier only accepts noise, not a texture.
  • Materials and textures are not edited by the agent.
  • Module content that needs to generate a texture or material only works in the editor.
  • Editing a primitive's faces and then changing its properties generates the mesh again and discards those edits, just like in the editor.

Revoking access

The same Services tab lists the connected agents, with the date of authorization and last use. Revoke cuts access immediately, and the agent needs to be authorized again to use your projects.