Update MXroute extension - show domain verification key in "add domain" + catchall ux improvements (#25179)

* [MXroute] verification key in add domain + catchall ux

* Update CHANGELOG.md

---------

Co-authored-by: raycastbot <bot@raycast.com>

Author: xmok

extensions/mxroute/CHANGELOG.md

@@ -1,5 +1,10 @@
 # MXroute Changelog
 
+## [Domain Verification Key in Add + Catch All UX] - 2026-02-05
+
+- _Domain Verification Key_ is shown in "Add New Domain"
+- Improve the "Advanced" view to include descriptions of _CatchAll Type_
+
 ## [Add Email Account from EmptyView + Access DNS Info] - 2026-01-26
 
 - Add "Add New Email Account" `Action` to `EmptyView`

extensions/mxroute/package-lock.json

@@ -138,7 +138,7 @@
     }
   ],
   "dependencies": {
-    "@raycast/api": "^1.104.3",
+    "@raycast/api": "^1.104.4",
     "@raycast/utils": "^2.2.2"
   },
   "devDependencies": {

extensions/mxroute/package.json

@@ -41,6 +41,12 @@ export default function Advanced({ selectedDomainName }: { selectedDomainName: s
     },
   });
 
+  const TYPE_DESCRIPTIONS: Record<CatchAllType, string> = {
+    fail: "Emails to non-existent addresses are bounced back to the sender with an error message.",
+    blackhole: "Emails to non-existent addresses are silently deleted. The sender receives no notification.",
+    address: "All emails to non-existent addresses are forwarded to a specific email address.",
+  };
+
   return !catchAll ? (
     <Detail isLoading={isLoading} markdown="Fetching Catch All Settings" />
   ) : (
@@ -53,7 +59,10 @@ export default function Advanced({ selectedDomainName }: { selectedDomainName: s
       }
     >
       <Form.Description text={selectedDomainName} />
-      <Form.Description title="Description" text={catchAll.description} />
+      <Form.Description
+        title="Description"
+        text="Configure what happens when email is sent to non-existent addresses."
+      />
       <Form.Separator />
       <Form.Dropdown
         title="Catch-All Email"
@@ -65,13 +74,9 @@ export default function Advanced({ selectedDomainName }: { selectedDomainName: s
         <Form.Dropdown.Item title="Forward to Address" value={CatchAllType.Forward} />
       </Form.Dropdown>
       {values.type === CatchAllType.Forward && (
-        <Form.TextField
-          title="Forward to Address"
-          placeholder="catchall@example.com"
-          info="All emails to non-existent addresses are forwarded to a specific email address."
-          {...itemProps.address}
-        />
+        <Form.TextField title="Forward to Address" placeholder="catchall@example.com" {...itemProps.address} />
       )}
+      <Form.Description text={TYPE_DESCRIPTIONS[values.type as CatchAllType]} />
     </Form>
   );
 }

extensions/mxroute/src/advanced.tsx

@@ -11,12 +11,13 @@ import {
   Toast,
   useNavigation,
 } from "@raycast/api";
-import { FormValidation, getFavicon, useCachedPromise, useForm } from "@raycast/utils";
+import { FormValidation, getFavicon, useCachedPromise, useCachedState, useForm, usePromise } from "@raycast/utils";
 import { mxroute } from "./mxroute";
 import EmailAccounts from "./email-accounts";
 import EmailForwarders from "./email-forwarders";
 import Advanced from "./advanced";
 import DNSInfo from "./dns-info";
+import { DomainVerificationKey } from "./types";
 
 export default function ManageDomains() {
   const {
@@ -78,6 +79,11 @@ export default function ManageDomains() {
 
 function AddDomain({ firstDomainName }: { firstDomainName: string }) {
   const { pop, push } = useNavigation();
+  const [data, setData] = useCachedState<DomainVerificationKey>("domain-verification-key");
+  const { isLoading } = usePromise(mxroute.getDomainVerificationKey, [], {
+    onData: setData,
+    execute: !data,
+  });
   const { handleSubmit, itemProps } = useForm<{ domain: string }>({
     async onSubmit(values) {
       const { domain } = values;
@@ -111,9 +117,24 @@ function AddDomain({ firstDomainName }: { firstDomainName: string }) {
   });
   return (
     <Form
+      isLoading={isLoading}
       actions={
         <ActionPanel>
           <Action.SubmitForm icon={Icon.Plus} title="Add Domain" onSubmit={handleSubmit} />
+          {data && (
+            <ActionPanel.Section>
+              <Action.CopyToClipboard
+                title="Copy Name to Clipboard"
+                content={data.record.name}
+                shortcut={Keyboard.Shortcut.Common.CopyName}
+              />
+              <Action.CopyToClipboard
+                title="Copy Value to Clipboard"
+                content={data.record.value}
+                shortcut={Keyboard.Shortcut.Common.Copy}
+              />
+            </ActionPanel.Section>
+          )}
         </ActionPanel>
       }
     >
@@ -123,6 +144,15 @@ function AddDomain({ firstDomainName }: { firstDomainName: string }) {
         info="Enter the domain without www (e.g., example.com)"
         {...itemProps.domain}
       />
+      <Form.Separator />
+      {data && (
+        <>
+          <Form.Description text={data.description} />
+          <Form.Description title="Type" text={data.record.type} />
+          <Form.Description title="Name" text={data.record.name} />
+          <Form.Description title="Value" text={data.record.value} />
+        </>
+      )}
     </Form>
   );
 }

extensions/mxroute/src/manage-domains.tsx

@@ -9,6 +9,7 @@ import {
   EmailForwarder,
   CreateEmailForwarderRequest,
   CatchAll,
+  DomainVerificationKey,
 } from "./types";
 
 const { api_key, server, username } = getPreferenceValues<Preferences>();
@@ -25,12 +26,13 @@ const makeRequest = async <T>(endpoint: string, options?: RequestInit) => {
     body: options?.body,
   });
   if (response.headers.get("Content-Length") === "0") return undefined as T;
-  const result = (await response.json()) as SuccessResponse<string[]> | ErrorResponse;
+  const result = (await response.json()) as SuccessResponse<unknown> | ErrorResponse;
   if (!result.success) throw new Error(result.error.message);
   return result.data as T;
 };
 
 export const mxroute = {
+  getDomainVerificationKey: () => makeRequest<DomainVerificationKey>("verification-key"),
   domains: {
     create: (domain: string) => makeRequest("domains", { method: "POST", body: JSON.stringify({ domain }) }),
     get: (domain: string) => makeRequest<Domain>(`domains/${domain}`),

extensions/mxroute/src/mxroute.ts

@@ -1,3 +1,13 @@
+export type DomainVerificationKey = {
+  key: string;
+  record: {
+    type: "TXT";
+    name: string;
+    value: "domain-verified";
+  };
+  description: string;
+};
+
 export enum CatchAllType {
   Reject = "fail",
   DiscardSilently = "blackhole",