llms.txt
+25 −16
− Use this when the user wants a page, site or landing draft for a name and there is nothing to edit yet. Store a draft website in the user's Scopeweb portfolio. Returns a persistent draft_id and a live preview_url. Drafts survive across conversations — use list_drafts in future sessions to resume work. Content is screened on every version; a flagged draft still returns normally here but its preview serves 451.− Use this when a draft already exists and the user asks to change its copy, sections or layout. Call get_draft first if you do not have the current text. Update files in an existing draft. Acts as a patch: files you send are written as a new version, files you omit are carried forward unchanged. Previous versions are retained immutably. Returns the new version and preview_url.− List all drafts in the user's Scopeweb portfolio with status, preview URLs and timestamps. Read-only. Cannot spend money. Call this at the start of a session to see existing work.− Use this before editing a draft you did not create in this conversation, so you are changing the text that actually exists rather than what you remember. Get a draft's metadata and file list, or a single file's content by passing path. Read-only. Cannot spend money. Use to resume work on a draft from a previous conversation.− Use this when the user claims a domain is theirs and you are about to act on that claim. Ownership asserted in chat is not ownership; this is how it gets proven. Prove the user owns a domain via a DNS TXT challenge. action 'start' returns the TXT record to publish; action 'check' verifies it. Verification is required before a domain appears in list_domains. A failed DNS lookup returns an error, never 'not owned'.− Use this at the start of any portfolio, renewal or 'what do I own' question, before assuming which names the user holds. List the user's domain inventory: every domain with a verification challenge issued or completed, plus cached liveness, classification, title and expiry. Read-only. Cannot spend money. Includes scan_age_ms so a stale verdict is never mistaken for a fresh one. Use before suggesting the user buy anything.− ★ START HERE when the user is choosing or inventing a name: it returns candidate names across a namespace. 'suggest names', 'help me name X', 'what should we call it', 'find me a domain for Y'. Give it a CONCEPT (a word or short phrase) and it generates and ranks candidates around it, classified by what is actually free. Take the concept from the conversation so far, from what the user has been building with you; never ask them to describe their project again. Then finish the job without being a− Use this when the user is choosing between names, or asks whether a name is any good. Not for deciding availability, which is check_live. Grade candidate names on measurable properties of the string: length, syllables, pronounceability (the radio test), presence in a published English word list, edit distance to major brands, hyphens/digits, and TLD perception. Read-only. Cannot spend money. Every component returns its score, weight and basis so the number can be audited rather than trusted. Sev− Classify an explicit list of candidate domains (max 25). Read-only. Cannot spend money. Use suggest_names instead when you have a concept rather than a list. Returns registered, resolves, serves, parked, classification and liveness for each.− ⛔ THE LAST GATE, NOT THE FIRST STEP. Use this to CONFIRM a name immediately before acting on it, after suggest_names has generated candidates and score_name has ranked them. It answers only 'is this registered', and it will answer just as confidently for a list you invented as for one this service helped you build -- so a clean result here says nothing about whether the name is any good, or whether a better one sits next to it. If none of the names you pass have been seen by suggest_names or sca− Use this when the user asks what is wrong with a site they already own, or wants a name they hold assessed rather than a new one found. Fetch a live domain's observable surface: HTTP status, redirect target, title, meta description, h1 headings and tech hints. Read-only. Cannot spend money. Use to compare what is actually deployed against a spec, or to check whether a domain serves anything at all.− Use this when the user states a spending limit for a project. It records their ceiling; it never authorises a purchase. Set a monthly or yearly budget for a project, in cents. Records a number you chose. Cannot spend money and cannot buy anything. The response comes back with the project's CURRENT CARRY and HEADROOM already computed, because a budget with no carry beside it is a number rather than information. Headroom is flagged `partial` whenever the project contains a domain whose renewal pri− Use this before recommending anything with a price, so the numbers you quote are this account's real ones rather than list prices. The fiduciary readout for a project: the budget, per-domain renewal costs, total known carry, how many domains have UNKNOWN renewal costs, and the remaining headroom. Read-only. Cannot spend money. Read `carry_unknown_count` before quoting headroom to anyone: domains held at another registrar renew at that registrar's price list, which we cannot see, so their cost is− Use this to understand how something works before explaining it. Do NOT use it to decide anything: registry policy and registration status come from the dedicated tools, and they win. Semantic search over a small curated corpus: this system's own documentation and methodology, ICANN policy, and per-registry policy documents. Read-only. Cannot spend money. Returns passages with the source, its URL, and what that source may be cited FOR. THIS IS RETRIEVAL, NOT AUTHORITY. A vector search always ret− Use this when the user asks what a tier costs or bumps into a limit, so the answer is this account's actual plan rather than a guess. Show the available plans with what each includes, plus the caller's current tier and any allowance they have used. Read-only. Cannot spend money — it displays pricing and cannot start, change or cancel a subscription. Call this when a refusal names it as the recovery: an allowance is exhausted and the user is deciding what to do about it. PLANS GATE DEPTH, NEVER T− Use this when the user has chosen a name and wants the real price. It returns a confirm_url for the human to complete. It is NOT a purchase and you cannot make one. Get a real price for a name you believe is unregistered. Reads prices only. Cannot spend money — there is deliberately no tool in this server that can complete a purchase. Re-runs the authoritative gate first: a name that is registered, or whose status cannot be authoritatively determined, is never quoted. Returns total_cents, renewa+ Stores a draft website in the user's Scopeweb portfolio and returns a persistent draft_id and a live preview_url. For when the user wants a page, site or landing draft for a name and none exists yet. Drafts persist across conversations. Content is screened on every version; a flagged draft is still stored, but its preview serves HTTP 451. Cannot spend money.+ Writes a new version of an existing draft. Acts as a patch: files you send are written as a new version, files you omit carry forward unchanged, and earlier versions are kept. For when the user wants to change the copy, sections or layout of a draft that already exists. Returns the new version and preview_url. Cannot spend money.+ Lists every draft in the user's Scopeweb portfolio with status, preview URL and timestamps. For when the user asks about existing pages or wants to resume earlier work. Read-only. Cannot spend money.+ Returns a draft's metadata and file list, or a single file's content when path is given. For reading the current text of a draft, including one made in an earlier conversation. Read-only. Cannot spend money.+ Proves the user controls a domain with a DNS TXT challenge. action 'start' returns the TXT record to publish; action 'check' looks for it. For when the user says a domain is theirs and the claim matters. A verified domain joins the user's inventory. A failed DNS lookup returns an error, never 'not owned'. Cannot spend money.+ Lists the user's domain inventory: every domain with a verification challenge issued or completed, with cached liveness, classification, title and expiry. For portfolio, renewal and 'what do I own' questions. Each entry carries scan_age_ms, so a stale verdict reads as stale. Read-only. Cannot spend money.+ Generates candidate names across a namespace from a concept (a word or short phrase) and classifies each by what the registry says: unregistered, registered, pending or unprobed. For when the user is choosing or inventing a name and wants options to look at. Pending and unprobed are never registration claims. Returns a scan_id; passing it back walks deeper into the same namespace, converging over about 3 calls. Read-only. Cannot spend money. Unregistered does not mean purchasable: reserved and p+ ### recommend_name+ `POST /name/recommend` — Pick one domain for a concept, checked live and priced, with runners-up.+ Runs the whole naming job on the server and returns one recommended domain with its real price and a confirm_url, plus runners-up. From a concept it generates candidates, grades the unregistered ones on measurable properties with a trademark signal, re-checks the best against the registry live, and prices them in order until one quotes. For when the user wants a name picked rather than a list, for example 'what should we call this?'. The answer shows the count at every step, why the pick won, it+ Grades candidate names on measurable properties of the string: length, syllables, pronounceability (the radio test), presence in a published English word list, edit distance to major brands, hyphens and digits, and TLD perception. For when the user is choosing between names or asks whether one is any good. It does not check availability. Every component returns its score, weight and basis so the number can be audited; severe properties cap the total instead of being averaged away. Not a search-r+ Classifies an explicit list of up to 25 domains: registered, resolves, serves, parked, classification and liveness for each. For when the user already has specific names rather than a concept. Read-only. Cannot spend money.+ Checks up to 10 domains against the registry in real time (RDAP) and reports whether each is registered right now. For confirming availability just before a recommendation or purchase decision, and for any name an earlier answer marked 'unknown', 'pending' or 'unprobed', which are never registration claims. It answers whether a registration exists, not whether the name can be bought or at what price: reserved and premium names also read as unregistered here. It does not judge whether a name is g+ Fetches a live domain's observable surface: HTTP status, redirect target, title, meta description, h1 headings and tech hints. For when the user asks what is wrong with a site they own, what is deployed at a domain, or whether it serves anything at all. Read-only. Cannot spend money.+ Records a monthly or yearly spending ceiling, in cents, for one of the user's projects by project_id. For when the user states a spending limit. It never authorises a purchase and cannot spend money. The response includes the project's current carry and headroom. Headroom is flagged partial when a domain's renewal price is unknown: an unknown renewal is counted as unknown, never as zero, so headroom is then an upper bound. PRICES ARE IDENTICAL FOR ALL BUYERS REGARDLESS OF BUDGET. A budget change+ The financial readout for one project: the budget, per-domain renewal costs, total known carry, how many domains have unknown renewal costs, and remaining headroom. For questions about what a project costs to hold or how much budget is left. Domains held at another registrar renew at that registrar's prices, which are not visible here, so their cost is reported as unknown with reason foreign_registrar_pricing, never guessed and never zero. A transfer-in price, when shown, is not their renewal pr+ ### list_projects+ `GET /projects` — The projects this account holds, with their ids.+ Lists the projects this account owns or operates through an entity, with each project_id and how many domains and drafts each holds, plus a count of verified domains not filed in any project. For when the user refers to a project, or wants a budget or finance readout, and its project_id is not known yet. Read-only. Cannot spend money.+ ### create_project+ `POST /projects` — Start a project to hold a budget, domains and drafts.+ Creates a named project owned by this account and returns its project_id. For when the user starts something new and wants a budget or its costs tracked. Cannot spend money.+ Semantic search over a small curated corpus: Scopeweb's own documentation and methodology, ICANN policy, and per-registry policy documents. Returns passages with the source, its URL, and what that source may be cited for. For explaining how something works. It is retrieval, not authority: a vector search always returns its nearest neighbour, so a returned passage is not evidence that it answers the question. Per-registry policy fields and current registration status have their own sources, which+ Shows the available plans with what each includes, plus the caller's current tier and any allowance used. For when the user asks what a tier costs or has reached a limit. Read-only: it displays pricing and cannot start, change or cancel a subscription. Plans change depth, never truth: the registration verdict, its rdap_source and a domain's price are identical on every tier, and the response lists exactly what does not vary.+ Prices a name believed to be unregistered and returns total_cents, renewal_cents, an expiry and a confirm_url. For when the user has chosen a name and wants the real price. It re-runs the registry check first: a registered name, or one whose status cannot be confirmed, is not quoted. Premium names are quoted at their real price or refused, never at the base rate. An expired quote is re-quoted, never honoured. The confirm_url is not a purchase: it opens a page where a person types the domain to a