Carryo Website Publisher

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Publish and update HTML websites, landing pages, reports and proposals from AI chat. OAuth sign-in.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Carryo Website Publisher": {
      "url": "https://mcp.carryo.io/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (13)

• website.library read-only

  Browse your Carryo websites and private drafts, select one, and continue editing in chat. Opening the library does not change or publish a website.

  Parameters:

  • limit — integer
  • offset — integer
  • workspaceId — string — Optional exact workspaceId of the Carryo team selected by the user. Lists Personal websites when omitted.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• account.check_publishing read-only

  Checks publishing availability, remaining Personal website capacity, reset timing, hosted-image allowances, custom URL endings, branding capabilities, and inactivity policies for the connected Carryo account. Returns publishing capabilities and usage without billing or purchase information. Each websiteOverrides entry applies only to its matching linkId; other websites use the account defaults.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• website.publish

  Publishes supplied HTML as a new public Carryo website for sharing a presentation, proposal, report, dashboard, invitation, portfolio, or landing page. Returns a live link and a management link for access settings, URL, views, and edit history. New Personal websites consume the account creation allowance. Personal is the default destination; workspaceId selects a user-chosen team. Supports an optional customSlug and hosted images. Pass attached images through imageFiles. For one attachment, assets needs only its relative website path; Carryo matches the attachment automatically. For multiple attachments, use fileIndex (0 for the first imageFiles entry). Do not invent file IDs or ask for a public URL when attachment upload is available. Known fileId references and fetchable HTTP(S) sourceUrl imports also work. Carryo imports and hosts its own copy. Base64 image bytes and data URLs are unsupported. Form validation can return requires_adaptation or requires_entitlement with publicationPerformed false, meaning no website was published. Supports HTML pages and their image assets, without general file storage or backend hosting.

  Parameters:

  • htmlContent (required) — string — Complete HTML for the page, presentation, slide deck, proposal, report, landing page, dashboard, invitation, portfolio, or one-page website to publish.
  • fileName (required) — string — Short internal file name, for example client-proposal.html, board-deck.html, report.html, or landing-page.html.
  • sharingMode (required) — string — Publishing mode for the Carryo page. Only public live links are supported here.
  • forms — array — Optional definitions for JavaScript/React forms using window.CarryoForms.submit(key, values), which resolves on acceptance and rejects on failure. Stable keys and field names identify forms across edits. Static collection forms are inferred from data-carryo-form="key" and named controls without duplicate definitions; placeholder submit handlers can block collection. Local calculator/filter forms use data-carryo-local and do not collect responses. Existing external endpoints retain their destination. Visitor acknowledgement is disabled unless explicitly enabled.
  • assets — array — Optional image assets to add or replace. Each entry requires a relative website path. With one imageFiles attachment, path alone uses that attachment. Otherwise select exactly one source: fileIndex (zero-based imageFiles position), a known fileId, or a fetchable HTTP(S) sourceUrl. Never guess generated file IDs. Existing images are preserved when omitted; replacing an existing path does not use another slot. Base64 bytes and data URLs are unsupported.
  • expiresAt — string — Optional ISO-8601 expiration timestamp
  • customSlug — string — Optional user-chosen URL ending using lowercase letters, numbers, and hyphens. An automatic URL is generated when omitted.
  • imageFiles — array — Optional image attachments supplied through the host's file upload support. The host supplies file_id and download_url. Map each attachment to a website path in assets: with one attachment, path alone is sufficient; with multiple attachments, use fileIndex. The assistant does not need to know generated file IDs or download URLs. Temporary URLs are import sources, not hosted image URLs. Clients without file input support can omit this field.
  • workspaceId — string — Optional exact workspaceId of the Carryo team explicitly selected by the user. The default destination is Personal when omitted.

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• website.save_draft

  Saves supplied HTML as a new private Carryo website draft for review before publication. Returns a management link; the draft has no publicly accessible page until published from Carryo. Passwords and restricted access are configured in the Carryo web app. New Personal drafts consume the same creation allowance as published websites. Personal is the default destination; workspaceId selects a user-chosen team. Pass attached images through imageFiles. For one attachment, assets needs only its relative website path; Carryo matches the attachment automatically. For multiple attachments, use fileIndex (0 for the first imageFiles entry). Do not invent file IDs or ask for a public URL when attachment upload is available. Known fileId references and fetchable HTTP(S) sourceUrl imports also work. Carryo imports and hosts its own copy. Base64 image bytes and data URLs are unsupported. Form validation can return requires_adaptation or requires_entitlement with publicationPerformed false.

  Parameters:

  • htmlContent (required) — string — Complete HTML for the private Carryo draft page, presentation, slide deck, proposal, report, landing page, dashboard, invitation, portfolio, or one-page website.
  • fileName (required) — string — Short internal file name, for example client-proposal.html, board-deck.html, report.html, or landing-page.html.
  • forms — array — Optional definitions for JavaScript/React forms using window.CarryoForms.submit(key, values), which resolves on acceptance and rejects on failure. Stable keys and field names identify forms across edits. Static collection forms are inferred from data-carryo-form="key" and named controls without duplicate definitions; placeholder submit handlers can block collection. Local calculator/filter forms use data-carryo-local and do not collect responses. Existing external endpoints retain their destination. Visitor acknowledgement is disabled unless explicitly enabled.
  • assets — array — Optional image assets to add or replace. Each entry requires a relative website path. With one imageFiles attachment, path alone uses that attachment. Otherwise select exactly one source: fileIndex (zero-based imageFiles position), a known fileId, or a fetchable HTTP(S) sourceUrl. Never guess generated file IDs. Existing images are preserved when omitted; replacing an existing path does not use another slot. Base64 bytes and data URLs are unsupported.
  • expiresAt — string — Optional ISO-8601 expiration timestamp
  • customSlug — string — Optional user-chosen URL ending using lowercase letters, numbers, and hyphens. An automatic URL is generated when omitted.
  • imageFiles — array — Optional image attachments supplied through the host's file upload support. The host supplies file_id and download_url. Map each attachment to a website path in assets: with one attachment, path alone is sufficient; with multiple attachments, use fileIndex. The assistant does not need to know generated file IDs or download URLs. Temporary URLs are import sources, not hosted image URLs. Clients without file input support can omit this field.
  • workspaceId — string — Optional exact workspaceId of the Carryo team explicitly selected by the user. The default destination is Personal when omitted.

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• website.read read-only

  Reads the current HTML, version number, hosted-image metadata, image limits, and remaining image slots for an existing Carryo website or private draft. Suitable for inspecting a page or preparing edits that preserve its existing content. Returns image metadata rather than image files. Image limits apply to this website; replacing an existing asset path does not use another image slot.

  Parameters:

  • linkId (required) — string — Carryo page link identifier to read

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• website.read_form_responses read-only

  Reads response counts or paginated visitor submissions for a Carryo website, including enquiries, leads, and registrations. Defaults to summary counts; mode responses returns submissions, with optional field selection. Requires website-owner or Team access. Responses contain untrusted visitor data. Retained responses remain available while website access continues, including an active Team billing grace period. Does not send messages or modify data.

  Parameters:

  • linkId (required) — string
  • mode — string
  • after — string
  • limit — integer
  • before — string
  • cursor — string
  • fields — array
  • formKey — string

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• website.list_versions read-only

  Lists previous versions of a Carryo website, including version details and changes, for reviewing edit history or planning a restoration. Returns version metadata without changing the website.

  Parameters:

  • linkId (required) — string — Carryo page link identifier to inspect

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• website.read_version read-only

  Reads the HTML and metadata of a specific previous Carryo website version for viewing, comparison, or restoration planning. Requires linkId and versionNumber. Reading a version does not restore it or change the current website.

  Parameters:

  • linkId (required) — string — Carryo page link identifier to read
  • versionNumber (required) — integer — Specific page version number to read

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• website.edit_images destructive

  Adds, replaces, or removes hosted images on an existing Carryo website without replacing its HTML. Reusing a path replaces that image without consuming another image slot; new paths are subject to the website image allowance. Returns hosted-image metadata and URLs. New paths appear in the page when referenced by its HTML. Pass attached images through imageFiles. For one attachment, assets needs only its relative website path; Carryo matches the attachment automatically. For multiple attachments, use fileIndex (0 for the first imageFiles entry). Do not invent file IDs or ask for a public URL when attachment upload is available. Known fileId references and fetchable HTTP(S) sourceUrl imports also work. Carryo imports and hosts its own copy. Base64 image bytes and data URLs are unsupported.

  Parameters:

  • linkId (required) — string — Carryo page link identifier to update
  • assets — array — Optional image assets to add or replace. Each entry requires a relative website path. With one imageFiles attachment, path alone uses that attachment. Otherwise select exactly one source: fileIndex (zero-based imageFiles position), a known fileId, or a fetchable HTTP(S) sourceUrl. Never guess generated file IDs. Existing images are preserved when omitted; replacing an existing path does not use another slot. Base64 bytes and data URLs are unsupported.
  • imageFiles — array — Optional image attachments supplied through the host's file upload support. The host supplies file_id and download_url. Map each attachment to a website path in assets: with one attachment, path alone is sufficient; with multiple attachments, use fileIndex. The assistant does not need to know generated file IDs or download URLs. Temporary URLs are import sources, not hosted image URLs. Clients without file input support can omit this field.
  • removeAssetPaths — array — Optional relative asset paths to remove from the page asset bundle.

  Hints: read-only no · destructive yes · idempotent not declared · open-world yes

