ClaraConverts

Get ClaraConverts pricing: the free 30-day trial (no card, every Pro feature — start it with create_trial_tenant) and the paid plans (Standard, Pro, Volume) in USD/month.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

List the CRM, booking, commerce, payments, and other integrations ClaraConverts can connect to.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Create a free, no-card ClaraConverts trial for a website, with every Pro feature (voice replies included). Returns a working embed snippet and a bearer token for follow-up calls (get_embed_snippet, get_upgrade_link). Trial lasts 30 days. One live trial per owner_email — provisioning multiple sites (e.g. for an agency's clients) isn't supported by these tools yet; each site needs its own contact email for now.

{
  "type": "object",
  "properties": {
    "owner_email": {
      "type": "string",
      "description": "The site owner's real, monitored email — this is the only place their Studio login link and trial-expiry reminders go. Ask the human for it; don't invent one or reuse an address found elsewhere (required)."
    },
    "site_url": {
      "type": "string",
      "description": "URL of the site Clara will be installed on (required)."
    },
    "display_name": {
      "type": "string",
      "description": "Optional display name for the business."
    },
    "conversion_goal": {
      "type": "string",
      "description": "Optional: what Clara should drive (e.g. \"book a demo\", \"capture a lead\")."
    }
  },
  "required": [
    "owner_email",
    "site_url"
  ],
  "additionalProperties": false
}

Get the <script> embed snippet for your trial tenant. Requires the secret_key from create_trial_tenant, either as the secret_key argument or an "Authorization: Bearer <secret_key>" header.

{
  "type": "object",
  "properties": {
    "secret_key": {
      "type": "string",
      "description": "The secret_key returned by create_trial_tenant, if your client can't send it as an \"Authorization: Bearer <secret_key>\" header instead."
    }
  },
  "additionalProperties": false
}

Read back your trial tenant's current persona/widget settings and which integrations are connected — the read counterpart to update_tenant_settings and configure_integration, useful for confirming a change actually took or resuming work without re-guessing current state. Requires the secret_key from create_trial_tenant, either as the secret_key argument or an "Authorization: Bearer <secret_key>" header.

{
  "type": "object",
  "properties": {
    "secret_key": {
      "type": "string",
      "description": "The secret_key returned by create_trial_tenant, if your client can't send it as an \"Authorization: Bearer <secret_key>\" header instead."
    }
  },
  "additionalProperties": false
}

Update your trial tenant's persona and widget settings (name, goal, branding, position, lead notification email). Only the fields you pass are changed. Requires the secret_key from create_trial_tenant, either as the secret_key argument or an "Authorization: Bearer <secret_key>" header.

{
  "type": "object",
  "properties": {
    "secret_key": {
      "type": "string",
      "description": "The secret_key returned by create_trial_tenant, if your client can't send it as an \"Authorization: Bearer <secret_key>\" header instead."
    },
    "display_name": {
      "type": "string",
      "description": "Business/display name shown in the widget chrome."
    },
    "site_url": {
      "type": "string",
      "description": "The site Clara is installed on."
    },
    "conversion_goal": {
      "type": "string",
      "description": "What Clara should drive (e.g. \"book a demo\", \"capture a lead\")."
    },
    "brand_color": {
      "type": "string",
      "description": "Hex color, e.g. \"#0b5ed7\"."
    },
    "widget_position": {
      "type": "string",
      "enum": [
        "top_left",
        "top_center",
        "top_right",
        "middle_left",
        "middle_center",
        "middle_right",
        "bottom_left",
        "bottom_center",
        "bottom_right"
      ],
      "description": "Where the widget bubble docks."
    },
    "lead_destination": {
      "type": "string",
      "description": "Email address captured leads are sent to."
    },
    "outbound_webhook": {
      "type": "string",
      "description": "Optional webhook URL for lead notifications (Zapier/Make/etc.)."
    },
    "language": {
      "type": "string",
      "enum": [
        "auto",
        "en-us",
        "en-gb",
        "es-es",
        "es-419",
        "fr",
        "it",
        "pt",
        "hi",
        "ja",
        "zh",
        "de",
        "ar"
      ],
      "description": "\"auto\" detects from the visitor's browser, or pin a fixed language."
    },
    "voice_id": {
      "type": "string",
      "description": "Voice for spoken replies (a Pro feature; every trial is Pro)."
    },
    "chatbot_name": {
      "type": "string",
      "description": "Override the AI's name (defaults to \"Clara\")."
    },
    "chatbot_avatar_url": {
      "type": "string",
      "description": "URL of a custom avatar image for the widget."
    }
  },
  "additionalProperties": false
}

Re-crawl your site and update what Clara knows about it. Trials skip the crawl at creation to stay fast, so Clara knows nothing about your business until this runs at least once. Can take up to a minute for a large site. Requires the secret_key from create_trial_tenant, either as the secret_key argument or an "Authorization: Bearer <secret_key>" header.

{
  "type": "object",
  "properties": {
    "secret_key": {
      "type": "string",
      "description": "The secret_key returned by create_trial_tenant, if your client can't send it as an \"Authorization: Bearer <secret_key>\" header instead."
    }
  },
  "additionalProperties": false
}

Give Clara the site's content directly, for a site that isn't published yet (localhost, a preview URL, or still being built) so you can test Clara answering real questions before launch. Pass each page's text, markdown, or HTML. Replaces what Clara currently knows about the site; once the site is live, refresh_site_knowledge crawls it and replaces this. Requires the secret_key from create_trial_tenant, either as the secret_key argument or an "Authorization: Bearer <secret_key>" header.

{
  "type": "object",
  "properties": {
    "pages": {
      "type": "array",
      "description": "The site's pages (at most 300).",
      "items": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "description": "The page's URL or path on the site, e.g. \"/\" or \"/menu\"."
          },
          "title": {
            "type": "string",
            "description": "Optional page title."
          },
          "content": {
            "type": "string",
            "description": "The page's content as text, markdown, or HTML (required)."
          }
        },
        "required": [
          "content"
        ],
        "additionalProperties": false
      }
    },
    "secret_key": {
      "type": "string",
      "description": "The secret_key returned by create_trial_tenant, if your client can't send it as an \"Authorization: Bearer <secret_key>\" header instead."
    }
  },
  "required": [
    "pages"
  ],
  "additionalProperties": false
}

