instadomain
Server Details
Domain registration for AI agents via Stripe or x402 crypto with Cloudflare DNS.
- Status
- Healthy
- Last Tested
- Transport
- Streamable HTTP
- URL
Glama MCP Gateway
Connect through Glama MCP Gateway for full control over tool access and complete visibility into every call.
Full call logging
Every tool call is logged with complete inputs and outputs, so you can debug issues and audit what your agents are doing.
Tool access control
Enable or disable individual tools per connector, so you decide what your agents can and cannot do.
Managed credentials
Glama handles OAuth flows, token storage, and automatic rotation, so credentials never expire on your clients.
Usage analytics
See which tools your agents call, how often, and when, so you can understand usage patterns and catch anomalies.
Tool Definition Quality
Average 4.4/5 across 12 of 12 tools scored. Lowest: 3.5/5.
Each tool targets a distinct action or payment method. The three buy tools are clearly differentiated by payment flow (Stripe checkout, crypto x402, Stripe MPP) with explicit guidance on when to use each. All other tools have unique purposes (check, status, renew, transfer).
All tool names follow a consistent verb_noun pattern using lowercase snake_case (e.g., check_domain, suggest_domains, verify_transfer_code). There are no mixed conventions or ambiguous prefixes.
With 12 tools, the set is well-scoped for a domain purchase and management service. Each tool covers a necessary step in the workflow (check, buy via 3 methods, status, renew, transfer), without unnecessary bloat.
The tool surface covers the core domain lifecycle: check availability, purchase (with multiple payment options), renew, and transfer (code request, verify, unlock). Minor gaps like listing owned domains or managing DNS are absent, but the primary use case is well-supported.
Available Tools
12 toolsbuy_domainAInspect
Start the purchase flow for an available domain via Stripe checkout.
IMPORTANT: Before calling this tool, you MUST first call check_domain to get the price, then clearly show the user the price and get their explicit confirmation before proceeding. Never call buy_domain without the user seeing and approving the price first.
The registrant contact details are required because the domain will be registered in the buyer's name (they become the legal owner). WHOIS privacy is enabled by default, so these details are not publicly visible.
Creates a Stripe checkout session. IMPORTANT: After this tool returns,
you MUST open the checkout_url by running the shell command
open "<checkout_url>" (macOS/Linux) so the payment page launches
automatically in the user's default browser. Do NOT paste the URL as
a link. Tell the user the page has been opened and they can complete
payment there.
Args: domain: The domain to purchase (e.g. "coolstartup.com"). first_name: Registrant's first name. last_name: Registrant's last name. email: Registrant's email address. address1: Registrant's street address. city: Registrant's city. state: Registrant's state or province. postal_code: Registrant's postal/zip code. country: 2-letter ISO country code (e.g. "US", "GB", "DE"). phone: Phone number in format +1.5551234567. org_name: Organization name (optional, leave empty for individuals).
Returns: Dict with order_id, checkout_url, price_cents, and price_display.
| Name | Required | Description | Default |
|---|---|---|---|
| city | Yes | ||
| Yes | |||
| phone | Yes | ||
| state | Yes | ||
| domain | Yes | ||
| country | Yes | ||
| address1 | Yes | ||
| org_name | No | ||
| last_name | Yes | ||
| first_name | Yes | ||
| postal_code | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description explains that the domain is registered in the buyer's name, WHOIS privacy is enabled by default, and a Stripe checkout session is created. It lacks details on error handling or idempotency but is thorough for a purchase flow.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is well-structured with a clear opening, prerequisites, notes, and argument list. It is slightly long but each sentence adds value, and critical info is front-loaded.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the complexity (11 params, no annotations), the description covers the entire workflow: prerequisite check, user confirmation, parameter explanations, post-call action, and return fields. It is fully complete for agent usage.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 0%, but the description provides an 'Args' section with clear explanations for all 11 parameters, including example formats (e.g., phone: '+1.5551234567', country: '2-letter ISO code'). This adds significant value beyond the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states 'Start the purchase flow for an available domain via Stripe checkout.' It specifies the action, resource, and method, and distinguishes from siblings like check_domain (prerequisite) and buy_domain_crypto/buy_domain_mpp (different payment methods).
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description explicitly instructs to call check_domain first for price and user confirmation, and after the tool returns, to open the checkout_url via shell command. This provides clear when-to-use and post-call steps, preventing misuse.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
buy_domain_cryptoAInspect
Start the purchase flow for a domain using USDC crypto payment (x402 protocol).
Autonomous two-step payment flow — no browser required:
Step 1: Call this tool to reserve the domain and get a pay_url. Step 2: Pay the pay_url using your x402 wallet:
If you have Coinbase Payments MCP: call its x402 payment tool with the pay_url.
Otherwise: run
curl -L <pay_url>— your x402-enabled HTTP client will handle the 402 handshake and USDC payment on Base automatically.
After payment succeeds, call get_domain_status(order_id) to poll until registration is complete (usually under 60 seconds).
The registrant contact details are required because the domain will be registered in the buyer's name (they become the legal owner). WHOIS privacy is enabled by default, so these details are not publicly visible.
IMPORTANT: Before calling this tool, you MUST first call check_domain to get the price and confirm it with the user.
Args: domain: The domain to purchase (e.g. "coolstartup.com"). first_name: Registrant's first name. last_name: Registrant's last name. email: Registrant's email address. address1: Registrant's street address. city: Registrant's city. state: Registrant's state or province. postal_code: Registrant's postal/zip code. country: 2-letter ISO country code (e.g. "US", "GB", "DE"). phone: Phone number in format +1.5551234567. org_name: Organization name (optional, leave empty for individuals).
Returns: Dict with order_id, pay_url (full URL to pay via x402), price_usdc, price_cents, network, and USDC contract address.
| Name | Required | Description | Default |
|---|---|---|---|
| city | Yes | ||
| Yes | |||
| phone | Yes | ||
| state | Yes | ||
| domain | Yes | ||
| country | Yes | ||
| address1 | Yes | ||
| org_name | No | ||
| last_name | Yes | ||
| first_name | Yes | ||
| postal_code | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, description carries full burden. Discloses two-step payment flow, phone format, country code, WHOIS privacy, and legal ownership rationale. Omits details on payment failure or timeouts but is otherwise thorough.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Well-structured with numbered steps and sections. Slightly verbose but every sentence adds value. Front-loads purpose and workflow. Minor redundancy possible but overall effective.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given 11 params (10 required) and output schema, description covers workflow, prerequisites, post-payment polling, and rationale for registrant details. No gaps noted for the intended use case.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 0%, so description adds value with examples and format hints (e.g., phone: +1.5551234567, country: 2-letter ISO). Most parameters have brief but adequate explanations; org_name notes optionality.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states it starts a purchase flow for a domain using USDC crypto payment (x402 protocol). It distinguishes from siblings like buy_domain (likely fiat) and buy_domain_mpp by specifying the payment method.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Explicitly mandates calling check_domain first to get price and confirm. Details the two-step payment flow, alternatives for step 2 (Coinbase MCP or curl), and post-payment polling via get_domain_status. Provides clear when-to-use and prerequisites.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
buy_domain_mppAInspect
Start the purchase flow for a domain via Stripe's Machine Payments Protocol (MPP).
MPP lets autonomous agents pay with fiat (cards, Link) or stablecoins via Shared Payment Tokens, with no browser checkout. Two-step flow:
Step 1: Call this tool to get an order_id and pay_url. Step 2: Make an HTTP GET request to the pay_url with an MPP-enabled HTTP client. The server responds with HTTP 402 + WWW-Authenticate; the client creates a Shared Payment Token and retries with an Authorization header. The server charges the SPT through Stripe and kicks off domain registration.
After payment, call get_domain_status(order_id) to poll until complete.
Requires: An MPP-compatible client configured to mint SPTs against the server's advertised Stripe Business Network profile.
Args: domain: The domain to purchase (e.g. "coolstartup.com"). first_name: Registrant's first name. last_name: Registrant's last name. email: Registrant's email address. address1: Registrant's street address. city: Registrant's city. state: Registrant's state or province. postal_code: Registrant's postal/zip code. country: 2-letter ISO country code. phone: Phone number in format +1.5551234567. org_name: Organization name (optional).
Returns: Dict with order_id, pay_url (full URL), price_cents, price_display, network_id, and payment_method_types.
| Name | Required | Description | Default |
|---|---|---|---|
| city | Yes | ||
| Yes | |||
| phone | Yes | ||
| state | Yes | ||
| domain | Yes | ||
| country | Yes | ||
| address1 | Yes | ||
| org_name | No | ||
| last_name | Yes | ||
| first_name | Yes | ||
| postal_code | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Given no annotations, description fully discloses behavior: two-step flow, HTTP GET to pay_url, handling 402, creating SPT, charging, and polling. Also explains prerequisites like Stripe Business Network profile. No contradictions.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Well-structured: opening purpose, then MPP explanation, step-by-step flow, requirements, args, returns. Every sentence adds value; no redundancy. Front-loaded with critical info.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Complete for a complex flow tool: covers purpose, protocol details, procedure, prerequisites, all parameters, and return value (order_id, pay_url, price, etc.). No gaps given the complexity and presence of output schema.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Description lists all 11 parameters with meaningful descriptions (e.g., domain example, country format, phone format, org_name optional). Since schema coverage is 0%, this adds essential context beyond type.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Description states 'Start the purchase flow for a domain via Stripe's Machine Payments Protocol (MPP)', specifying verb, resource, and method. It distinguishes from siblings (e.g., buy_domain, buy_domain_crypto) by highlighting MPP-specific payment flow.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Clear two-step flow and requirement for an MPP-compatible client are stated. It mentions polling with get_domain_status after payment. Lacks explicit when-not-to-use, but context is sufficient.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
check_domainAInspect
Check if a domain is available for purchase and get its price.
Always call this before buying. After showing the price, ask the user two things before proceeding:
Confirm they want to purchase at that price.
Which payment method they prefer:
"card" / "Stripe" → call buy_domain (opens Stripe checkout in browser)
"crypto" / "USDC" / "x402" → call buy_domain_crypto (autonomous USDC payment, no browser; requires Coinbase Payments MCP or another x402 wallet)
"MPP" / "agent pay" → call buy_domain_mpp (Stripe agent payments via Shared Payment Token, no browser) If the user has Coinbase Payments MCP configured in their session, suggest crypto as the default. Otherwise default to buy_domain (Stripe).
Args: domain: The full domain name to check (e.g. "coolstartup.com").
Returns: Dict with availability status, price in cents, and formatted price.
| Name | Required | Description | Default |
|---|---|---|---|
| domain | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided, so description carries full burden. Describes check behavior, return information, and subsequent workflow requiring user confirmation and payment selection. No contradiction.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Well-structured with front-loaded main purpose, but the post-price instructions are lengthy. Every sentence is useful, but could be slightly more concise. Still efficient.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given one parameter, no annotations, and presence of output schema, the description covers the tool's purpose, behavior, return type, and even links to next steps. Complete for its complexity.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0%, so description must add meaning. It explains the domain parameter fully: 'The full domain name to check (e.g. "coolstartup.com")'. Provides example and clarifies format.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Clearly states 'Check if a domain is available for purchase and get its price.' Uses specific verb+resource. Distinguishes from sibling tools like buy_domain, check_domains_bulk.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Explicitly says 'Always call this before buying.' Provides step-by-step instructions after showing price, including how to choose payment method and which sibling tool to call next. Also suggests default based on configuration.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
check_domains_bulkAInspect
Check availability of up to 50 domain names in one call.
Uses fast RDAP lookups (no pricing). Returns a summary with total/available/taken counts plus per-domain details.
Args: domains: List of domain names to check (max 50).
| Name | Required | Description | Default |
|---|---|---|---|
| domains | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Describes output summary and per-domain details, plus lookup method. No annotations, so description carries burden. Leaves out error handling and rate limits, but acceptable for a simple read operation.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two concise sentences plus an args line. No wasted words. Purpose front-loaded.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Covers input constraints, behavior, and output. Output schema exists so full return details not needed. Minor omission: no handling of invalid domains or exceeding limit.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Adds 'max 50' constraint and clarifies domain names beyond schema's bare array type. Schema coverage is 0%, so description compensates well.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Clearly states it checks availability of up to 50 domain names in one call, distinguishing it from the singular check_domain sibling.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Specifies use of fast RDAP lookups with no pricing, implying cost-free nature. Explicitly mentions max 50 domains. Lacks explicit when-not or alternatives but context from siblings suffices.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_domain_statusAInspect
Get the status of a domain purchase order.
Polls the backend every 3 seconds (up to 120 seconds) until the order reaches a terminal state (complete or failed).
Args: order_id: The order ID returned from buy_domain (e.g. "ord_abc123").
| Name | Required | Description | Default |
|---|---|---|---|
| order_id | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries full burden. It discloses polling every 3 seconds up to 120 seconds and terminal states. However, it does not mention side effects, auth requirements, or whether it is read-only, which prevents a 5.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is concise with two short paragraphs. The first sentence immediately states the purpose, and the rest provides necessary detail without fluff. Every sentence contributes value.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The tool has an output schema (not shown but present), so return values need not be described. The description covers purpose, input, and behavior (polling). For a simple polling tool, this is complete and sufficient.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 0% (no descriptions in schema). The description provides an example value for order_id and explains it is returned from buy_domain, adding meaning beyond the bare schema (type string). This is a clear improvement, earning a 4.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states 'Get the status of a domain purchase order' with a specific verb and resource. While the purpose is distinct from sibling tools like check_domain or buy_domain, it does not explicitly differentiate itself, so a 4 is appropriate.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies usage after a domain purchase (order_id from buy_domain) and describes polling behavior, but it does not explicitly state when to use versus alternatives or when not to use it, earning a 3.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_transfer_codeAInspect
Get the EPP/transfer authorization code for a completed domain purchase.
Requires a transfer_token from verify_transfer_code.
Args: order_id: The order ID of a completed domain purchase. transfer_token: Token returned by verify_transfer_code.
| Name | Required | Description | Default |
|---|---|---|---|
| order_id | Yes | ||
| transfer_token | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must fully disclose behavioral traits. It only states the operation and prerequisites, omitting details like failure modes, idempotency, or side effects. This is minimal for a mutation tool.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is brief and efficient, with purpose stated first, then prerequisite, then parameter explanations. Every sentence is useful and no repetition.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's simplicity (2 required params) and presence of an output schema, the description covers key aspects: purpose, prerequisite, parameter meanings. It could mention return format or error conditions but is largely sufficient.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The description explains both parameters: order_id is 'the order ID of a completed domain purchase' and transfer_token is 'token returned by verify_transfer_code.' Since schema description coverage is 0%, this adds essential meaning beyond type definitions.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose: 'Get the EPP/transfer authorization code for a completed domain purchase.' It specifies the verb, resource, and context, and distinguishes it from siblings like verify_transfer_code and request_transfer_code.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description explicitly states that a transfer_token from verify_transfer_code is required, indicating the prerequisite and proper sequence. It implies when to use this tool, though could be more explicit about not using it before verification.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
renew_domainAInspect
Renew a domain for 1 additional year.
Creates a Stripe checkout session for the renewal payment.
Args: order_id: The order ID of a completed domain purchase (e.g. "ord_abc123").
| Name | Required | Description | Default |
|---|---|---|---|
| order_id | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries full behavioral disclosure burden. It reveals the side effect of creating a Stripe checkout session, which is useful. However, it does not discuss auth requirements, rate limits, or what happens on payment failure, leaving gaps.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Three concise sentences front-load the main action and key side effect, with zero wasted words. The Args section is neatly formatted.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's low complexity (one parameter, simple action) and existence of an output schema, the description covers the essential behavioral and parameter context. It could mention whether renewal is immediate or involves user payment flow completion, but it is largely complete.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0%, so the description must compensate. The description for order_id adds clear meaning ('The order ID of a completed domain purchase') and provides an example, which is valuable beyond the raw schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool renews a domain for 1 additional year and creates a Stripe checkout session. This verb+resource combination is specific and distinct from sibling tools like buy_domain or suggest_domains.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No explicit guidance on when to use this tool versus alternatives. It only mentions a prerequisite (order_id from a completed purchase) but does not compare with other domain tools or indicate when renewal is applicable.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
request_transfer_codeAInspect
Start the transfer verification flow by sending a code to the registrant's email.
Always call this before get_transfer_code or unlock_domain. Then ask the user to check their email and provide the 6-digit code, then call verify_transfer_code to get a transfer_token.
Args: order_id: The order ID of a completed domain purchase.
| Name | Required | Description | Default |
|---|---|---|---|
| order_id | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the burden. It discloses that a code is sent to the registrant's email and that the tool initiates a verification flow. While it doesn't mention rate limits or code expiration, the behavioral implications are adequately conveyed for a simple code-sending tool.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is concise and well-structured, with the core purpose and usage upfront, followed by parameter details. Every sentence adds value, with no redundant or irrelevant information.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a tool with one parameter and no annotations, the description is complete. It covers the purpose, the required input (order_id), and the integration with sibling tools (get_transfer_code, verify_transfer_code). The existence of an output schema further supports completeness.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The schema has 0% description coverage, so the description adds significant meaning. It includes an Args section explaining order_id as 'The order ID of a completed domain purchase,' which provides essential context beyond the schema's type-only definition.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose: 'Start the transfer verification flow by sending a code to the registrant's email.' It uses specific verbs and resources, and distinguishes from siblings by noting the correct ordering relative to get_transfer_code and unlock_domain.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description explicitly provides usage guidance: 'Always call this before get_transfer_code or unlock_domain.' It also outlines the full workflow, including asking the user for the code and then calling verify_transfer_code.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
suggest_domainsAInspect
Generate domain name ideas from a keyword and check their availability.
Args: keyword: A keyword or short business name (e.g. "taskflow").
| Name | Required | Description | Default |
|---|---|---|---|
| keyword | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided; description mentions generating ideas and checking availability but does not disclose behavioral details such as number of ideas, real-time status, rate limits, or side effects. The agent is left with minimal information about the tool's behavior.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two concise sentences with a clear action verb and example. No redundant information, and the structure is front-loaded with the main purpose.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The tool is simple with one parameter and has an output schema, so the description covers basic purpose. However, it lacks usage guidelines and behavioral transparency, which are needed given no annotations. The description is minimally adequate but not complete.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0%, but the description's Args section adds meaning: 'A keyword or short business name (e.g. 'taskflow')'. This compensates for the lack of schema-level descriptions, providing useful context beyond the type.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the verb 'generate' and resource 'domain name ideas', and specifies the action of checking availability. It distinguishes from sibling tools like check_domain which check specific domains, and buy_domain which purchases.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No explicit guidance on when to use this tool vs siblings. The description implies a brainstorming use case but does not contrast with check_domain or buy_domain, leaving the agent to infer usage context.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
unlock_domainAInspect
Remove the registrar transfer lock. Requires a transfer_token from verify_transfer_code.
Args: order_id: The order ID of a completed domain purchase. transfer_token: Token returned by verify_transfer_code.
| Name | Required | Description | Default |
|---|---|---|---|
| order_id | Yes | ||
| transfer_token | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided, so description carries full burden. It discloses the state change (removing lock) but lacks details on potential failure modes, idempotency, or side effects. Adequate but not exhaustive for a mutation tool.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two sentences plus a clean Args list. No redundant information. Front-loads the purpose immediately. Every sentence adds value.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple unlock operation, the description covers the purpose, prerequisite, and parameter meanings. Output schema exists to define return structure. No gaps identified given the tool's simplicity.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Description defines both parameters: order_id as 'order ID of a completed domain purchase' and transfer_token as 'Token returned by verify_transfer_code.' This adds meaning beyond the schema, which only provides types. Compensates for 0% schema description coverage.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Description clearly states the action: 'Remove the registrar transfer lock.' It identifies the specific resource (domain transfer lock) and verb (remove). Differentiates from siblings by including prerequisite context.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Explicitly states prerequisite: 'Requires a transfer_token from verify_transfer_code.' This tells agents when to use this tool (after verification) and implicitly when not to (before obtaining token). Contextualizes among sibling tools dealing with transfer codes.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
verify_transfer_codeAInspect
Verify the email code and get a transfer token valid for 15 minutes.
Call this after request_transfer_code and the user provides their code. Pass the returned transfer_token to get_transfer_code or unlock_domain.
Args: order_id: The order ID of a completed domain purchase. code: The 6-digit code from the verification email.
| Name | Required | Description | Default |
|---|---|---|---|
| code | Yes | ||
| order_id | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
Tool Definition Quality
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The description discloses the token's 15-minute validity, which is important behavioral context. However, with no annotations provided, the description carries the full burden. It lacks details on error behaviors (e.g., invalid code), idempotency, or whether it consumes the code. The token validity is a positive, but missing failure modes reduce transparency.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is concise and well-structured. It starts with a clear purpose, followed by usage flow instructions, and then parameter definitions in a bulleted list. Every sentence adds value with no fluff.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the sibling tools and the existence of an output schema (not shown but implied), the description covers the entire workflow: when to call this tool, what it returns, and what to do next. It addresses the token lifetime and the relationship to request_transfer_code, get_transfer_code, and unlock_domain. No critical gaps remain.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Despite 0% schema description coverage, the description explicitly defines both parameters: 'order_id: The order ID of a completed domain purchase' and 'code: The 6-digit code from the verification email.' This adds essential meaning beyond the schema's bare type and required status.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose: 'Verify the email code and get a transfer token valid for 15 minutes.' It uses a specific verb (verify) and resource (email code), and the return value is explicit. The tool is well-distinguished from siblings like request_transfer_code and get_transfer_code.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides explicit usage guidance: 'Call this after request_transfer_code and the user provides their code.' It also tells the agent what to do with the result: 'Pass the returned transfer_token to get_transfer_code or unlock_domain.' This clearly defines when to use and how to proceed.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Claim this connector by publishing a /.well-known/glama.json file on your server's domain with the following structure:
{
"$schema": "https://glama.ai/mcp/schemas/connector.json",
"maintainers": [{ "email": "your-email@example.com" }]
}The email address must match the email associated with your Glama account. Once published, Glama will automatically detect and verify the file within a few minutes.
Control your server's listing on Glama, including description and metadata
Access analytics and receive server usage reports
Get monitoring and health status updates for your server
Feature your server to boost visibility and reach more users
For users:
Full audit trail – every tool call is logged with inputs and outputs for compliance and debugging
Granular tool control – enable or disable individual tools per connector to limit what your AI agents can do
Centralized credential management – store and rotate API keys and OAuth tokens in one place
Change alerts – get notified when a connector changes its schema, adds or removes tools, or updates tool definitions, so nothing breaks silently
For server owners:
Proven adoption – public usage metrics on your listing show real-world traction and build trust with prospective users
Tool-level analytics – see which tools are being used most, helping you prioritize development and documentation
Direct user feedback – users can report issues and suggest improvements through the listing, giving you a channel you would not have otherwise
The connector status is unhealthy when Glama is unable to successfully connect to the server. This can happen for several reasons:
The server is experiencing an outage
The URL of the server is wrong
Credentials required to access the server are missing or invalid
If you are the owner of this MCP connector and would like to make modifications to the listing, including providing test credentials for accessing the server, please contact support@glama.ai.
Discussions
No comments yet. Be the first to start the discussion!