Public API & MCP

Structure,
from code.

Claude Code and other AI agents turn product info into structure on Plottell — just by passing it along.
Generate and visualize cosmetics structure from a public REST API and MCP.

Get an API key npm: plottell-mcp

The structure engine for cosmetics.

Instead of exposing raw tldraw, we hand off a stable sections schema. Compliance-aware structure generation and expansion to LP / Amazon A+ / social — all in a single agent request.

Quickstart

Run it in 3 steps

Get an API key

Issue a pk_live_… key in the dashboard’s API keys (scopes depend on plan).

Register in .mcp.json

Add plottell-mcp to your project’s .mcp.json (snippet below).

Call from Claude Code

Just ask “build a vertical LP for cleanser A” and plottell_ai_compose runs.

.mcp.json

{
  "mcpServers": {
    "plottell": {
      "command": "npx",
      "args": ["-y", "plottell-mcp"],
      "env": { "PLOTTELL_API_KEY": "pk_live_…" }
    }
  }
}

Reference

Endpoints / MCP tools

REST	MCP tool	scope	Purpose
GET`/api/v1/me`	`plottell_me`	read	Check key validity, plan and scopes
GET`/api/v1/canvases`	`plottell_list_canvases`	read	List canvases (with composition / media counts)
GET`/api/v1/canvases/{id}`	`plottell_get_canvas`	read	Fetch a canvas (sections / genre / brandKit)
POST`/api/v1/canvases`	`plottell_create_canvas`	write	Create a canvas from a structure
PUT`/api/v1/canvases/{id}`	`plottell_update_canvas`	write	Update name / genre / sections
DELETE`/api/v1/canvases/{id}`	`plottell_delete_canvas`	write	Delete a canvas
POST`/api/v1/canvases/{id}/compositions`	`plottell_add_composition`	write	Add a structure to a canvas
POST`/api/v1/ai/compose`	`plottell_ai_compose`	ai	Generate a structure from product info (uses credits)

scope	Plan	What it does
read	Free +	List / fetch canvases
write	Standard +	Create / update / delete / add structure
ai	Enterprise	AI structure generation (/ai/compose)

Example

Generate a structure from product info

Add create: true to also create a Canvas from the generated structure (needs ai + write scopes).

curl

curl -X POST https://plottell.com/api/v1/ai/compose \
  -H "Authorization: Bearer pk_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "productName": "Brightening Toner A",
    "description": "With vitamin C derivative. Cares for a dull look from dryness.",
    "genre": "cosmetics",
    "mediaType": "lp",
    "create": true
  }'

The response includes normalized sections, credits consumed, and (when create is set) the new Canvas URL. Opening that URL auto-generates the layout from the structure.

Give your agent
a structure engine.

Get a free API key and try it from /api/v1/me.

Get an API key Back to home

Structure, from code.