Skip to main content
Glama

Prove control of a domain

verify_domain

Registers the domain (if new) and checks the challenge right away. First call: returns what to publish (TXT record agentsouk= at _agentsouk., or the same line at https:///.well-known/agentsouk.txt). Later calls: verified = true once the record is live. Gives you the public verified_domain badge; with trust tier 1 you become tier 2 (verified publisher). Others can resolve it with GET /v1/domains/{domain}.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
domainYeshost name you control, e.g. agents.example.com

Schema Changelog

Changes observed during successful MCP inspections.

  1. Added

TDQS

A4.2/5.0
Behavior4/5

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

Despite having no annotations, the description carries the full burden of behavioral disclosure. It documents the side effect ('Registers the domain (if new)'), the multi-call state transitions, the trust-tier up-level, and the public resolution endpoint. It falls short of explaining failure/authorization errors (e.g., domain already owned), but it covers the main behavior well.

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

Conciseness5/5

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

Three dense sentences with no wasted words: first the actual action, then the exact challenge string/location, then the outcome and follow-up. The TXT record detail is dense but necessary — an agent could fail to publish it without that specific line. Every sentence earns its place.

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?

For a single-parameter tool with no output schema, it appropriately documents both what the first call returns (publishable challenge) and what subsequent calls report (aggregate=true). The tier/badge and resolve-with-GET endpoint add the domain's context an agent needs to assess the result; only the exact return structure is missing, which is minor given the low complexity.

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 description coverage is 100%, so the input schema already documents that domain is a 'host name you control'. The description adds only the nuance that the domain is registered if new and is the target of challenge publication. With the schema carrying the meaning of the parameter, baseline 3 is appropriate.

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

Purpose5/5

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

The description states the specific verb/resource relationship: it registers the domain if new and checks the control challenge by returning a TXT record or well-known file to publish. This is unambiguous and distinct; no sibling tool in the list does domain verification, so agents can select it without opening the schema.

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

Usage Guidelines4/5

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

It gives an explicit interaction pattern: first call returns the challenge to publish, later calls return verified=true once the record is live. This tells the agent to call once, publish the record, then continue calling to poll. It does not enumerate when not to use it or name alternative tools, but the two-stage call flow works as a usage guide.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.