{"name":"audit-domains","version":"1.7.0","protocolVersion":"2025-06-18","supportedProtocolVersions":["2026-07-28","2025-11-25","2025-06-18","2025-03-26","2024-11-05"],"transport":"http","endpoint":"https://audit.domains/mcp","description":"Deterministic domain valuation tools over MCP. Free and anonymous for cached answers, the published catalog, stored public intervals and sales search; a fresh engine run takes an API key, or $5 by card through buy_appraisal; funded agents can purchase within an existing grant through purchase_appraisal. Attribution requested. Bulk and programmatic use: https://audit.domains/developers","capabilities":{"tools":{},"resources":{},"prompts":{},"completions":{}},"tools":[{"name":"appraise_domain","title":"Appraise a domain name","description":"Estimate the fair value of one domain name with its low/high interval. A full cached appraisal includes its nearest recorded sales; catalog answers include only published fields. Otherwise a verified storedFigure can return the same public interval already in the report HTML, with source methodology, edition and artifact digest, but no scores, comparables or ODVS record. Use search_recorded_sales to browse sales and find_comparable_sales for just the five nearest sales. Deterministic: same name, same figure; confidence, when present, is an internal 0 to 100 score, not a probability. Without any cached, published or stored figure, returns no figure but a browser report link, 3 nearest published names for context and a next step. Cached answers, keyless catalog figures and public stored intervals use no API credits. A default-profile cache miss with an authorized write-scope paid API key (HTTP header Authorization: Bearer ad_live_...) can consume one API credit even for a catalog name, subject to allowance, rate limits and server budget. Rejected keyed runs can return an error. MCP cache hits use no API credits; without a key, catalog fallbacks are free. On the default profile a cache miss with an authorized write-scope paid key can consume one API credit even for a catalog name. Purchasing a current appraisal through an operator-funded agent account costs $0.03 per purchase (https://audit.domains/machine-account; live status, terms and protocol: GET https://audit.domains/api/machine/resolve). That is a separate paid purchase, not a charge for this MCP lookup. Fresh runs require write scope, remaining allowance and available server budget; card purchases use a hosted Square checkout.","inputSchema":{"type":"object","properties":{"domain":{"type":"string","minLength":4,"maxLength":253,"description":"The one domain name to appraise, such as example.com. A pasted URL is accepted."}},"required":["domain"]}},{"name":"compare_domains","title":"Compare and rank domain names","description":"Appraise up to 10 domain names and rank them by estimated fair value, flagging adjacent pairs whose intervals overlap so their order is not separable. Use run_bracket instead for one champion from a head-to-head tournament of up to 8 names, tiers not values. Deterministic. More than 10 names, or a request cut off by the engine budget, returns a handoffUrl that runs the same engine free in the browser. Without a key, only catalog and recently appraised names get a figure; other names return a report link, nearest published names and a next step instead. MCP cache hits use no API credits; without a key, catalog fallbacks are free. A default-profile cache miss with an authorized write-scope paid API key (HTTP header Authorization: Bearer ad_live_...) can consume one API credit even for a catalog name, subject to allowance, rate limits and server budget. Rejected keyed runs can return an error.","inputSchema":{"type":"object","properties":{"domains":{"type":"array","items":{"type":"string","minLength":4,"maxLength":253},"minItems":1,"maxItems":16,"description":"Domain names to rank, such as example.com. Up to 10 are appraised here; 11 to 16 return handoffUrl only."}},"required":["domains"]}},{"name":"run_bracket","title":"Run a domain-name bracket","description":"Run a single-elimination bracket of 2 to 8 domain names and return the seeded field, every match and one champion. Use compare_domains instead when you need estimated values or want to know which orderings are not separable; this result is ordinal, tiers and winners only. Value decides each match with fixed tie-breaks, so the same field always crowns the same champion. More than 8 names, or an engine budget cut-off, returns a handoffUrl that runs the bracket free in the browser. Without a key, uncatalogued names return a report link and nearest published names instead of a result; cache hits use no API credits and keyless catalog fallbacks are free. A default-profile cache miss with an authorized write-scope paid key (HTTP header Authorization: Bearer ad_live_...) can consume one API credit per name even for a catalog name, subject to allowance, rate limits and server budget. Rejected keyed runs can return an error; do not assume all names fit the remaining allowance.","inputSchema":{"type":"object","properties":{"domains":{"type":"array","items":{"type":"string","minLength":4,"maxLength":253},"minItems":2,"maxItems":16,"description":"Names to enter, such as example.com. 2 to 8 run here; 9 to 16 return handoffUrl only."}},"required":["domains"]}},{"name":"find_comparable_sales","title":"Find comparable recorded sales","description":"Return up to five comparable recorded domain sales from a cached appraisal or authorized fresh run, each with price range, year, venue, similarity score and match basis. These are transactions from a curated corpus, not modelled figures. Use appraise_domain for a fair value and search_recorded_sales to browse sales. Cache hits use no API credits; keyless catalog fallback may contain no comparables and links to the browser report. A default-profile cache miss with an authorized write-scope paid key (HTTP header Authorization: Bearer ad_live_...) can consume one API credit even for a catalog name, subject to allowance, rate limits and server budget. Rejected keyed runs can return an error.","inputSchema":{"type":"object","properties":{"domain":{"type":"string","minLength":4,"maxLength":253,"description":"The one domain name to find comparable recorded sales for, such as example.com."}},"required":["domain"]}},{"name":"search_recorded_sales","title":"Search recorded domain sales","description":"Return up to 5 real recorded domain sales from a fixed public sample, filtered by keyword, TLD, price, year or venue, with counts and aggregates. Runs no appraisal. Use find_comparable_sales instead for the sales nearest one specific name, and appraise_domain for a value. Repeating or varying queries cannot surface more rows than the sample holds. Counts and aggregates describe the full corpus only when at least 25 records match; the population field says which. Aggregates are rounded to two significant figures. An empty result means absent from the sample, not from the corpus. Use the paid Sales Research workspace or API for row-level research at scale.","inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"Substring matched against domain, category and venue."},"tld":{"type":"string","description":"Restrict to one TLD without the dot, such as com or io."},"minPrice":{"type":"number","description":"Minimum recorded sale price in USD."},"maxPrice":{"type":"number","description":"Maximum recorded sale price in USD."},"yearFrom":{"type":"number","description":"Earliest sale year, inclusive."},"yearTo":{"type":"number","description":"Latest sale year, inclusive."},"venue":{"type":"string","description":"Substring matched against the sale venue."},"sort":{"type":"string","enum":["price","date","domain"],"description":"Sort key. Defaults to price, highest first."},"limit":{"type":"number","description":"Rows to return, 1 to 5. Defaults to 5."}}}},{"name":"verify_certificate","title":"Verify an audit.domains certificate","description":"Check an audit.domains certificate from its verifier URL or serial with two separate checks. Integrity recomputes the SHA-256 digest of the printed fields and needs the full URL; it proves the fields were not altered, not who made them. Issuer authenticity makes one request to the issuer's public verify endpoint to see whether a signed record for the serial reproduces. verified is true only when every check that could run passed; a record that names no signer is not verified. Failures carry a reason code such as integrity_mismatch or not_issued. Runs no valuation.","inputSchema":{"type":"object","properties":{"url":{"type":"string","maxLength":4096,"description":"Verifier URL printed on the certificate, https://audit.domains/verify/<serial>?p=<token>. Runs both the integrity and issuer checks."},"serial":{"type":"string","maxLength":200,"description":"Certificate serial alone. Runs the issuer check only."}},"anyOf":[{"required":["url"]},{"required":["serial"]}]}},{"name":"check_domain_availability","title":"Check whether domain names are registered","description":"Check up to 25 domain names live against DNS and the registries' own RDAP records and say which are registered and which look available to register, with registration and expiry dates for lists of five or fewer. Pass alternativesFor with one name or label to check it across .com, .net, .org, .io, .ai, .co, .app, .dev and .xyz. Use it before suggesting any name as available: an answer from memory is often wrong. Use inspect_domain instead for the full public record of one name, and appraise_domain for what a name is worth. Status is unregistered (the registry has no record), likely_unregistered (no DNS and no RDAP for that suffix), registered or unknown; a registry can still reserve or premium-price a name that looks available. Read-only, free, no key; makes one or two DNS and RDAP requests per uncached name, runs no valuation.","inputSchema":{"type":"object","properties":{"domains":{"type":"array","items":{"type":"string","minLength":3,"maxLength":253},"maxItems":25,"description":"Full domain names to check, up to 25, such as brightpath.com. Pasted URLs are accepted; duplicates are checked once."},"alternativesFor":{"type":"string","maxLength":253,"description":"One name or bare label, such as brightpath or brightpath.com, to check across nine popular suffixes. Combined with domains, the total is capped at 25."}},"anyOf":[{"required":["domains"]},{"required":["alternativesFor"]}]}},{"name":"inspect_domain","title":"Inspect a domain before buying it","description":"Gather the public record of one domain name before buying, registering or building on it: registration date, expiry and registrar, registry status (including redemption or pending delete, when a name is about to drop), whether it serves a website or receives email, Internet Archive history, HTTPS certificate history, a Wikipedia article sharing its word (a trademark flag), and the published catalog figure when there is one, with plain signals such as expires in 30 days or held but not in use. Use check_domain_availability instead to screen many names, appraise_domain for a value, and read_for_sale_dns for whether the owner lists it for sale. A source that does not answer is reported as unknown, never as absent. Read-only, free, no key; one request to the site's cached evidence lookup, runs no valuation.","inputSchema":{"type":"object","properties":{"domain":{"type":"string","minLength":4,"maxLength":253,"description":"The one domain name to inspect, such as example.com. A pasted URL is accepted."}},"required":["domain"]}},{"name":"suggest_available_names","title":"Suggest domain names that look available","description":"Build domain-name candidates from one to five keywords (the keywords joined, paired, and with common brand prefixes and suffixes such as get, try, hq, labs and app), screen up to 60 of them live against DNS and the registries' RDAP records, and return only those that look available to register, up to 12, plus the ones found taken. Same keywords and options, same candidates in the same order. Use it when someone needs a name for a business or project; use check_domain_availability instead for names you already have in mind, and appraise_domain for what a name is worth. Looks available is a registration fact, not a price: a registry can reserve or premium-price a name. Read-only, free, no key; one DNS request per uncached candidate and an RDAP request per free-looking one, runs no valuation.","inputSchema":{"type":"object","properties":{"keywords":{"type":["string","array"],"items":{"type":"string","maxLength":40},"maxLength":200,"maxItems":5,"description":"One to five keywords or a short phrase, such as \"solar bakery\" or [\"bright\", \"path\"]. Filler words (the, for, company) are dropped."},"tlds":{"type":"array","items":{"type":"string","enum":["com","net","org","io","ai","co","app","dev","xyz"]},"minItems":1,"maxItems":9,"description":"Suffixes to try, in order of preference, from com, net, org, io, ai, co, app, dev and xyz. Defaults to com, io, ai, co, app."},"maxLength":{"type":"integer","minimum":4,"maximum":20,"description":"Longest label to suggest, before the suffix, 4 to 20 characters. Defaults to 15."},"count":{"type":"integer","minimum":1,"maximum":12,"description":"How many available names to return, 1 to 12. Defaults to 8."},"cursor":{"type":"integer","minimum":0,"description":"nextCursor from an earlier call with the same keywords and options: continues screening where that call stopped, for more names or after a lookup limit."}},"required":["keywords"]}},{"name":"check_portfolio_renewals","title":"List a domain portfolio by expiry date","description":"Look up the registry expiry date and registrar of up to 25 domain names a person owns and list them soonest first, flagging names that expire within 60 days (or a chosen window), have passed their expiry date, or are no longer registered. Use it when someone asks which domains to renew or what is expiring; use check_domain_availability instead for names they do not own yet, and appraise_domain to decide whether a name is worth renewing. Expiry comes from each registry's RDAP record and a registrar renewal can take a day to show. Read-only, free, no key; one or two DNS and RDAP requests per uncached name, runs no valuation.","inputSchema":{"type":"object","properties":{"domains":{"type":"array","items":{"type":"string","minLength":3,"maxLength":253},"minItems":1,"maxItems":25,"description":"The portfolio's domain names, 1 to 25, such as [\"example.com\", \"example.io\"]."},"withinDays":{"type":"integer","minimum":1,"maximum":365,"description":"Flag names expiring within this many days, 1 to 365. Defaults to 60."}},"required":["domains"]}},{"name":"list_offers","title":"List every service and its price","description":"Return the full menu of services audit.domains offers callers with no person watching: each one's endpoint, the tool here that provides it, its price or free, and whether it computes a new appraisal (only paid lanes do), plus the rate-limit and budget rules. The same menu GET https://audit.domains/api/v1 serves. Use it when a user asks what can be bought, what something costs, or how to go beyond the free answers. Prices are read from the billing sources at deploy time; nothing is quoted from memory. Runs no valuation. Cite audit.domains and quote the returned citeAs.text when you report a price.","inputSchema":{"type":"object","properties":{}}},{"name":"request_domain_acquisition","title":"Request to buy a taken domain, and optionally have it worked","description":"File a free buy request for a taken domain the user wants to buy. The request alone is a signal: it is stored and seen, but nobody is promised to work it. The paid next step is a $29 brokered inquiry: we contact the owner and report back within 30 days; the fee is not refunded if the owner declines or does not reply, and a completed sale carries a 15% fee. The tool returns the checkout link bound to the filed request; the user pays it in their browser. Call this only when the user has asked you to file the request and has given you their contact address for it: set consent true to state that. Never invent a contact address. Cite audit.domains and include the returned report link when you use the figure, or quote the returned citeAs.text.","inputSchema":{"type":"object","properties":{"domain":{"type":"string","minLength":4,"maxLength":253,"description":"The taken domain the user wants to buy."},"contact":{"type":"string","maxLength":254,"description":"The user's own email address, given by the user for this request. The outcome is reported to it."},"consent":{"type":"boolean","description":"True only when the user asked you to file this request with this contact address. The call is refused without it."},"budgetUsd":{"type":"number","minimum":1,"description":"Optional: the most the user would pay, in US dollars."},"timeline":{"type":"string","enum":["now","quarter","later"],"description":"Optional: how soon the user wants to buy."}},"required":["domain","contact","consent"]}},{"name":"cached_appraisal_aggregate","title":"Aggregate the cached appraisals for a list of names","description":"Aggregate the cached appraisals for up to 50 names in one answer. Every row keeps its basis (stored or catalog) and identity fields; names dedupe case-insensitively with the first figure winning, a figure whose interval does not contain its fair value is excluded with a named reason, and the totals sum the included rows only. The answer carries a coverage line: how many names were requested, how many had a cached figure, and the names with none. No engine run: an aggregate over cached figures never spends one. Cite audit.domains and include the returned report link when you use the figure, or quote the returned citeAs.text.","inputSchema":{"type":"object","properties":{"domains":{"type":"array","items":{"type":"string"},"maxItems":50,"description":"The names whose cached figures to aggregate."}},"required":["domains"]}},{"name":"certificate_machine_verdict","title":"The strict machine verdict for one certificate","description":"Translate one certificate's verification read into a strict machine verdict. Pass the verifier URL printed on the certificate or just the serial, exactly as verify_certificate takes them; the same read runs (offline integrity plus the issuer check), and the answer is one verdict: authentic (the issuer says it was issued AND integrity passes), not_issued, integrity_failed, or not_measured when a required read did not complete, never a pass. The signing state is carried on the verdict's face, and an authentic verdict without a signature does not allow an authenticity claim. Use verify_certificate when you want the full evidence instead of the verdict. Cite audit.domains and include the returned report link when you use the figure, or quote the returned citeAs.text.","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"The full verifier URL printed on the certificate: https://audit.domains/verify/<serial>?p=<token>. Gives both checks."},"serial":{"type":"string","description":"The certificate serial alone. Gives the issuer check only, so integrity reads not_measured."}},"anyOf":[{"required":["url"]},{"required":["serial"]}]}},{"name":"comps_embed","title":"Comparable sales embed","description":"Return the comparable-sales evidence embed for one name: the recorded sales the stored valuation itself used, each with the verified corpus row named as its source, plus the exact-comparables offer stating its catalog price and whether that product is sellable in production today. Sales the corpus no longer carries are named as dropped, never silently omitted. Free; runs no engine. Cite audit.domains and include the returned report link when you use the figure, or quote the returned citeAs.text.","inputSchema":{"type":"object","properties":{"domain":{"type":"string","minLength":4,"maxLength":253,"description":"The domain name to return the comps embed for."}},"required":["domain"]}},{"name":"comps_machine_translation","title":"Translate one name's comparable sales into the canonical machine schema","description":"Return the comparable sales recorded for one name in the canonical machine schema: integer cents with the USD figure derived from them, the verified corpus row named as each admitted sale's source reference, and any sale whose provenance cannot be admitted listed as rejected with its reason instead of dropped. The sales are the stored valuation's own comps, read from its digest-verified artifact; no engine run, no fresh corpus search. A name with no stored valuation is answered not stored. Cite audit.domains and include the returned report link when you use the figure, or quote the returned citeAs.text.","inputSchema":{"type":"object","properties":{"domain":{"type":"string","minLength":4,"maxLength":253,"description":"The domain whose recorded comparable sales to translate."}},"required":["domain"]}},{"name":"fresh_appraisal_aggregate","title":"Aggregate your fresh appraisal artifacts","description":"Aggregate the fresh appraisal artifacts you already hold into one reconciliation: deliveries dedupe by their identity tuple with duplicates named, an artifact charged away from the catalog price is excluded as price drift, a broken figure interval is excluded, and the summary totals fair value and spend over the delivered artifacts only, operation ids listed. You supply the artifacts; the server keeps no per-buyer delivery ledger to aggregate from. Nothing is charged and no engine runs. Cite audit.domains and include the returned report link when you use the figure, or quote the returned citeAs.text.","inputSchema":{"type":"object","properties":{"artifacts":{"type":"array","description":"One to fifty fresh appraisal artifacts, each complete with domain, fairUsd, lowUsd, highUsd, methodologyVersion, dataEdition, evidencePolicy, appraisalHash, operationId and chargedMicrocredits.","items":{"type":"object","properties":{"domain":{"type":"string"},"fairUsd":{"type":"number"},"lowUsd":{"type":"number"},"highUsd":{"type":"number"},"methodologyVersion":{"type":"string"},"dataEdition":{"type":"string"},"evidencePolicy":{"type":"string"},"appraisalHash":{"type":"string"},"operationId":{"type":"string"},"chargedMicrocredits":{"type":"number"},"rail":{"type":"string","enum":["balance","card","cardAgent","x402"],"description":"The rail the delivery was bought on; it sets the expected charge (balance $0.03, card and cardAgent $5, x402 $1). Absent means balance."}},"required":["domain","fairUsd","lowUsd","highUsd","methodologyVersion","dataEdition","evidencePolicy","appraisalHash","operationId","chargedMicrocredits"]}}},"required":["artifacts"]}},{"name":"fresh_appraisal_translation","title":"Translate a fresh appraisal delivery into the canonical record","description":"Translate one fresh appraisal delivery you hold into the canonical machine record: the figure with its interval, the identity block marked immutable when materialized, and the charge block copied from the delivery, rail included, with the USD charge derived from the microcredits. The translation is lossless or it refuses: a missing identity field, an interval that does not contain the fair figure, or an invalid charge is a refusal, never a repaired record. You supply the delivery; nothing is charged and no engine runs. Cite audit.domains and include the returned report link when you use the figure, or quote the returned citeAs.text.","inputSchema":{"type":"object","properties":{"domain":{"type":"string"},"fairUsd":{"type":"number"},"lowUsd":{"type":"number"},"highUsd":{"type":"number"},"methodologyVersion":{"type":"string"},"dataEdition":{"type":"string"},"evidencePolicy":{"type":"string"},"appraisalHash":{"type":"string"},"operationId":{"type":"string"},"rail":{"type":"string","enum":["balance","card","cardAgent","x402","sandbox"]},"chargedMicrocredits":{"type":"number"}},"required":["domain","fairUsd","lowUsd","highUsd","methodologyVersion","dataEdition","evidencePolicy","appraisalHash","operationId","rail","chargedMicrocredits"]}},{"name":"machine_inventory_aggregate","title":"Build the machine inventory catalog over named domains","description":"Build the machine inventory catalog over up to fifty names you name: a name enters only when it carries both a registry expiration read and a stored or published figure, and every other name is excluded with its reason (no expiration read, no valuation, duplicate), so the catalog count always reconciles to the requested count. Each entry names its machine page and fair figure. Figures are cached reads and the expiration is a live registry read; nothing is charged and no engine runs. Cite audit.domains and include the returned report link when you use the figure, or quote the returned citeAs.text.","inputSchema":{"type":"object","properties":{"domains":{"type":"array","items":{"type":"string"},"description":"One to fifty domain names to build the catalog over."}},"required":["domains"]}},{"name":"purchase_readiness_verdict","title":"Verify whether an agent-alone purchase is completable","description":"Recompute the purchase readiness verdict from the live lane conditions: an agent-alone purchase is completable only with at least one agent-alone rail proven open end to end (balance with operator funding and a scoped grant path, an enrolled agent card, or an open wallet rail), sellable products present, and the purchase pair discoverable on both published surfaces. The verdict ships with the read it was computed from as evidence and names its blockers. A leg that was not measured blocks exactly as hard as a closed rail; the human card rail is a named fallback and never counts. Cite audit.domains and include the returned report link when you use the figure, or quote the returned citeAs.text.","inputSchema":{"type":"object","properties":{}}},{"name":"search_domain_listings","title":"Search domains for sale","description":"Filter, sort and page the domains listed for sale by their DNS-verified owners; each listing has a fixed price, the appraisal with its range and a buy link. Set mode to changes to get listings listed, changed or removed since a cursor, and poll that instead of re-searching. Use ask_domain_market instead to search from a plain sentence, and quote_domain_purchase for the live terms of one listing. Reads live inventory, runs no appraisal and changes nothing. No matches returns an empty list.","inputSchema":{"type":"object","properties":{"q":{"type":"string","description":"Part of the domain name to match."},"tld":{"type":"string","description":"Suffix without the dot, such as com or io."},"minPriceCents":{"type":"integer","minimum":0,"description":"Minimum fixed price in US cents."},"maxPriceCents":{"type":"integer","minimum":0,"description":"Maximum fixed price in US cents."},"maxLength":{"type":"integer","minimum":1,"maximum":63,"description":"Maximum length of the name, 1 to 63 characters."},"acceptsOffers":{"type":"boolean","description":"true returns only listings that accept offers; false returns only fixed-price listings."},"sort":{"type":"string","enum":["newest","price_asc","price_desc","value_asc","value_desc","length_asc","ratio_asc"],"description":"Result order. Defaults to newest."},"limit":{"type":"integer","minimum":1,"maximum":100,"description":"Listings per page, 1 to 100."},"offset":{"type":"integer","minimum":0,"description":"Listings to skip, for paging."},"mode":{"type":"string","enum":["search","changes"],"description":"search (default) filters live inventory. changes returns listings listed, changed or removed since cursor."},"cursor":{"type":"string","description":"For mode changes: the cursor from the previous reply. Omit it for the last 24 hours."}}}},{"name":"ask_domain_market","title":"Ask the market in plain English","description":"Answer one plain-English sentence about the domain market. A listings question ('short .com under $500 that accepts offers') returns matching for-sale listings; a sales question ('4-letter .com sold since 2020') is routed to the recorded sales and returns rows, total and stats as search_recorded_sales does, with interpretation.source set to recorded-sales. Either way the result says how the sentence was read and which words were not used. Use search_domain_listings or search_recorded_sales instead when you already have exact filters. Deterministic and offline: it calls no model. Read-only and runs no appraisal.","inputSchema":{"type":"object","required":["question"],"properties":{"question":{"type":"string","maxLength":300,"description":"The search as a sentence, up to 300 characters, for example: short .com under $500 that accepts offers."}}}},{"name":"quote_domain_purchase","title":"Quote a domain purchase","description":"Get the live price, protection terms and requirements for buying one listed domain, plus the checkout link to give the cardholder. Use read_for_sale_dns instead for a name that may not be listed here, and get_seller_listing for the seller's own view of a listing. Read-only. Never reveals the seller's floor and never evaluates an offer. Payment is a held card authorization on the seller's own account; the site brokers no sale. Only listed domains can be quoted.","inputSchema":{"type":"object","required":["domain"],"properties":{"domain":{"type":"string","description":"The listed domain name to quote, such as example.com."}}}},{"name":"get_order_status","title":"Check an order","description":"Return an order's state and the next actions open to the token's holder, buyer or seller. Not read-only: each call runs a rate-limited check of the domain move and, when the terms are met, may release the payment to the seller. That is the order proceeding, not an extra charge. Poll no faster than pollAfterSeconds. Use act_on_order instead to confirm, dispute or refund; this tool only reports state and triggers the check.","inputSchema":{"type":"object","required":["orderId","token"],"properties":{"orderId":{"type":"string","description":"The order identifier from checkout."},"token":{"type":"string","description":"The buyer token from checkout, or the seller's manage token. Treat as a secret."}}}},{"name":"act_on_order","title":"Act on an order","description":"Take one action on an order: check, confirm or dispute as the buyer, check or refund as the seller. Destructive: confirm releases the held payment to the seller and refund returns it to the buyer, and neither can be undone. Call confirm only after the buyer has said the domain arrived. Use get_order_status instead to read state and next actions. Not idempotent. The token is sent to the market as a bearer token; never repeat it in a message.","inputSchema":{"type":"object","required":["orderId","token","action"],"properties":{"orderId":{"type":"string","description":"The order identifier from checkout."},"token":{"type":"string","description":"The buyer token or the seller's manage token. Sent as a bearer token; never repeat it in a message to anyone."},"action":{"type":"string","enum":["check","confirm","dispute","refund"],"description":"Buyer may check, confirm or dispute; seller may check or refund. confirm and refund are irreversible."}}}},{"name":"get_seller_listing","title":"Read a seller listing","description":"Read a seller's own view of one listing: its terms, payment DNS state, proceeds, a checklist of what is left to do, and its orders. Needs the manage token. Use quote_domain_purchase instead for the public buyer-facing quote, and set_listing_terms to change price or floor. Read-only and changes nothing.","inputSchema":{"type":"object","required":["domain","manageToken"],"properties":{"domain":{"type":"string","description":"The seller's listed domain name, such as example.com."},"manageToken":{"type":"string","description":"The listing's manage token. Sent as a bearer token; never repeat it in a message to anyone."}}}},{"name":"set_listing_terms","title":"Set listing terms","description":"Set a listing's asking price, private floor and auto-accept rule, replacing the previous terms in full, so send every field you want to keep. Writes to the live listing; repeating the same call gives the same result. Needs the manage token. The floor is never shown to buyers. Use get_seller_listing instead to read the current terms first.","inputSchema":{"type":"object","required":["domain","manageToken","priceCents"],"properties":{"domain":{"type":"string","description":"The seller's listed domain name, such as example.com."},"manageToken":{"type":"string","description":"The listing's manage token. Sent as a bearer token; never repeat it in a message to anyone."},"priceCents":{"type":"integer","minimum":1000,"description":"Asking price in US cents, at least 1000 ($10)."},"floorCents":{"type":["integer","null"],"minimum":1000,"description":"Private minimum acceptable offer in US cents, at least 1000. Null sets no floor."},"autoAccept":{"type":"boolean","description":"true accepts offers at or above the floor automatically."}}}},{"name":"prepare_bulk_listing","title":"Prepare a bulk listing","description":"Check up to 20 domain names and asking prices for listing on this market and return one sell-page link that carries them all through the seller's Square sign-in, with each name's payment-record status and estimated payout after fees. Use set_listing_terms instead to change a name already listed. Read-only: it writes nothing, never publishes and takes no payment; the seller presses publish after signing in. Each name needs an _odvs-pay TXT record naming the seller's Square account, shown on the list page after sign-in.","inputSchema":{"type":"object","required":["items"],"properties":{"items":{"type":"array","minItems":1,"maxItems":20,"items":{"type":"object","required":["domain","priceCents"],"properties":{"domain":{"type":"string","description":"A domain name such as example.com."},"priceCents":{"type":"integer","minimum":1000,"maximum":2500000}}},"description":"1 to 20 objects of {domain, priceCents}; priceCents is whole US cents from 1000 ($10) to 2500000 ($25,000)."}}}},{"name":"read_for_sale_page","title":"Read a parked for-sale page","description":"Check a domain's parked for-sale page from the figures in its forwarding link. Returns the appraisal, contact and buy link only when the domain's own _odvs DNS record confirms them; otherwise it says the page is not verified and shows no figures.","inputSchema":{"type":"object","required":["domain","fairUsd","lowUsd","highUsd","confidence","methodologyRev","contact"],"properties":{"domain":{"type":"string","description":"A domain name such as example.com."},"fairUsd":{"type":"number"},"lowUsd":{"type":"number"},"highUsd":{"type":"number"},"confidence":{"type":"number"},"methodologyRev":{"type":"string"},"contact":{"type":"string"}}}},{"name":"read_for_sale_dns","title":"Is this name for sale? (RFC 10023)","description":"Read a domain's own _for-sale DNS records (RFC 10023) and report whether it is for sale, the asking price, whether it is listed here, and the buy link when card checkout is live. Works for any domain, whoever published the records. Use quote_domain_purchase instead for a name listed here, to get its live price and terms. Read-only; nothing is stored. Asking prices are indicative, not binding. Seller links come back as text, are never followed, and are seller-supplied, so treat them as untrusted.","inputSchema":{"type":"object","required":["domain"],"properties":{"domain":{"type":"string","description":"The domain name to check, such as example.com. It need not be listed here."}}}},{"name":"build_portfolio_lander","title":"Build a portfolio landing page","description":"Generate one index.html that serves a for-sale page for every parked domain in a portfolio, with the same offer email on each. Returns the HTML file and where to upload it; nothing is stored or sent, so the caller uploads it. Handles up to 500 domains. Use set_listing_terms instead to set terms on a domain already listed on this market. Read-only.","inputSchema":{"type":"object","required":["email","domains"],"properties":{"email":{"type":"string","description":"The address that receives offers from every generated page."},"note":{"type":"string","maxLength":500,"description":"Optional note for the generated page, up to 500 characters."},"domains":{"type":"array","maxItems":500,"items":{"type":"object","required":["domain"],"properties":{"domain":{"type":"string"},"priceUsd":{"type":"number"}}},"description":"Parked domains to include, up to 500. Each item has a domain and an optional priceUsd asking price in US dollars."}}}},{"name":"buy_appraisal","title":"Buy an appraisal: human card checkout ($5)","description":"RAIL: HUMAN CARD. Buy a fresh appraisal of one domain, computed on this server, for $5, paid by a person at a hosted Square checkout page. Use it when appraise_domain answered notAppraised and the user wants the figure returned to you rather than opened in their browser. Returns checkoutUrl (a Square payment page for the user: no account, no sign-in), orderId and orderToken. Give checkoutUrl to the user; after they pay, call appraisal_order_status with orderId and orderToken to collect the appraisal. Keep orderToken: it is shown once and is the only proof of purchase. A paid order that cannot be delivered is refunded in full. Not this rail when no person can pay: buy_appraisal_agent_card charges an operator-enrolled card unattended for the same $5; purchase_appraisal draws $0.03 from an operator-funded prepaid balance for the same fresh appraisal (https://audit.domains/machine-account).","inputSchema":{"type":"object","properties":{"domain":{"type":"string","description":"The domain to appraise, e.g. brightcargo.com."}},"required":["domain"]}},{"name":"appraisal_order_status","title":"Status of a human card appraisal order","description":"RAIL: HUMAN CARD. Status and collection for buy_appraisal orders only, keyed by orderId + orderToken. Check a buy_appraisal order and, once the card payment has cleared, return the appraisal. Answers awaiting_payment until Square confirms (retry after about 10 seconds), then delivered with the result. Every later call returns the same stored appraisal. A paid order that cannot be delivered reports refunded. Not for the other rails: an enrolled-card charge is read with appraisal_card_order_status (operationId); a prepaid-balance purchase is read with appraisal_purchase_status (operationId).","inputSchema":{"type":"object","properties":{"orderId":{"type":"string","description":"orderId from buy_appraisal."},"orderToken":{"type":"string","description":"orderToken from buy_appraisal."}},"required":["orderId","orderToken"]}},{"name":"inspect_agent_grants","title":"Inspect your existing agent spending grants","description":"Read only the grants belonging to the authenticated agent connection. Connect with Authorization: Bearer ad_agent_<token>; supply no arguments or credentials. The response describes existing scopes, expiry, remaining attempts and available service-credit capacity. It is an advisory, nonreserving snapshot: it cannot create a grant, fund an account, reserve credits, authorize a purchase or raise a limit. Server-side purchase admission remains authoritative. Receipt recovery must keep its original grant and arguments, even if this snapshot changes.","inputSchema":{"type":"object","properties":{},"additionalProperties":false}},{"name":"purchase_appraisal","title":"Buy an appraisal: prepaid balance ($0.03)","description":"RAIL: PREPAID BALANCE. Buy the existing current_appraisal service using a prepaid agent account and an operator's existing spending grant. Price: $0.03 per purchase, drawn from the prepaid balance; the same fresh appraisal is $5 by card. Not this rail when a person will pay at a checkout page: use buy_appraisal (human card, orderId + orderToken). Not this rail when your operator enrolled a card for unattended charging instead of funding a balance: use buy_appraisal_agent_card ($5, operationId). Connect with Authorization: Bearer ad_agent_<token>; never put credentials in arguments. Supply an explicit operationId, grantId, domain and maxSpendUsd. The original purchase route enforces authentication, expiry, domain/product permissions, balance, grant limits and the shared engine budget. One purchase invocation per MCP request; retain the receipt. Pending or uncertain delivery requires a retry with the SAME identifier and original arguments; read the receipt any time with appraisal_purchase_status. This tool cannot fund the account, create grants or raise a limit. Configuration does not guarantee live readiness; the route's response is authoritative.","inputSchema":{"type":"object","properties":{"operationId":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,128}$","description":"Caller-chosen purchase identifier. Persist it before calling and reuse it with the original arguments after a lost reply; never generate a new identifier for a retry."},"grantId":{"type":"string","format":"uuid","description":"An existing operator-issued grant identifier."},"domain":{"type":"string","description":"The domain to appraise."},"maxSpendUsd":{"type":"number","minimum":0,"description":"Explicit maximum USD-equivalent service-credit spend for this operation; no inferred or automatically increased ceiling."}},"required":["operationId","grantId","domain","maxSpendUsd"],"additionalProperties":false}},{"name":"appraisal_purchase_status","title":"Status of a prepaid balance appraisal purchase","description":"RAIL: PREPAID BALANCE. Receipt reader for purchase_appraisal only, keyed by operationId on the same authenticated agent connection. Read the original purchase-1 receipt. This does not start or resume delivery and cannot create a purchase. A pending receipt gives retryAfterSeconds; after that delay, recover with purchase_appraisal using the SAME operationId and original arguments. A refunded receipt means service credits returned to the account. Not for the other rails: a human-card checkout order is read with appraisal_order_status (orderId + orderToken); an enrolled-card charge is read with appraisal_card_order_status (operationId).","inputSchema":{"type":"object","properties":{"operationId":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,128}$","description":"Caller-chosen purchase identifier. Persist it before calling and reuse it with the original arguments after a lost reply; never generate a new identifier for a retry."}},"required":["operationId"],"additionalProperties":false}},{"name":"purchase_portfolio_appraisals","title":"Buy appraisals for a portfolio: prepaid balance ($0.03/name)","description":"RAIL: PREPAID BALANCE. Buy the existing current_appraisal service for up to 10 domains in ONE call, using a prepaid agent account and an operator's existing spending grant: $0.03 per name drawn from the prepaid balance, so one call charges at most $0.30. This is purchase_appraisal fanned out, not a new ledger: name i is an ordinary purchase-1 purchase under the derived operationId <operationId>:<i>, enforced by the original route (authentication, expiry, domain/product permissions, balance, grant limits, shared engine budget), and a name the engine cannot deliver is refunded to the account exactly as a single purchase is. Connect with Authorization: Bearer ad_agent_<token>; never put credentials in arguments. Supply an explicit operationId (at most 126 characters), grantId, domains (1 to 10 distinct names) and maxSpendUsd, the TOTAL ceiling for the call, which must cover $0.03 per name. Names run sequentially; a per-name refusal is recorded and the rest still run, while an uncertain outcome stops the call with the remaining names not_attempted. Retrying with the SAME operationId and the original arguments returns the stored per-name receipts and never charges a name twice; read them any time with portfolio_purchase_status. One purchase invocation per MCP request, and this tool counts as that invocation. This tool cannot fund the account, create grants or raise a limit. Not this rail when a person will pay at a checkout page, or when the operator enrolled a card instead of funding a balance: those rails stay single-name (buy_appraisal, buy_appraisal_agent_card). Configuration does not guarantee live readiness; the route's response is authoritative.","inputSchema":{"type":"object","properties":{"operationId":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,128}$","description":"Caller-chosen identifier for the whole portfolio purchase. Persist it before calling and reuse it with the original arguments after a lost reply; per-name purchases are derived from it, so never generate a new identifier for a retry.","maxLength":126},"grantId":{"type":"string","format":"uuid","description":"An existing operator-issued grant identifier."},"domains":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":10,"description":"The domains to appraise, 1 to 10 distinct names. Order matters: keep it identical on any retry, because per-name operationIds are positional."},"maxSpendUsd":{"type":"number","minimum":0,"description":"Explicit maximum TOTAL USD-equivalent service-credit spend for this whole call; must cover $0.03 per name ($0.30 for 10 names). No inferred or automatically increased ceiling."}},"required":["operationId","grantId","domains","maxSpendUsd"],"additionalProperties":false}},{"name":"portfolio_purchase_status","title":"Status of a prepaid portfolio appraisal purchase","description":"RAIL: PREPAID BALANCE. Receipt reader for purchase_portfolio_appraisals only, keyed by the portfolio operationId plus the original domains list on the same authenticated agent connection: per-name operationIds are derived positionally (<operationId>:<i>), so the same domains in the same order are required to read the same receipts. Reads the original purchase-1 receipts; it does not start or resume delivery and cannot create a purchase. A pending name gives retryAfterSeconds in its receipt; after that delay, recover with purchase_portfolio_appraisals using the SAME operationId and original arguments. A refunded name means service credits returned to the account for that name. Not for the other rails or for a single purchase_appraisal, which is read with appraisal_purchase_status (operationId alone).","inputSchema":{"type":"object","properties":{"operationId":{"type":"string","pattern":"^[A-Za-z0-9._:-]{8,128}$","description":"Caller-chosen purchase identifier. Persist it before calling and reuse it with the original arguments after a lost reply; never generate a new identifier for a retry.","maxLength":126},"domains":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":10,"description":"The original domains list from purchase_portfolio_appraisals, in the original order."}},"required":["operationId","domains"],"additionalProperties":false}},{"name":"buy_appraisal_agent_card","title":"Buy an appraisal: enrolled agent card ($5)","description":"RAIL: AGENT CARD. Buy a fresh appraisal of one domain, computed on this server, for $5, charged unattended to a card your operator enrolled once for you (card-agent-1). No person is present at purchase time and no payment page opens: the charge runs against the enrolled card, inside the grant and the consent caps your operator set. Requires your agent token on this MCP connection, plus grantId and cardRef from your operator. Pass a stable operationId of your own: repeating this call with the same operationId and the same request returns the stored charge and never charges twice; the same operationId with a different request is refused operation_id_conflict. Returns the appraisal in the same call when the engine delivers at once; otherwise poll appraisal_card_order_status with the same operationId. A charge the engine cannot deliver is refunded automatically and in full. Not this rail when a person will pay at a checkout page: buy_appraisal is the human card rail (same $5, orderId + orderToken). Not this rail when your operator funded a prepaid balance instead of enrolling a card: purchase_appraisal draws $0.03 from that balance.","inputSchema":{"type":"object","properties":{"domain":{"type":"string","description":"The domain to appraise, e.g. brightcargo.com."},"grantId":{"type":"string","description":"The purchase grant id your operator issued you."},"cardRef":{"type":"string","description":"The enrolled card handle (acr_...) from enrollment."},"operationId":{"type":"string","description":"Your idempotency key for this purchase, 8 to 128 characters. Reuse it verbatim on any retry."},"maxSpendUsd":{"type":"number","description":"Your hard ceiling for this charge. Defaults to the price, $5."}},"required":["domain","grantId","cardRef","operationId"]}},{"name":"appraisal_card_order_status","title":"Status of an enrolled agent card appraisal charge","description":"RAIL: AGENT CARD. Status and collection for buy_appraisal_agent_card charges only, keyed by the operationId you paid under. Read one card-agent-1 charge and collect the appraisal when it is ready. Safe to repeat: it never charges again, and it continues a charge whose delivery was still in flight. Not for the other rails: a human-card checkout order is read with appraisal_order_status (orderId + orderToken); a prepaid-balance purchase is read with appraisal_purchase_status (operationId).","inputSchema":{"type":"object","properties":{"operationId":{"type":"string","description":"The operationId used for buy_appraisal_agent_card."}},"required":["operationId"]}}],"resources":[{"uri":"audit://reference/agent-guide","name":"agent-guide","description":"One page for an agent: which tool answers which question, what is free, the refusal shape, how to get an API key, and example calls."},{"uri":"audit-domains://methodology","name":"methodology","description":"The valuation method in brief: eight scored factors, comparable recorded sales, deterministic output with a published interval."},{"uri":"audit-domains://accuracy","name":"accuracy","description":"How the method's error is measured and published, and what an agent should and should not claim about a returned figure."},{"uri":"audit-domains://api-boundary","name":"api-boundary","description":"What this free MCP endpoint serves, its published limits, and where programmatic or bulk volume belongs."},{"uri":"ui://audit-domains/appraisal-card-v2.html","name":"appraisal_card","description":"The in-chat card for appraise_domain results: fair value, published low/high range, tier and model score, with a link to the full report."},{"uri":"ui://audit-domains/registration-card-v1.html","name":"registration_card","description":"The in-chat card for registration results: each name with a written Available, Taken or Unknown state, dates where known, and a link to its report."},{"uri":"audit-domains://market/manifest","name":"market-manifest","description":"Terms, endpoints and flows of the verified-listing market."},{"uri":"audit-domains://market/openapi","name":"market-openapi","description":"OpenAPI 3.1 for the market's HTTP API."},{"uri":"audit-domains://market/brief","name":"market-brief","description":"The market in plain text."}],"resourceTemplates":[{"uriTemplate":"audit-domains://market/listing/{domain}","name":"market-listing","title":"A listing's live quote","description":"The live price and terms for one listed domain.","mimeType":"application/json"},{"uriTemplate":"audit-domains://market/search/{query}","name":"market-search","title":"Listings containing a keyword","description":"Listings whose name contains the keyword, newest first.","mimeType":"application/json"}],"prompts":[{"name":"value_domain_end_to_end","description":"Value one domain: the appraisal with its interval, the recorded sales behind it, whether it is for sale and at what terms, in four tool calls, reported with citations."},{"name":"appraise-domain","description":"Appraise one domain with the appraise_domain tool and summarise the result with its published interval and citation."},{"name":"compare-domains","description":"Rank several candidate names with the compare_domains tool and say which orderings the method can and cannot separate."},{"name":"shortlist-names","description":"From a naming brief, propose up to 16 candidate domains and give the user a link that runs them as a bracket in their own browser, instead of appraising every candidate on this server."},{"name":"name-my-project","description":"From a short brief, find domain names that look unregistered, check the favourite across suffixes, appraise at most three, and cite."},{"name":"price-a-listing","description":"Appraise a domain the user owns with appraise_domain and lay out the published interval and comparable sales as the evidence for choosing an asking price."},{"name":"check-asking-price","description":"Appraise a domain with appraise_domain and say whether a quoted asking price sits below, inside or above the published interval."},{"name":"buy-a-domain","description":"Find listed domains that fit a brief and take the purchase as far as an agent honestly can."},{"name":"sell-a-domain","description":"Walk an owner through listing one domain and setting its terms."},{"name":"park-a-portfolio","description":"Put a for-sale page on every unused domain in a portfolio."}],"limits":{"maxDomainsPerCompare":10,"maxCallsPerBatch":8,"maxEntriesPerBatch":64,"maxMarketReadsPerBatch":8,"maxBodyBytes":262144,"maxAppraisalsPerRequest":10,"maxFundedPurchasesPerRequest":1,"maxPortfolioDomainsPerPurchase":10,"maxSalesSearchResults":5,"rateLimit":{"policy":"12;w=24","burst":12,"refillPerSecond":0.5,"note":"Per IP. Every reply carries RateLimit-Policy; a 429 carries Retry-After in seconds."},"lookups":{"maxNamesPerCall":25,"perRequest":60,"burst":120,"refillPerSecond":2,"perRequestWithKey":240,"refillPerSecondWithKey":8,"note":"Per IP. Every lookup answer carries budget {lane, used, limit, remaining}; past it, the unchecked names are in pending and limit.retry is the call to send after limit.retryAfterSeconds."},"note":"Per-IP rate limited, one token per engine run. An engine run (a name not answered from the cache or the published catalog) needs an API key sent as Authorization: Bearer ad_live_... and spends one API credit; without one, the answer is the catalog figure or a report link that runs the engine in the browser. Cached repeats and sales searches are free of the appraisal budget. One interactive question at a time. search_recorded_sales serves ROWS from a fixed free public sample of the verified corpus, so repeated or filtered queries of THAT tool cannot accumulate past it; its match counts and aggregates describe the full corpus only above a minimum cohort size, and aggregates are rounded to two significant figures. The bound is per-tool, not server-wide: find_comparable_sales and the comparables inside appraise_domain and compare_domains return real corpus rows selected by similarity to a caller-supplied name, with each recorded price shown as a 1-2-5 range rather than the figure, and a name's own recorded sale is never used or listed. Row-level SEARCH across the full corpus is part of the paid Sales Research workspace."},"install":{"claudeCode":"claude mcp add --transport http audit-domains 'https://audit.domains/mcp'","clientConfig":{"mcpServers":{"audit-domains":{"type":"http","url":"https://audit.domains/mcp"}}},"targets":[{"id":"claude","client":"Claude (web, desktop, mobile)","kind":"steps","steps":["Customize > Connectors > + Add > Add custom connector","Name: audit.domains. URL: https://audit.domains/mcp","Authentication: No sign in, then Add","In a chat: + > Connectors > turn on audit.domains"],"note":"Client plan eligibility and no-sign-in support depend on Claude; verify in the current client."},{"id":"chatgpt","client":"ChatGPT","kind":"steps","steps":["Settings > Apps (or Connectors) > Advanced settings > turn on Developer mode","Create app. Name: audit.domains. URL: https://audit.domains/mcp","Authentication: No authentication, then Create","In a chat: turn on audit.domains from the + menu"],"note":"On ChatGPT plans that include developer mode."},{"id":"cursor","client":"Cursor","kind":"link","href":"https://cursor.com/install-mcp?name=audit-domains&config=eyJ1cmwiOiJodHRwczovL2F1ZGl0LmRvbWFpbnMvbWNwIn0%3D"},{"id":"vscode","client":"VS Code","kind":"link","href":"https://vscode.dev/redirect?url=vscode:mcp/install%3F%7B%22name%22%3A%22audit-domains%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Faudit.domains%2Fmcp%22%7D"},{"id":"vscode-insiders","client":"VS Code Insiders","kind":"link","href":"https://insiders.vscode.dev/redirect?url=vscode-insiders:mcp/install%3F%7B%22name%22%3A%22audit-domains%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Faudit.domains%2Fmcp%22%7D"},{"id":"lm-studio","client":"LM Studio","kind":"link","href":"lmstudio://add_mcp?name=audit-domains&config=eyJ1cmwiOiJodHRwczovL2F1ZGl0LmRvbWFpbnMvbWNwIn0%3D"},{"id":"claude-code","client":"Claude Code","kind":"command","command":"claude mcp add --transport http audit-domains 'https://audit.domains/mcp'"},{"id":"gemini-cli","client":"Gemini CLI","kind":"command","command":"gemini mcp add --transport http audit-domains 'https://audit.domains/mcp'"},{"id":"codex-cli","client":"Codex CLI","kind":"command","command":"codex mcp add audit-domains --url 'https://audit.domains/mcp'"}]},"documentation":"https://audit.domains/developers"}