--- name: "website_settings" area: "websites" title: "Change a website's settings" price: "$0.001" method: "POST" url: "https://api.conecto.chat/v1/tools/website_settings" mcp_server: "https://api.conecto.chat/mcp/websites" auth: "Authorization: Bearer " docs_url: "https://conecto.chat/tools/websites/website_settings" --- # Change a website's settings (`website_settings`) Changes the site's title, description, language, footer, header button, blog, and whether its pages carry the analytics script and the chat. The site's title, description and language, the footer (text, links, email, phone, address, social links), a button in the header, the blog's title and menu label, show_name (the site's name beside the logo; by default the logo stands alone, since it usually carries the name), and two switches: analytics_site (a site_id from analytics_add_site whose script the pages carry) and chat (the account's chat widget on every page). Only what is passed changes; it applies to the draft. Price: $0.001 a call. A call that fails costs nothing. ## Use it when Something shown on every page changes, like the footer address or the chat. ## Say this to your agent > Put our address and phone number in the website footer, and show the chat on every page. ## Inputs | Name | Type | Required | Description | Allowed values | Default | |---|---|---|---|---|---| | `site` | string | yes | The site's name, as in cncto.co/w/. 3 to 60 characters. | | | | `title` | string | no | Up to 120 characters. | | | | `description` | string | no | Up to 300 characters. | | | | `language` | string | no | Up to 12 characters. | | | | `footer` | object | no | | | | | `footer.text` | string | no | Up to 500 characters. | | | | `footer.email` | string | no | Up to 254 characters. | | | | `footer.phone` | string | no | Up to 40 characters. | | | | `footer.address` | string | no | Up to 300 characters. | | | | `footer.links` | array of objects | no | Up to 12 items. | | | | `footer.links[].label` | string | yes, in each item of `footer.links` | Up to 40 characters. | | | | `footer.links[].link` | string | yes, in each item of `footer.links` | Up to 500 characters. | | | | `footer.social` | array of objects | no | Up to 8 items. | | | | `footer.social[].label` | string | yes, in each item of `footer.social` | Up to 40 characters. | | | | `footer.social[].link` | string | yes, in each item of `footer.social` | Up to 500 characters. | | | | `header_button` | object or null | no | | | | | `header_button.label` | string | yes, when `header_button` is given | Up to 40 characters. | | | | `header_button.link` | string | yes, when `header_button` is given | Up to 500 characters. | | | | `blog` | object | no | | | | | `blog.title` | string | no | Up to 80 characters. | | | | `blog.description` | string | no | Up to 300 characters. | | | | `blog.nav` | string | no | Up to 40 characters. | | | | `analytics_site` | string or null | no | Up to 36 characters. | | | | `chat` | boolean | no | | | | | `show_name` | boolean | no | | | | ## Example Written for Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon. MCP: call `website_settings` on the MCP server `https://api.conecto.chat/mcp/websites` with these arguments: ```json { "site": "halverson-cycle", "chat": true, "footer": { "text": "Bikes and repairs on SE Ash St, Portland.", "email": "hello@halverson-cycle-repair.useconecto.com", "phone": "+1 503 555 0100", "address": "1830 SE Ash St, Portland, OR 97214", "links": [ { "label": "Shipping and returns", "link": "/shipping" }, { "label": "Repair prices", "link": "/repairs" } ] } } ``` REST: ```bash curl https://api.conecto.chat/v1/tools/website_settings \ -H "Authorization: Bearer $CONECTO_KEY" \ -H "Content-Type: application/json" \ -d '{"site": "halverson-cycle", "chat": true, "footer": {"text": "Bikes and repairs on SE Ash St, Portland.", "email": "hello@halverson-cycle-repair.useconecto.com", "phone": "+1 503 555 0100", "address": "1830 SE Ash St, Portland, OR 97214", "links": [{"label": "Shipping and returns", "link": "/shipping"}, {"label": "Repair prices", "link": "/repairs"}]}}' ``` ## Response ```json { "call_id": "5f0c8a2e-3b7d-4c1e-9a64-2d8e1f7b0c93", "tool": "website_settings", "status": "succeeded", "replayed": false, "cost_usd": "$0.001", "balance_usd": "$19.75", "result": { "site": { "name": "halverson-cycle", "title": "Halverson Cycle & Repair", "description": "Bikes, repairs and fittings from our workshop in Portland.", "language": "en", "address": "https://cncto.co/w/halverson-cycle/", "published": false, "live_version": null, "rent": null, "settings": { "footer": { "text": "Bikes and repairs on SE Ash St, Portland.", "email": "hello@halverson-cycle-repair.useconecto.com", "phone": "+1 503 555 0100", "address": "1830 SE Ash St, Portland, OR 97214", "links": [ { "label": "Shipping and returns", "link": "/shipping" }, { "label": "Repair prices", "link": "/repairs" } ] }, "chat": true }, "updated_at": "2026-10-14T08:00:00+00:00" } } } ``` `result`: The site with its settings as they now are (in the draft). ## Errors | Code | Status | When | Fix | |---|---|---|---| | `not_found` | 404 | No website of the business has that name. | Call website_list and use one of its names. | | `invalid_input` | 400 | A text field is missing or too long, or the language is not a code like "en". | Fix the field the message names. | | `invalid_input` | 400 | A footer part, button or link is not in the right shape. | Links are a page ("/about"), https://..., mailto: or tel:; buttons are {"label", "link"}. | | `not_found` | 404 | analytics_site is not a site_id of the business. | Use a site_id from analytics_list_sites. | | `not_set_up` | 409 | chat is true but the business has no website chat yet. | Run chat_setup first. | The refusals every tool can give (401 key, 402 balance, 429 limits) are on the errors page: https://conecto.chat/docs/errors.md ## Related - [website_create](https://conecto.chat/tools/websites/website_create.md): Starts a website for the business at cncto.co/w/ as a draft with a home page, in its brand. $0.01 a call. - [website_save_page](https://conecto.chat/tools/websites/website_save_page.md): Creates or changes a page of the draft from sections, or a blog post in Markdown. $0.01 a call. - [website_preview](https://conecto.chat/tools/websites/website_preview.md): A private link to the draft as it would look published, working for 24 hours. Free up to 1,000,000 reads a month. - [website_publish](https://conecto.chat/tools/websites/website_publish.md): Puts the draft online; the first publish starts the monthly rent, later ones cost the price of an edit. $5 for the first publish (the first month of the site's rent), $0.01 after that ($5.00 the first time, then $0.01), up to $5.00. - [website_get](https://conecto.chat/tools/websites/website_get.md): A site with every page of its draft, its settings, its kept versions, and whether the draft has unpublished changes. Free up to 1,000,000 reads a month. - [website_list](https://conecto.chat/tools/websites/website_list.md): The business's websites, published or not. Free up to 1,000,000 reads a month. - [website_delete_page](https://conecto.chat/tools/websites/website_delete_page.md): Removes a page or post from the draft; the home page stays. $0.001 a call. - [website_rollback](https://conecto.chat/tools/websites/website_rollback.md): Publishes one of the kept versions again; the draft stays as it is. $0.01 a call. - [website_unpublish](https://conecto.chat/tools/websites/website_unpublish.md): Takes the site offline and ends its rent; the draft and versions stay. Free. - [website_delete](https://conecto.chat/tools/websites/website_delete.md): Deletes a site for good, with its pages, versions and address; the name is never used again. Free.