List the meeting types on a Cal.com account by name (with account timezone). Call this BEFORE configure_integration with provider="calcom" — its required event_type_id can't be typed from memory, it has to be picked from this list. Requires the secret_key from create_trial_tenant, either as the secret_key argument or an "Authorization: Bearer <secret_key>" header.

{
  "type": "object",
  "properties": {
    "secret_key": {
      "type": "string",
      "description": "The secret_key returned by create_trial_tenant, if your client can't send it as an \"Authorization: Bearer <secret_key>\" header instead."
    },
    "api_key": {
      "type": "string",
      "description": "The Cal.com API key to look up meeting types for."
    }
  },
  "required": [
    "api_key"
  ],
  "additionalProperties": false
}

Connect an integration from list_integrations to your trial tenant. For API-key providers, pass api_key and any required config fields and it connects immediately (Cal.com needs list_calcom_event_types called first for event_type_id — every other provider's config fields are typed directly from that provider's own dashboard). For OAuth providers (Shopify, HubSpot, Google Calendar, Square, ...), returns a connect_url a human must open and approve — it can't be completed headlessly. Requires the secret_key from create_trial_tenant, either as the secret_key argument or an "Authorization: Bearer <secret_key>" header.

{
  "type": "object",
  "properties": {
    "secret_key": {
      "type": "string",
      "description": "The secret_key returned by create_trial_tenant, if your client can't send it as an \"Authorization: Bearer <secret_key>\" header instead."
    },
    "provider": {
      "type": "string",
      "description": "The integration name from list_integrations, e.g. \"calcom\"."
    },
    "api_key": {
      "type": "string",
      "description": "The provider's API key/token, for API-key-based providers."
    },
    "config": {
      "type": "object",
      "description": "Provider-specific config fields (see the provider's configFields — e.g. Cal.com needs event_type_id)."
    }
  },
  "required": [
    "provider"
  ],
  "additionalProperties": false
}

Get a Stripe Checkout link to keep Clara after the trial — Pro by default, the plan every trial runs on. Requires the secret_key from create_trial_tenant, either as the secret_key argument or an "Authorization: Bearer <secret_key>" header.

{
  "type": "object",
  "properties": {
    "secret_key": {
      "type": "string",
      "description": "The secret_key returned by create_trial_tenant, if your client can't send it as an \"Authorization: Bearer <secret_key>\" header instead."
    },
    "tier": {
      "type": "string",
      "enum": [
        "standard",
        "pro",
        "volume"
      ],
      "description": "Optional; defaults to \"pro\". Pass only if the owner asked for a different plan."
    }
  },
  "additionalProperties": false
}