Redbubble API and MCP server Let your AI agent tidy your Redbubble shop.

ToolWhat it doesAccess

• list_designs Lists the works in your Manage Portfolio, with title, tag count and enabled products. read

  Returns the works in the order Manage Portfolio shows them. Each item has the design id, title, public state, tag count and the products enabled. The next page comes back as next_cursor; an empty next_cursor means the end. Needs only your own artist account.

  MCP callredbubble_read → list_designs

  REST endpointGET https://cotlet.dev/api/v1/redbubble/designs

  Parameters

  Parameters: list_designs

  Name	Type	Description
  query string	string	Only works whose title contains this text.
  cursor string	string	next_cursor from the previous page.

  Example response

  {
    "designs": [
      {
        "design_id": "112233445",
        "title": "Fox in the Fog",
        "public": true,
        "tag_count": 15,
        "products_enabled": 18
      },
      {
        "design_id": "112233446",
        "title": "Night Market Cat",
        "public": true,
        "tag_count": 9,
        "products_enabled": 18
      },
      {
        "design_id": "112233447",
        "title": "Quiet Mountains",
        "public": true,
        "tag_count": 6,
        "products_enabled": 12
      }
    ],
    "next_cursor": ""
  }

• get_design Reads one work: title, description, tags, privacy and each product line. read

  Returns the full text of the work as the Edit page shows it, with every tag and the Enabled or Disabled state of each product line. Read it before changing tags so the agent keeps what is already there.

  MCP callredbubble_read → get_design

  REST endpointGET https://cotlet.dev/api/v1/redbubble/designs/{design_id}

  Parameters

  Parameters: get_design

  Name	Type	Description
  design_id string required	string	Id from list_designs.

  Example input

  {
    "design_id": "design_8c41d2"
  }

  Example response

  {
    "design_id": "112233446",
    "title": "Night Market Cat",
    "description": "A cat watching a lantern-lit night market.",
    "tags": [
      "cat",
      "night market",
      "lanterns",
      "illustration",
      "cute",
      "asia",
      "street food",
      "animal",
      "art"
    ],
    "public": true,
    "product_lines": [
      {
        "product": "Stickers",
        "state": "Enabled"
      },
      {
        "product": "T-Shirts",
        "state": "Enabled"
      }
    ]
  }

• update_tags Sets the tags of one work, the way Quick Edit does. write

  Replaces all tags of the work with the list you send, so read get_design first and send the old tags you want to keep. Redbubble allows up to 15 tags of 50 characters; a longer list fails. New tags can take up to 15 minutes to show in search. The change reaches no one by itself and one more call undoes it, so it does not wait for your OK.

  MCP callredbubble_write → update_tags

  REST endpointPATCH https://cotlet.dev/api/v1/redbubble/designs/{design_id}/tags

  Parameters

  Parameters: update_tags

  Name	Type	Description
  design_id string required	string	Id from list_designs.
  tags string[] required	string[]	The full tag list. Replaces the current tags. Up to 15 tags, 50 characters each.

  Example input

  {
    "design_id": "112233446",
    "tags": [
      "cat",
      "night market",
      "lanterns",
      "illustration",
      "cute",
      "asia",
      "street food",
      "animal",
      "art",
      "lantern festival",
      "night scene"
    ]
  }

  Example response

  {
    "design_id": "112233446",
    "tags": [
      "cat",
      "night market",
      "lanterns",
      "illustration",
      "cute",
      "asia",
      "street food",
      "animal",
      "art",
      "lantern festival",
      "night scene"
    ],
    "tag_count": 11,
    "saved": true
  }

• update_design_text Changes the title and description of one work, the way Quick Edit does. write

  Changes only the fields you send. The old text is returned in previous so one more call can restore it. It reaches no one directly and is undone in one call, so it does not wait for your OK.

  MCP callredbubble_write → update_design_text

  REST endpointPATCH https://cotlet.dev/api/v1/redbubble/designs/{design_id}/text

  Parameters

  Parameters: update_design_text

  Name	Type	Description
  design_id string required	string	Id from list_designs.
  title string	string	New title. Left out: unchanged.
  description string	string	New description. Left out: unchanged.

  Example input

  {
    "design_id": "design_8c41d2"
  }

  Example response

  {
    "design_id": "112233447",
    "title": "Quiet Mountains at Dawn",
    "previous": {
      "title": "Quiet Mountains"
    },
    "saved": true
  }

