{ "mcp": { "url": "https://mcp.spaicely.com/mcp", "public_url": "https://mcp.spaicely.com/mcp/public", "instructions": "Spaicely hosts static websites on the customer's own domain in the EU. You act for one person and one account; start with account.whoami to learn which sites you may see and what you may change; with no site yet, sites.create makes one on that account. Your rights are never wider than the person's role on a site. Purchases always need a second call with a confirmation token, after the person agreed. The person chooses per kind of action whether you may do it yourself, must ask first, or may not (account.whoami lists them as ai_permissions). A call that must be asked first answers with approval_required and a url: give the person that link, do not repeat the call, and read the outcome with approvals.status once they say they decided. The call runs exactly as you sent it. Give every site its own 404.html at the root, in the style and language of the site: visitors get it for any address that does not exist. Without one they get a plain page of ours in the language of the lang attribute of index.html. Every site also needs robots.txt, sitemap.xml and llms.txt at the root, an icon, and on each page its own title, meta description, lang, canonical link and Open Graph tags for link previews, all with full https URLs on the site's domain; describe the business in JSON-LD. The full checklist with examples: https://spaicely.com/skills/en/site-building/SKILL.md (also nl, de, fr). Running a site (versions, rollback, domain, DNS, mail forwarding, people, plan): https://spaicely.com/skills/en/site-management/SKILL.md. After publishing, the hints in sites.versions say what is still missing. Once the hosting is paid, a published site is also at its own address (address in account.whoami), to share before a domain is connected. A static site can still take messages, signups and payments: scripts.enable adds a form handled by Spaicely and gives the HTML to put in a page. Kinds: contact (mail to the owner), signup (a list with double opt-in), download (a file under _private/ for the visitor's details), coupon (a discount code; one for everyone, a list, or codes with dates such as a code per week) and donation (any plan: amounts paid to the owner's own Stripe account, a progress bar from progress_url). A download or coupon form can take a price. Use these instead of a form or payment service elsewhere. A site with the Shop plan sells through shop.setup: Stripe Checkout on the owner's own Stripe account, prices from a products file in the site (at most 500 products). Payments carry a 2% commission. A person who may change files but not publish asks for approval with sites.review.request (Pro and Shop plans); sites.stats gives visits without cookies. A partner proposes a domain to a customer with domains.propose and hands a finished site over with sites.handover. sites.subscription shows and starts or switches a site's hosting plan; account.billing holds the billing details every purchase needs. Mail to a connected domain can be forwarded to mailboxes the person already has (info@ to their Gmail): mail.forward.enable, then mail.forward.add; EUR 1.50 (GBP 1.30, USD 1.75) a month per address, Site 1, Pro 5, Shop 10. Answering as info@ is not possible yet. The prompts new_site and launch_check describe how we like a site built and checked; move_site rebuilds a site from elsewhere, such as WordPress, with the same pages and addresses. Spaicely adds tools over time. Fetch the tool list again when you can; when a tool named here or on https://spaicely.com/developers/ is not in your list, ask the person to reconnect the Spaicely connector (in claude.ai: Settings > Connectors), which loads the current list.", "tools": [ { "name": "account.whoami", "title": "Who am I working for?", "scope": "account:read", "public": false, "description": "Returns the person and account you act for, your scopes, and per site your role and what you may do. Call this first.", "input_schema": { "properties": {}, "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true } }, { "name": "approvals.status", "title": "Approvals the person must give", "scope": "account:read", "public": false, "description": "A call of a kind of action the person set to `ask` (see `ai_permissions` in account.whoami) does not run at once: it answers with `approval_required`, an `approval` id and a `url` for the person. Do not repeat that call. Once the person says they decided, pass the `approval` id here: `status` is pending, approved, rejected or expired, and for an approved call `result` is the answer the call gave, exactly as if it had run at once. Without an id: the approvals of this account that still wait. Needs scope account:read.", "input_schema": { "properties": { "approval": { "type": "string" } }, "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true } }, { "name": "account.members", "title": "People on the account", "scope": "access:manage", "public": false, "description": "Lists the people on the account you act for, with their role (owner or member) and the open invitations. Everyone on an account works on all its sites; owners also handle payment, domains and people. For owners: `invite` mails a link, valid for 7 days, to an address (role member or owner); `set_role` with `user_id` and `role` changes a role; `remove` with `user_id` takes someone off; `cancel_invitation` with an e-mail address withdraws an invitation. People on a single site instead of the whole account: access.update. Ask the person first. Needs scope access:manage.", "input_schema": { "properties": { "invite": { "type": "string", "description": "E-mail address to invite" }, "role": { "type": "string", "enum": [ "member", "owner" ], "description": "For invite and set_role; default member" }, "set_role": { "type": "boolean" }, "remove": { "type": "boolean" }, "user_id": { "type": "integer", "description": "For set_role and remove, from the list" }, "cancel_invitation": { "type": "string", "description": "E-mail address of an open invitation" } }, "type": "object" }, "annotations": { "destructiveHint": true, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": false } }, { "name": "account.billing", "title": "Billing details of the account", "scope": "billing:write", "public": false, "description": "Shows the billing details of the account you act for: whether it is a business, VAT number, address and country, and changes them with the fields you pass. They go on every invoice and decide the VAT: a business in another EU country with a VAT number that VIES confirms pays no Dutch VAT. A VAT number is checked with VIES on saving. Hosting and domains cannot be bought without them. Only owners. Needs scope billing:write.", "input_schema": { "properties": { "business": { "type": "boolean" }, "vat_number": { "type": "string" }, "billing_street": { "type": "string" }, "billing_postal_code": { "type": "string" }, "billing_city": { "type": "string" }, "billing_country_code": { "type": "string", "description": "Two letters, such as NL" } }, "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": false } }, { "name": "account.invoices", "title": "Invoices of the account", "scope": "billing:write", "public": false, "description": "Lists Spaicely's invoices to the account you act for, newest first (at most 50): number, date, amounts in euro cents and a `url` where the person reads and prints it. A credit invoice has a negative total. Only owners. Needs scope billing:write.", "input_schema": { "properties": {}, "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true } }, { "name": "domains.search", "title": "Check which domain names are free", "scope": null, "public": true, "description": "Checks whether domain names are free to register. Pass full domains (bakkerijjansen.nl) and/or bare names (bakkerijjansen); a bare name is tried with every extension in `extensions`, or by default with the ones people ask for most: nl, com, eu, be, de, net, org, shop, online, site, store, tech, app, dev, io, ai, co.uk, uk, fr, at, ch, it, es, nu, se, co, me, info, biz, xyz, cloud. We sell 718 extensions in all (.amsterdam, .restaurant, .photography and so on); pass them in `extensions` when they fit the name. At most 50 domains per call. The first check is quick and asks DNS only: taken means the domain has nameservers (certain); likely_available means it has none, so it is probably free (reason dns_only, or no_rdap where the registry has no RDAP and verifying adds nothing). Once the person has favourites, call again with verify: true for the dns_only ones (at most 10 domains): that asks our registrar (or else the registry over RDAP) and turns them into available or taken; otherwise reason says why (rdap_rate_limited, rdap_unavailable). A premium name (premium: true) costs what its registry asks: price is our price for it in euro cents before VAT, often far above the usual price, so tell the person. unknown means no answer at all. Each free domain has a register_url: a page where the person signs in and registers it in their own name. Registration itself checks again. Each taken domain has a transfer_url: if the domain is the person's own, they move it to Spaicely there.", "input_schema": { "properties": { "names": { "type": "array", "items": { "type": "string" }, "minItems": 1, "description": "Domains or bare names, such as bakkerijjansen.nl or bakkerijjansen" }, "extensions": { "type": "array", "items": { "type": "string" }, "description": "Extensions to try bare names with, such as nl, com, eu. Default: the ones people ask for most." }, "verify": { "type": "boolean", "description": "Deep check for a shortlist: also ask the registries. At most 10 domains." } }, "required": [ "names" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": true } }, { "name": "domains.register", "title": "Register a domain", "scope": "domains:buy", "public": false, "description": "Registers a domain in the name of the customer account you act for; that account becomes the holder. Call it first without `confirmation`: it checks the name and the holder details and returns a summary with the price and a confirmation. Show the summary to the person and ask whether to go ahead; only then call again with the same name and that confirmation. That call returns a `payment_url`: give it to the person, who pays there; the domain is registered once the payment is in. Holder details are needed once per account (pass `contact`); later domains reuse them. A consumer (an account that is not a business) must first agree to have the order carried out at once and to lose the 14-day right of withdrawal once it is done; ask them, and pass `start_now: true` with the second call only when they said yes themselves. Without it a consumer cannot order. Automatic renewal is on by default and charges the card or direct debit used for this payment; see domains.auto_renew. Needs scope domains:buy.", "input_schema": { "properties": { "name": { "type": "string", "description": "The full domain, such as bakkerijjansen.nl" }, "contact": { "type": "object", "description": "The holder as the registry records it. Leave out to reuse the last one.", "properties": { "name": { "type": "string" }, "organization": { "type": "string" }, "email": { "type": "string" }, "phone": { "type": "string", "description": "With country code, such as +31 6 12345678" }, "street": { "type": "string", "description": "Street and house number" }, "postal_code": { "type": "string" }, "city": { "type": "string" }, "country_code": { "type": "string", "description": "Two letters, such as NL" } } }, "confirmation": { "type": "string", "description": "From the first call, after the person agreed." }, "start_now": { "type": "boolean", "description": "Required for consumers, with the second call: carry out the order at once and give up the 14 days to withdraw. Only when the person said so themselves." } }, "required": [ "name" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": false } }, { "name": "domains.propose", "title": "Propose a domain to the customer", "scope": "domains:buy", "public": false, "description": "For a partner working on a customer's site (as admin, maintainer or designer): proposes a domain for that site. The customer becomes the holder and gets a mail with a link, valid for 14 days, to check the holder details and agree; nothing is ordered before that. `payer` is `customer` (the customer pays when agreeing) or `partner` (an owner of the partner account pays afterwards, on the page in `proposal_url`). `contact` fills in the holder details for the customer to check; leave it out to let the customer fill them in. Ask the person first. Needs scope domains:buy.", "input_schema": { "properties": { "site_id": { "type": "integer" }, "name": { "type": "string", "description": "The full domain, such as bakkerijjansen.nl" }, "payer": { "type": "string", "enum": [ "customer", "partner" ] }, "contact": { "type": "object", "description": "The holder (the customer) as the registry records it; optional.", "properties": { "name": { "type": "string" }, "organization": { "type": "string" }, "email": { "type": "string" }, "phone": { "type": "string", "description": "With country code, such as +31 6 12345678" }, "street": { "type": "string", "description": "Street and house number" }, "postal_code": { "type": "string" }, "city": { "type": "string" }, "country_code": { "type": "string", "description": "Two letters, such as NL" } } } }, "required": [ "site_id", "name" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": false } }, { "name": "domains.transfer", "title": "Move a domain to Spaicely", "scope": "domains:buy", "public": false, "description": "Moves a domain that is registered elsewhere to Spaicely, in the name of the customer account you act for; that account is the holder. The person gets the transfer code (also called auth code, EPP code or token) from their current registrar and must unlock the domain there. Do not ask for the code in the conversation: call with only `name`. That checks whether the domain can move and returns a `url` where the person signs in, enters the code and the holder details and confirms; give them that link. domains.status shows the move afterwards. Only when the person pastes the code into the conversation themselves: call with `name` and `transfer_code` and without `confirmation` for a summary and a confirmation, ask the person, then call again with the same name, the same transfer_code and that confirmation; that call returns a `payment_url` for the person, and the move starts once the payment is in. A consumer must agree to `start_now` first (see domains.register). Automatic renewal is on by default (domains.auto_renew). Needs scope domains:buy.", "input_schema": { "properties": { "name": { "type": "string", "description": "The full domain, such as bakkerijjansen.nl" }, "transfer_code": { "type": "string", "description": "Only when the person gave it in the conversation themselves" }, "contact": { "type": "object", "description": "The holder as the registry records it. Leave out to reuse the last one.", "properties": { "name": { "type": "string" }, "organization": { "type": "string" }, "email": { "type": "string" }, "phone": { "type": "string", "description": "With country code, such as +31 6 12345678" }, "street": { "type": "string", "description": "Street and house number" }, "postal_code": { "type": "string" }, "city": { "type": "string" }, "country_code": { "type": "string", "description": "Two letters, such as NL" } } }, "confirmation": { "type": "string", "description": "From the first call, after the person agreed." }, "start_now": { "type": "boolean", "description": "Required for consumers, with the second call: carry out the order at once and give up the 14 days to withdraw. Only when the person said so themselves." } }, "required": [ "name" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": false } }, { "name": "domains.auto_renew", "title": "Automatic renewal of a domain", "scope": "domains:buy", "public": false, "description": "Shows whether a domain held by the account you act for renews automatically, and switches it on or off with `on`. Automatic renewal is on by default: Spaicely charges the card or SEPA direct debit the domain was paid with, 14 days before the expiry date, and e-mails the amount beforehand. When no payment method is saved, the answer has a `setup_url`: give it to the person, who saves a card or mandate at Stripe there. Leave `on` out to only look. A consumer (an account that is not a business) who switches it on must agree that each renewal is carried out at once, without the 14-day right of withdrawal; pass `start_now: true` only when they said so themselves. Only owners of the holder account can change it. Needs scope domains:buy.", "input_schema": { "properties": { "domain": { "type": "string", "description": "The full domain, such as bakkerijjansen.nl" }, "on": { "type": "boolean", "description": "true to switch on, false to switch off; leave out to only look." }, "start_now": { "type": "boolean", "description": "For consumers switching it on: renewals start at once, without the right of withdrawal." } }, "required": [ "domain" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": false } }, { "name": "domains.renew", "title": "Renew a domain now", "scope": "domains:buy", "public": false, "description": "Gives a link where the person pays for the renewal of a domain registered through Spaicely now, instead of waiting for automatic renewal (domains.auto_renew); the domain renews after payment, for the period in the answer. A consumer (an account that is not a business) must agree that the renewal is carried out at once, without the 14-day right of withdrawal; pass `start_now: true` only when they said so themselves. Only owners of the holding account. Needs scope domains:buy.", "input_schema": { "properties": { "domain": { "type": "string" }, "start_now": { "type": "boolean" } }, "required": [ "domain" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": false } }, { "name": "domains.holder", "title": "Holder of a domain", "scope": "domains:buy", "public": false, "description": "Shows the holder of a domain registered through Spaicely, as the registry knows it, and changes it with the fields you pass. Address, phone and e-mail go to the registry at once, for every domain on the same holder record (shared_with lists them). Another name or organisation is a change of holder: Spaicely staff handle it, which can take a few working days. The holder is the legal owner of the domain: change it only with the person's own details or what they said. Only owners of the holding account. Needs scope domains:buy.", "input_schema": { "properties": { "domain": { "type": "string" }, "name": { "type": "string" }, "organization": { "type": "string" }, "email": { "type": "string" }, "phone": { "type": "string" }, "street": { "type": "string" }, "postal_code": { "type": "string" }, "city": { "type": "string" }, "country_code": { "type": "string", "enum": [ "NL", "BE", "DE", "FR", "AT", "CH", "LU", "GB", "IE", "IT", "ES", "PT", "DK", "SE", "NO", "FI", "PL", "CZ", "US" ] } }, "required": [ "domain" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": false } }, { "name": "domains.lock", "title": "Transfer lock of a domain", "scope": "domains:buy", "public": false, "description": "Switches the transfer lock of a domain registered through Spaicely on or off. With the lock on, nobody can move the domain to another provider, even with the transfer code. Switch it off only when the person moves the domain away; domains.status shows the lock. Only owners of the holding account. Needs scope domains:buy.", "input_schema": { "properties": { "domain": { "type": "string" }, "locked": { "type": "boolean" } }, "required": [ "domain", "locked" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": false } }, { "name": "domains.nameservers", "title": "Nameservers of a domain", "scope": "domains:buy", "public": false, "description": "Sets the nameservers of a domain registered through Spaicely. `ours: true` puts back Spaicely's own (needed for a site and for mail forwarding). Other nameservers (2 to 13) only for a domain that is not on a site, for instance when the person keeps their DNS elsewhere; Spaicely's DNS then no longer applies. Ask the person first. Only owners of the holding account. Needs scope domains:buy.", "input_schema": { "properties": { "domain": { "type": "string" }, "ours": { "type": "boolean" }, "nameservers": { "type": "array", "items": { "type": "string" }, "description": "Host names, such as ns1.example.net" } }, "required": [ "domain" ], "type": "object" }, "annotations": { "destructiveHint": true, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": false } }, { "name": "domains.transfer_code", "title": "Transfer code of a domain", "scope": "domains:buy", "public": false, "description": "Asks for the transfer code (auth code) of a domain registered through Spaicely, to move it to another provider. The code goes by mail to the person and the holder, not to you; every new request makes the earlier code useless, so ask at most a few times an hour. The transfer lock must be off at the moment of the move (domains.lock). Ask the person first. Only owners of the holding account. Needs scope domains:buy.", "input_schema": { "properties": { "domain": { "type": "string" } }, "required": [ "domain" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": false } }, { "name": "sites.create", "title": "Create a site", "scope": "content:write", "public": false, "description": "Makes a new, empty site on the account you act for, owned and paid for by that account. Then sites.deploy and sites.publish put the first version on it, and sites.domains.connect puts it on the person's domain. Ask the person for the name first. Needs scope content:write and the role owner or member of a customer account. A site needs a hosting subscription: without one it is removed after 14 days; tell the person and give them the subscription_url from the answer. Once paid and published, the site also answers on its address (