{ "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json", "name": "domains.audit/appraisal", "version": "1.7.0", "title": "audit.domains - Domain Valuation", "description": "Deterministic domain name valuation: fair-value interval, scored factors, real comparable sales.", "serverInfo": { "name": "audit-domains", "version": "1.7.0" }, "endpoint": "https://audit.domains/mcp", "transport": "streamable-http", "protocolVersion": "2025-06-18", "capabilities": { "tools": {}, "resources": {}, "prompts": {} }, "authentication": { "required": false, "note": "Published reads and certificate verification are anonymous. Fresh keyed engine runs require an authorized ad_live_ bearer. inspect_agent_grants, purchase_appraisal and appraisal_purchase_status require an expiring ad_agent_ bearer; purchases also require an existing scoped operator grant and explicit spend ceiling. Card checkout/status use the returned order credentials. Live /mcp and tools/list describe the configured subset." }, "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" ] }, "annotations": { "title": "Appraise a domain name", "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "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" ] }, "annotations": { "title": "Compare and rank domain names", "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "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" ] }, "annotations": { "title": "Run a domain-name bracket", "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "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" ] }, "annotations": { "title": "Find comparable recorded sales", "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "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." } } }, "annotations": { "title": "Search recorded domain sales", "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "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/?p=. 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" ] } ] }, "annotations": { "title": "Verify an audit.domains certificate", "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": true } }, { "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" ] } ] }, "annotations": { "title": "Check whether domain names are registered", "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": true } }, { "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" ] }, "annotations": { "title": "Inspect a domain before buying it", "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": true } }, { "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" ] }, "annotations": { "title": "Suggest domain names that look available", "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": true } }, { "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" ] }, "annotations": { "title": "List a domain portfolio by expiry date", "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": true } }, { "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": {} }, "annotations": { "title": "List every service and its price", "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "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." } } }, "annotations": { "title": "Search domains for sale", "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": true } }, { "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." } } }, "annotations": { "title": "Ask the market in plain English", "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": true } }, { "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." } } }, "annotations": { "title": "Quote a domain purchase", "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": true } }, { "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." } } }, "annotations": { "title": "Check an order", "readOnlyHint": false, "destructiveHint": false, "idempotentHint": true, "openWorldHint": true } }, { "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." } } }, "annotations": { "title": "Act on an order", "readOnlyHint": false, "destructiveHint": true, "idempotentHint": false, "openWorldHint": true } }, { "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." } } }, "annotations": { "title": "Read a seller listing", "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": true } }, { "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." } } }, "annotations": { "title": "Set listing terms", "readOnlyHint": false, "destructiveHint": false, "idempotentHint": true, "openWorldHint": true } }, { "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)." } } }, "annotations": { "title": "Prepare a bulk listing", "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": true } }, { "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" } } }, "annotations": { "title": "Read a parked for-sale page", "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": true } }, { "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." } } }, "annotations": { "title": "Is this name for sale? (RFC 10023)", "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": true } }, { "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." } } }, "annotations": { "title": "Build a portfolio landing page", "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": false } }, { "name": "buy_appraisal", "title": "Buy a server appraisal by card", "description": "Buy a fresh appraisal of one domain, computed on this server, for $5 by card. Use it when appraise_domain answered notAppraised and the user wants the figure returned to you rather than opened in their browser. This is the price for a person paying by card; an agent account an operator has funded pays the lower stored-appraisal price instead (https://audit.domains/machine-account). 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. Keep orderToken: it is shown once and is the only proof of purchase. A paid order that cannot be delivered is refunded in full.", "inputSchema": { "type": "object", "properties": { "domain": { "type": "string", "description": "The domain to appraise, e.g. brightcargo.com." } }, "required": [ "domain" ] }, "annotations": { "title": "Buy a server appraisal by card", "readOnlyHint": false, "destructiveHint": false, "idempotentHint": false, "openWorldHint": true } }, { "name": "appraisal_order_status", "title": "Collect a paid appraisal", "description": "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.", "inputSchema": { "type": "object", "properties": { "orderId": { "type": "string", "description": "orderId from buy_appraisal." }, "orderToken": { "type": "string", "description": "orderToken from buy_appraisal." } }, "required": [ "orderId", "orderToken" ] }, "annotations": { "title": "Collect a paid appraisal", "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": true } }, { "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_; 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 }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "title": "Inspect your existing agent spending grants" } }, { "name": "purchase_appraisal", "title": "Purchase an appraisal within a funded grant", "description": "Buy the existing current_appraisal service using a prepaid account and an operator's existing spending grant. Connect with Authorization: Bearer ad_agent_; 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. 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 }, "annotations": { "readOnlyHint": false, "destructiveHint": true, "idempotentHint": true, "openWorldHint": true, "title": "Purchase an appraisal within a funded grant" } }, { "name": "appraisal_purchase_status", "title": "Read a funded appraisal purchase receipt", "description": "Read the original purchase-1 receipt using the same authenticated agent connection and operationId. 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.", "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 }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "title": "Read a funded appraisal purchase receipt" } } ], "websiteUrl": "https://audit.domains", "icons": [ { "src": "https://audit.domains/icon-192.png", "sizes": [ "192x192" ], "mimeType": "image/png" }, { "src": "https://audit.domains/icon-512.png", "sizes": [ "512x512" ], "mimeType": "image/png" } ], "remotes": [ { "type": "streamable-http", "url": "https://audit.domains/mcp", "protocolVersions": [ "2025-06-18" ] } ], "_meta": { "domains.audit/documentation": "https://audit.domains/developers/", "domains.audit/methodology": "https://audit.domains/factors/", "domains.audit/accuracy": "https://audit.domains/accuracy/", "domains.audit/summary": "Deterministic domain name valuation with a published low/high interval, scored factors, and the closest real recorded comparable sales. The same name always returns the same figure.", "domains.audit/api-catalog": "https://audit.domains/.well-known/api-catalog", "domains.audit/agent-card": "https://audit.domains/.well-known/agent-card.json", "domains.audit/agent-skills": "https://audit.domains/.well-known/agent-skills/index.json", "domains.audit/llms-txt": "https://audit.domains/llms.txt", "domains.audit/sitemap": "https://audit.domains/sitemap.xml", "domains.audit/agent-status": { "profiles": { "default": { "url": "https://audit.domains/mcp", "toolCount": 27, "note": "This static card lists potential capabilities. GET /mcp and tools/list return the live configured subset; funded purchase tools require the account lane, and card/market tools require their own lanes. ?profile=full and ?profile=core use the same configuration gates." }, "directory": { "url": "https://audit.domains/mcp?profile=directory", "note": "Keyless and read-only; never runs the engine." } }, "free": [ "published catalog appraisals (about 1,000 names)", "recently appraised names", "recorded-sales search", "listings and DNS for-sale reads", "static catalog shards: https://audit.domains/catalog/v1/index.json" ], "paid": { "freshAppraisal": "Authorization: Bearer ad_live_... (one API credit)", "cardLane": { "note": "No key: $5 by card per fresh appraisal. A person pays on a Square page; no account or sign-in.", "priceUsd": 5, "terms": "GET https://audit.domains/api/machine/resolve", "start": "POST https://audit.domains/api/machine/resolve {\"action\":\"card_checkout\",\"domain\":\"example.com\",\"intent\":\"appraise\",\"operationId\":\"<8-128 chars>\"}, then {\"action\":\"card_status\",\"orderId\":\"...\",\"orderToken\":\"...\"}", "openapi": "https://audit.domains/api/openapi-machine.json" }, "keys": "https://audit.domains/developers/", "x402": { "enabled": false, "note": "Not accepted today: no payment verifier is wired; a payment payload is ignored and never buys an engine run.", "transport": "x402 v2 over MCP (_meta x402/payment)", "network": "eip155:8453", "asset": "USDC", "proposedPriceAtomic": "250000" } }, "guide": "audit://reference/agent-guide" } }, "resources": [ { "uri": "audit://reference/agent-guide", "name": "agent-guide", "title": "Agent guide: which tool, what it costs, what a refusal means", "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.", "mimeType": "text/plain" }, { "uri": "audit-domains://methodology", "name": "methodology", "title": "How valuations are computed", "description": "The valuation method in brief: eight scored factors, comparable recorded sales, deterministic output with a published interval.", "mimeType": "text/plain" }, { "uri": "audit-domains://accuracy", "name": "accuracy", "title": "Measured accuracy, and how to cite it", "description": "How the method's error is measured and published, and what an agent should and should not claim about a returned figure.", "mimeType": "text/plain" }, { "uri": "audit-domains://api-boundary", "name": "api-boundary", "title": "This endpoint vs the paid API", "description": "What this free MCP endpoint serves, its published limits, and where programmatic or bulk volume belongs.", "mimeType": "text/plain" }, { "uri": "ui://audit-domains/appraisal-card-v2.html", "name": "appraisal_card", "title": "Domain 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.", "mimeType": "text/html;profile=mcp-app" }, { "uri": "ui://audit-domains/registration-card-v1.html", "name": "registration_card", "title": "Domain 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.", "mimeType": "text/html;profile=mcp-app" } ], "prompts": [ { "name": "value_domain_end_to_end", "title": "Value a 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.", "arguments": [ { "name": "domain", "description": "The domain name to value, such as example.com.", "required": true } ] }, { "name": "appraise-domain", "title": "Appraise a domain and report it honestly", "description": "Appraise one domain with the appraise_domain tool and summarise the result with its published interval and citation.", "arguments": [ { "name": "domain", "description": "The domain name to appraise.", "required": true } ] }, { "name": "compare-domains", "title": "Compare domains and report separability", "description": "Rank several candidate names with the compare_domains tool and say which orderings the method can and cannot separate.", "arguments": [ { "name": "domains", "description": "Comma-separated domain names to compare.", "required": true } ] }, { "name": "shortlist-names", "title": "Propose domain names and hand the shortlist to a bracket", "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.", "arguments": [ { "name": "brief", "description": "What is being named: the product, audience, tone, and any TLD or length preferences.", "required": true } ] }, { "name": "name-my-project", "title": "Find available domain names for a project", "description": "From a short brief, find domain names that look unregistered, check the favourite across suffixes, appraise at most three, and cite.", "arguments": [ { "name": "brief", "description": "What is being named: the product or business, audience, tone, and any keywords, TLD or length preferences.", "required": true } ] }, { "name": "price-a-listing", "title": "Set an asking price for a domain you own", "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.", "arguments": [ { "name": "domain", "description": "The domain name the user wants to list for sale.", "required": true } ] }, { "name": "check-asking-price", "title": "Compare an asking price with the appraisal", "description": "Appraise a domain with appraise_domain and say whether a quoted asking price sits below, inside or above the published interval.", "arguments": [ { "name": "domain", "description": "The domain name that is for sale.", "required": true }, { "name": "askingPrice", "description": "The asking price in US dollars, for example 25000.", "required": true } ] } ] }