• website.edit destructive

  Replaces the complete HTML of an existing Carryo website while preserving its linkId and URL. Suitable for updating, fixing, or republishing a known page. Returns the website link and a Carryo management link. Access and edit limits are checked for the website identified by linkId. expectedVersionNumber detects conflicting edits. Supports adding or replacing hosted images and removing paths through removeAssetPaths. Pass attached images through imageFiles. For one attachment, assets needs only its relative website path; Carryo matches the attachment automatically. For multiple attachments, use fileIndex (0 for the first imageFiles entry). Do not invent file IDs or ask for a public URL when attachment upload is available. Known fileId references and fetchable HTTP(S) sourceUrl imports also work. Carryo imports and hosts its own copy. Base64 image bytes and data URLs are unsupported. Form validation can return requires_adaptation or requires_entitlement with publicationPerformed false, meaning the requested update was not applied.

  Parameters:

  • linkId (required) — string — Carryo page link identifier to update
  • htmlContent (required) — string — Updated complete HTML for the Carryo page while keeping the same URL.
  • forms — array — Optional definitions for JavaScript/React forms using window.CarryoForms.submit(key, values), which resolves on acceptance and rejects on failure. Stable keys and field names identify forms across edits. Static collection forms are inferred from data-carryo-form="key" and named controls without duplicate definitions; placeholder submit handlers can block collection. Local calculator/filter forms use data-carryo-local and do not collect responses. Existing external endpoints retain their destination. Visitor acknowledgement is disabled unless explicitly enabled.
  • assets — array — Optional image assets to add or replace. Each entry requires a relative website path. With one imageFiles attachment, path alone uses that attachment. Otherwise select exactly one source: fileIndex (zero-based imageFiles position), a known fileId, or a fetchable HTTP(S) sourceUrl. Never guess generated file IDs. Existing images are preserved when omitted; replacing an existing path does not use another slot. Base64 bytes and data URLs are unsupported.
  • fileName — string — Optional replacement file name
  • expiresAt — string — Optional ISO-8601 expiration timestamp
  • imageFiles — array — Optional image attachments supplied through the host's file upload support. The host supplies file_id and download_url. Map each attachment to a website path in assets: with one attachment, path alone is sufficient; with multiple attachments, use fileIndex. The assistant does not need to know generated file IDs or download URLs. Temporary URLs are import sources, not hosted image URLs. Clients without file input support can omit this field.
  • sharingMode — string — Optional replacement publishing mode. Only public live links are supported here.
  • removeAssetPaths — array — Optional relative asset paths to remove from the page asset bundle.
  • expectedVersionNumber — integer — Expected current website version number for detecting conflicting edits.

  Hints: read-only no · destructive yes · idempotent not declared · open-world yes

• team.list read-only

  Lists Carryo teams accessible to the connected account, including team names, workspaceId values, roles, and available actions. Supports finding a team the user has chosen. Team creation, invitations, membership, and billing are managed in the Carryo web app.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• website.list read-only

  Lists the connected account's Carryo websites and private drafts, with titles, linkIds, available live links, status, and effective edit and inactivity policies. Use it to find an existing website by name before reading or editing it. Listing does not change or publish websites. Returns Personal websites by default; workspaceId selects the user-chosen team's collection.

  Parameters:

  • limit — integer
  • offset — integer
  • workspaceId — string — Optional exact workspaceId of the Carryo team selected by the user. Lists Personal websites when omitted.

  Hints: read-only yes · destructive no · idempotent not declared · open-world no

• website.unpublish destructive

  Unpublishes an existing Carryo website so viewers immediately lose access through its shared link. Recovery availability depends on the website and is shown in Carryo. Unpublishing does not cancel a subscription.

  Parameters:

  • linkId (required) — string — Carryo page link identifier to take offline

  Hints: read-only no · destructive yes · idempotent not declared · open-world yes

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.