create_website

Add a website, or reuse its existing domain, within the workspace's current plan.

Access: OAuth analytics:read sites:write, with current workspace owner/admin access. Workspace keys cannot use this tool.

Arguments

create_website arguments
Field	Type	Description
`confirm`Required	`boolean`	Confirm the website details with the account holder before sending true.
`currency`	`string`	Supported three-letter currency. Default: `USD`.
`domain`Required	`string`	Public domain or HTTP(S) address. Normalized to a lowercase domain without www, credentials or a port.
`name`	`string`	Website name; defaults to domain.
`timezone`	`string`	IANA timezone. Default: `UTC`.

Create a website

Use this JSON-RPC call through an initialized MCP client. Replace example values with your actual website, dates or confirmed setup details.

MCP tools/call request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "create_website",
    "arguments": {
      "domain": "shop.example.com",
      "name": "Example shop",
      "currency": "USD",
      "timezone": "UTC",
      "confirm": true
    }
  }
}

Decoded result

Illustrative JSON parsed from the result’s text block.

Decoded JSON result

{
  "site": {
    "id": "site_example",
    "domain": "shop.example.com",
    "currency": "USD",
    "name": "Example shop",
    "timezone": "UTC"
  },
  "created": true
}

Result fields

create_website result fields
Field	Type	Description
`site`	`object`	Returned website details.
`created`	`boolean`	Whether a website was created.

The decoded data follows the create a website response contract, without the REST envelope.

Full MCP result wrapper

MCP result object

{
  "content": [
    {
      "type": "text",
      "text": "{\n  \"site\": {\n    \"id\": \"site_example\",\n    \"domain\": \"shop.example.com\",\n    \"currency\": \"USD\",\n    \"name\": \"Example shop\",\n    \"timezone\": \"UTC\"\n  },\n  \"created\": true\n}"
    }
  ]
}

Behavior and limits

Requires an OAuth connection with analytics:read sites:write and current workspace owner/admin access. Workspace keys cannot use this endpoint.

Does not buy an upgrade. A website plan limit returns 403. Always use the returned site rather than inventing an ID.