• enable_products Turns a product on or off for one or more works, like Available on in Manage Portfolio. writeasks first

  Enables or disables the product on each work and returns the result per work. An enabled product goes on sale to buyers. The uploader may already have turned products off for a small file, and those works come back as skipped. By default you confirm each call; you can switch that off for this tool.

  MCP callredbubble_write → enable_products

  REST endpointPOST https://cotlet.dev/api/v1/redbubble/products/enable

  Parameters

  Parameters: enable_products

  Name	Type	Description
  design_ids string[] required	string[]	Ids from list_designs.
  product string required	string	The product as the Available on dropdown names it.
  enabled boolean	boolean	true enables, false disables. Default true.

  Example input

  {
    "design_ids": [
      "design ids"
    ],
    "product": "product"
  }

  Example response

  {
    "product": "Stickers",
    "enabled": true,
    "results": [
      {
        "design_id": "112233445",
        "state": "Enabled"
      },
      {
        "design_id": "112233446",
        "state": "Enabled"
      }
    ],
    "skipped": []
  }

• set_design_privacy Changes the privacy and maturity settings of works, like More in Manage Portfolio. writeasks first

  Applies the settings to every work in the list. Making a work public shows it to buyers and search. By default you confirm each call; you can switch that off for this tool.

  MCP callredbubble_write → set_design_privacy

  REST endpointPUT https://cotlet.dev/api/v1/redbubble/design-privacy

  Parameters

  Parameters: set_design_privacy

  Name	Type	Description
  design_ids string[] required	string[]	Ids from list_designs.
  privacy string	string	The privacy value as the More menu shows it, for example Public.
  mature boolean	boolean	Whether the works are marked mature.

  Example input

  {
    "design_ids": [
      "design ids"
    ]
  }

  Example response

  {
    "updated": 2,
    "privacy": "Public",
    "mature": false
  }

ToolWhat it doesAccess

• get_analytics Reads the Artist Analytics Dashboard for a period. read

  Returns the chart figures the dashboard shows for the period. Redbubble refreshes the dashboard data daily at 2:00 am UTC, so today is not included yet.

  MCP callredbubble_read → get_analytics

  REST endpointGET https://cotlet.dev/api/v1/redbubble/analytics

  Parameters

  Parameters: get_analytics

  Name	Type	Description
  period string	string	One of 7d, 30d, 12m. Default 30d, the dashboard default.

  Example response

  {
    "period": "7d",
    "views": 1840,
    "sales": 6,
    "refreshed_at": "2026-10-28T02:00:00Z"
  }

• get_payment_history Reads Payment History: earnings, pending sales, cancelled sales, account fees and balance. read

  Returns one entry per pay period as Payment History lists them, newest first, with earnings, pending sales, cancelled sales, fees and the balance. Amounts stay in the currency you chose for payouts.

  MCP callredbubble_read → get_payment_history

  REST endpointGET https://cotlet.dev/api/v1/redbubble/payment-history

  Parameters

  Parameters: get_payment_history

  Name	Type	Description
  cursor string	string	next_cursor from the previous page.

  Example response

  {
    "periods": [
      {
        "period": "September 2026",
        "earnings": 84.2,
        "pending_sales": 12.5,
        "cancelled_sales": 3.1,
        "account_fees": 21.05,
        "balance": 72.55
      },
      {
        "period": "August 2026",
        "earnings": 61,
        "pending_sales": 0,
        "cancelled_sales": 0,
        "account_fees": 15.25,
        "balance": 45.75
      }
    ],
    "currency": "USD",
    "next_cursor": ""
  }

• get_earnings_details Reads the Earnings Details page: the fees applied to one pay period. read

  Returns the breakdown of fees for the pay period, including any extra fee for a product markup above 20%. Redbubble caps platform fees for Standard and Premium artists per payment period.

  MCP callredbubble_read → get_earnings_details

  REST endpointGET https://cotlet.dev/api/v1/redbubble/earnings-details

  Parameters

  Parameters: get_earnings_details

  Name	Type	Description
  period string	string	Pay period as the page names it, for example September 2026. Default: the latest.

  Example response

  {
    "period": "September 2026",
    "platform_fee": 21.05,
    "markup_fee": 0,
    "currency": "USD"
  }

• get_account_tier Reads your account tier from the Account Tiers and Fees page. read

  Returns the tier of the account (Standard, Premium or Pro) and the fee Redbubble charges on monthly earnings for it. Pro artists pay no platform fee.

  MCP callredbubble_read → get_account_tier

  REST endpointGET https://cotlet.dev/api/v1/redbubble/account-tier

  Parameters

  No parameters.

  Example response

  {
    "tier": "Premium",
    "platform_fee_percent": 20
  }