tool-annotations.reference.json

{
  "_comment": "MCP ToolAnnotation reference for the Unstoppable Domains MCP server. These annotations describe each tool's behavior and are returned by the live server in its tools/list response (not in this registry manifest). readOnlyHint: tool never modifies state. destructiveHint: irreversible or high-consequence action. openWorldHint: tool affects external systems (DNS, marketplace, payments). title: human-readable name shown in client UIs.",
  "tools": [
    { "name": "ud_domains_search", "title": "Search Domain Availability", "annotations": { "readOnlyHint": true, "openWorldHint": true } },
    { "name": "ud_tld_list", "title": "List Available TLDs", "annotations": { "readOnlyHint": true } },
    { "name": "ud_expireds_list", "title": "Browse Expiring Domains", "annotations": { "readOnlyHint": true, "openWorldHint": true } },
    { "name": "ud_knowledge_base_search", "title": "Search Help Articles", "annotations": { "readOnlyHint": true } },
    { "name": "ud_portfolio_list", "title": "List Portfolio Domains", "annotations": { "readOnlyHint": true } },
    { "name": "ud_domain_get", "title": "Get Domain Details", "annotations": { "readOnlyHint": true } },
    { "name": "ud_contacts_list", "title": "List ICANN Contacts", "annotations": { "readOnlyHint": true } },
    { "name": "ud_contact_create", "title": "Create ICANN Contact", "annotations": { "openWorldHint": true } },
    { "name": "ud_cart_get", "title": "View Shopping Cart", "annotations": { "readOnlyHint": true } },
    { "name": "ud_cart_add_domain_registration", "title": "Add Domain Registration to Cart", "annotations": { "openWorldHint": true } },
    { "name": "ud_cart_add_domain_listed", "title": "Add Listed Domain to Cart", "annotations": { "openWorldHint": true } },
    { "name": "ud_cart_add_domain_afternic", "title": "Add Afternic Domain to Cart", "annotations": { "openWorldHint": true } },
    { "name": "ud_cart_add_domain_sedo", "title": "Add Sedo Domain to Cart", "annotations": { "openWorldHint": true } },
    { "name": "ud_cart_add_domain_renewal", "title": "Add Domain Renewal to Cart", "annotations": { "openWorldHint": true } },
    { "name": "ud_cart_remove", "title": "Remove Cart Item", "annotations": {} },
    { "name": "ud_cart_get_payment_methods", "title": "Get Payment Methods", "annotations": { "readOnlyHint": true } },
    { "name": "ud_cart_add_payment_method_url", "title": "Get Add Payment Method URL", "annotations": { "openWorldHint": true } },
    { "name": "ud_cart_checkout", "title": "Checkout Cart", "annotations": { "destructiveHint": true, "openWorldHint": true } },
    { "name": "ud_cart_get_url", "title": "Get Checkout URL", "annotations": { "readOnlyHint": true, "openWorldHint": true } },
    { "name": "ud_listing_create", "title": "Create Marketplace Listing", "annotations": { "openWorldHint": true } },
    { "name": "ud_listing_update", "title": "Update Marketplace Listing", "annotations": { "openWorldHint": true } },
    { "name": "ud_listing_cancel", "title": "Cancel Marketplace Listing", "annotations": { "destructiveHint": true, "openWorldHint": true } },
    { "name": "ud_offers_list", "title": "List Domain Offers", "annotations": { "readOnlyHint": true } },
    { "name": "ud_offer_respond", "title": "Respond to Offer", "annotations": { "destructiveHint": true, "openWorldHint": true } },
    { "name": "ud_leads_list", "title": "List Domain Conversations", "annotations": { "readOnlyHint": true } },
    { "name": "ud_lead_get", "title": "Get or Create Conversation", "annotations": { "openWorldHint": true } },
    { "name": "ud_lead_messages_list", "title": "List Conversation Messages", "annotations": { "readOnlyHint": true } },
    { "name": "ud_lead_message_send", "title": "Send Conversation Message", "annotations": { "openWorldHint": true } },
    { "name": "ud_dns_records_list", "title": "List DNS Records", "annotations": { "readOnlyHint": true } },
    { "name": "ud_dns_record_add", "title": "Add DNS Records", "annotations": { "openWorldHint": true } },
    { "name": "ud_dns_record_update", "title": "Update DNS Record", "annotations": { "openWorldHint": true } },
    { "name": "ud_dns_record_remove", "title": "Remove DNS Record", "annotations": { "destructiveHint": true, "openWorldHint": true } },
    { "name": "ud_dns_records_remove_all", "title": "Remove All DNS Records", "annotations": { "destructiveHint": true, "openWorldHint": true } },
    { "name": "ud_dns_nameservers_list", "title": "List Nameservers", "annotations": { "readOnlyHint": true } },
    { "name": "ud_dns_nameservers_set_custom", "title": "Set Custom Nameservers", "annotations": { "openWorldHint": true } },
    { "name": "ud_dns_nameservers_set_default", "title": "Reset to Default Nameservers", "annotations": { "destructiveHint": true, "openWorldHint": true } },
    { "name": "ud_dns_hosting_list", "title": "List Hosting Configurations", "annotations": { "readOnlyHint": true } },
    { "name": "ud_dns_hosting_add", "title": "Add Hosting Configuration", "annotations": { "openWorldHint": true } },
    { "name": "ud_dns_hosting_remove", "title": "Remove Hosting Configuration", "annotations": { "destructiveHint": true, "openWorldHint": true } },
    { "name": "ud_domain_pending_operations", "title": "Get Pending Operations", "annotations": { "readOnlyHint": true } },
    { "name": "ud_domain_auto_renewal_update", "title": "Update Auto-Renewal", "annotations": {} },
    { "name": "ud_domain_tags_add", "title": "Add Domain Tags", "annotations": {} },
    { "name": "ud_domain_tags_remove", "title": "Remove Domain Tags", "annotations": {} },
    { "name": "ud_domain_flags_update", "title": "Update Domain Flags", "annotations": { "destructiveHint": true } },
    { "name": "ud_domain_push", "title": "Push Domain to Another User", "annotations": { "destructiveHint": true, "openWorldHint": true } },
    { "name": "ud_backorder_create", "title": "Create Domain Backorder", "annotations": { "openWorldHint": true } },
    { "name": "ud_backorders_list", "title": "List Backorders", "annotations": { "readOnlyHint": true } },
    { "name": "ud_backorder_cancel", "title": "Cancel Backorder", "annotations": { "destructiveHint": true } },
    { "name": "ud_ai_credits_get", "title": "Get AI Credit Balance", "annotations": { "readOnlyHint": true } },
    { "name": "ud_cart_add_ai_credits", "title": "Add AI Credits to Cart", "annotations": { "openWorldHint": true } },
    { "name": "ud_domain_generate_lander", "title": "Generate AI Landing Page", "annotations": { "openWorldHint": true } },
    { "name": "ud_domain_lander_status", "title": "Check Lander Status", "annotations": { "readOnlyHint": true } },
    { "name": "ud_domain_download_lander", "title": "Download Landing Page", "annotations": { "readOnlyHint": true } },
    { "name": "ud_domain_upload_lander", "title": "Upload Custom Landing Page", "annotations": { "openWorldHint": true } },
    { "name": "ud_domain_remove_lander", "title": "Remove Landing Page", "annotations": { "destructiveHint": true, "openWorldHint": true } },
    { "name": "ud_presets_list", "title": "List DNS Presets", "annotations": { "readOnlyHint": true } },
    { "name": "ud_presets_save", "title": "Save DNS Preset", "annotations": {} },
    { "name": "ud_presets_delete", "title": "Delete DNS Preset", "annotations": { "destructiveHint": true } },
    { "name": "ud_presets_apply", "title": "Apply DNS Preset", "annotations": { "openWorldHint": true } },
    { "name": "ud_authenticated_url_get", "title": "Get Authenticated URL", "annotations": { "readOnlyHint": true, "openWorldHint": true } }
  ]
}