Skip to main content
Glama
Sign In

Proof Holdings

by holdings.proof
OverviewDiscussionsAdmin

start_domain_email_verification

Start domain verification via corporate email. Sends a verification code to a standard admin email address at the domain.

ACCESS: needs a Proof account. Authenticate this client (Claude Code: /mcp → Authenticate), or sign in with start_login — a session opens this tool — then call this tool again.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "id": "<id>"
    },
    "name": "start_domain_email_verification"
  }
}

Input Schema

NameRequiredDescriptionDefault
idYesDomain ID
email_prefixNoEmail prefix to send verification to (default: admin)

Output Schema

NameRequiredDescriptionDefault
dataYesDomain record
messageYes
email_sent_toNoSent when a code was sent; absent when the domain was already verified.
expires_in_minutesNoSent with `email_sent_to`.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": {},
+  "description": "A verification code emailed to an address on the domain",
+  "properties": {
+    "data": {
+      "additionalProperties": {},
+      "description": "Domain record",
+      "properties": {
+        "actual_dns_host": {
+          "type": "string"
+        },
+        "actual_dns_host_name": {
+          "type": "string"
+        },
+        "check_count": {
+          "maximum": 9007199254740991,
+          "minimum": -9007199254740991,
+          "type": "integer"
+        },
+        "created_at": {
+          "type": "string"
+        },
+        "detected_provider": {
+          "type": "string"
+        },
+        "dns_mismatch_warning": {
+          "type": "string"
+        },
+        "dns_records": {
+          "items": {
+            "additionalProperties": {},
+            "properties": {
+              "name": {
+                "type": "string"
+              },
+              "priority": {
+                "maximum": 9007199254740991,
+                "minimum": -9007199254740991,
+                "type": "integer"
+              },
+              "purpose": {
+                "type": "string"
+              },
+              "type": {
+                "type": "string"
+              },
+              "value": {
+                "type": "string"
+              },
+              "verified": {
+                "type": "boolean"
+              },
+              "verified_at": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "name",
+              "value",
+              "purpose",
+              "verified"
+            ],
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "domain": {
+          "type": "string"
+        },
+        "email_sending_enabled": {
+          "type": "boolean"
+        },
+        "email_verification": {
+          "additionalProperties": {},
+          "properties": {
+            "attempts": {
+              "maximum": 9007199254740991,
+              "minimum": -9007199254740991,
+              "type": "integer"
+            },
+            "email_address": {
+              "type": "string"
+            },
+            "email_prefix": {
+              "type": "string"
+            },
+            "expires_at": {
+              "type": "string"
+            },
+            "last_sent_at": {
+              "type": "string"
+            },
+            "verified_at": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "email_prefix",
+            "email_address",
+            "expires_at",
+            "attempts"
+          ],
+          "type": "object"
+        },
+        "error_message": {
+          "type": "string"
+        },
+        "for_email_sending": {
+          "type": "boolean"
+        },
+        "for_verification": {
+          "type": "boolean"
+        },
+        "from_email": {
+          "type": "string"
+        },
+        "godaddy_connected": {
+          "type": "boolean"
+        },
+        "has_dns_mismatch": {
+          "type": "boolean"
+        },
+        "has_provider_credentials": {
+          "type": "boolean"
+        },
+        "http_file_content": {
+          "type": "string"
+        },
+        "http_file_path": {
+          "type": "string"
+        },
+        "id": {
+          "type": "string"
+        },
+        "last_checked_at": {
+          "type": "string"
+        },
+        "oauth_connected": {
+          "type": "boolean"
+        },
+        "oauth_url": {
+          "type": "string"
+        },
+        "profile_id": {
+          "type": "string"
+        },
+        "proof_expires_at": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "proof_id": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "proof_revoked_reason": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "proof_status": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "provider": {
+          "type": "string"
+        },
+        "provider_credential_name": {
+          "type": "string"
+        },
+        "provider_name": {
+          "type": "string"
+        },
+        "resend": {
+          "additionalProperties": {},
+          "properties": {
+            "dkim_records": {
+              "items": {
+                "additionalProperties": {},
+                "properties": {
+                  "name": {
+                    "type": "string"
+                  },
+                  "priority": {
+                    "maximum": 9007199254740991,
+                    "minimum": -9007199254740991,
+                    "type": "integer"
+                  },
+                  "purpose": {
+                    "type": "string"
+                  },
+                  "type": {
+                    "type": "string"
+                  },
+                  "value": {
+                    "type": "string"
+                  },
+                  "verified": {
+                    "type": "boolean"
+                  },
+                  "verified_at": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "type",
+                  "name",
+                  "value",
+                  "purpose",
+                  "verified"
+                ],
+                "type": "object"
+              },
+              "type": "array"
+            },
+            "domain_id": {
+              "type": "string"
+            },
+            "last_checked_at": {
+              "type": "string"
+            },
+            "registered_at": {
+              "type": "string"
+            },
+            "status": {
+              "type": "string"
+            },
+            "verified_at": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "status",
+            "dkim_records"
+          ],
+          "type": "object"
+        },
+        "status": {
+          "type": "string"
+        },
+        "supports_api_key": {
+          "type": "boolean"
+        },
+        "supports_api_token": {
+          "type": "boolean"
+        },
+        "supports_auto_dns": {
+          "type": "boolean"
+        },
+        "txt_record_name": {
+          "type": "string"
+        },
+        "txt_record_value": {
+          "type": "string"
+        },
+        "updated_at": {
+          "type": "string"
+        },
+        "verification_method": {
+          "type": "string"
+        },
+        "verification_subtype": {
+          "type": "string"
+        },
+        "verified_at": {
+          "type": "string"
+        },
+        "verified_providers": {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        }
+      },
+      "required": [
+        "id",
+        "domain",
+        "status",
+        "detected_provider",
+        "provider_name",
+        "supports_auto_dns",
+        "verification_method",
+        "for_email_sending",
+        "for_verification",
+        "dns_records",
+        "has_dns_mismatch",
+        "txt_record_name",
+        "txt_record_value",
+        "http_file_path",
+        "http_file_content",
+        "oauth_connected",
+        "godaddy_connected",
+        "supports_api_token",
+        "supports_api_key",
+        "verified_providers",
+        "check_count",
+        "created_at",
+        "updated_at"
+      ],
+      "type": "object"
+    },
+    "email_sent_to": {
+      "description": "Sent when a code was sent; absent when the domain was already verified.",
+      "type": "string"
+    },
+    "expires_in_minutes": {
+      "description": "Sent with `email_sent_to`.",
+      "maximum": 9007199254740991,
+      "minimum": -9007199254740991,
+      "type": "integer"
+    },
+    "message": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "data",
+    "message"
+  ],
+  "type": "object"
+}
  2. Changed1 schema field changed
    • removedInput schema / additionalProperties
      Removed value: -false
  3. First observed

TDQS

A3.7/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations only declare readOnlyHint=false / destructiveHint=false; the description adds the genuinely useful behavioral facts: an outbound email with a code is sent to a fixed set of admin addresses, and the call requires an authenticated Proof session. It stops short of saying whether this invalidates a prior pending code or whether the send can be rate-limited/resent (resend_domain_email exists).

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with the action and its effect in two sentences, then a clearly separated ACCESS block. Slightly verbose in the auth parenthetical, but every sentence carries information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so return values need not be explained, and the auth prerequisite is spelled out. The main gap is the lack of connection to the follow-up step (confirm_domain_email_code / check_domain_email_status) in a tool family this crowded.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% and the enum for email_prefix is fully documented, so the schema carries the parameter burden. The description only loosely echoes it ('standard admin email address') without adding format, default, or failure behavior — baseline 3.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

Names a specific verb+resource ('Start domain verification') and adds the channel ('via corporate email') plus the concrete effect (sends a verification code to a standard admin address). This distinguishes it in spirit from start_domain_verification / start_user_domain_verification, though it never names those siblings explicitly.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives a real prerequisite (needs a Proof account; authenticate via /mcp or start_login, then retry), which is actionable context. But it offers no when-to-use-vs-alternative guidance against the many sibling verification starters (setup_domain_email, start_domain_verification, check_domain_email_status) or the obvious next step (confirm_domain_email_code).

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Proof Holdings toolsInspect
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources