Skip to main content
Glama
Sign In

TLD Bench

by com.tldbench
OverviewDiscussionsAdmin

Extension facts

get_tld
Read-onlyIdempotent

Use this when the user asks what an extension is, who runs it, or whether it fits: type (generic or country code), registry, brand TLD or not, DNSSEC, RDAP and WHOIS servers, minimum term, second levels, registry fees, and its price summary.

Input Schema

NameRequiredDescriptionDefault
tldYesan extension: com, .io, co.uk or рф
yearsNohorizon for totals, 1-10 years (default 3)
currencyNoISO 4217 currency for prices (default USD); converted at the ECB's daily rate, disclosed in `fx`
include_resellersNoinclude registrars whose prices are a reseller account's tier (pricing_tier reseller, e.g. eNom); default false
include_limited_promosNocount limited promotions (one per customer, first-time customers only) in totals and rankings; default false: they are listed and flagged promo_limited, but year 1 is priced at the regular price

Output Schema

NameRequiredDescriptionDefault
fxYesHow converted prices were converted; null when nothing needed converting.
tldYes
urlYesthe page on tldbench.com with the full comparison
as_ofYeswhen the newest price in this response was collected
factsYes
yearsYes
currencyYesISO 4217
wholesaleYesknown registry fees, newest first
second_levelsYespriced extensions under this root (co.uk, org.uk under uk)

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed7 schema fields changed
    • addedInput schema / properties / include_limited_promos
      Added value: +{
+  "default": false,
+  "description": "count limited promotions (one per customer, first-time customers only) in totals and rankings; default false: they are listed and flagged promo_limited, but year 1 is priced at the regular price",
+  "type": "boolean"
+}
    • addedInput schema / properties / include_resellers
      Added value: +{
+  "default": false,
+  "description": "include registrars whose prices are a reseller account's tier (pricing_tier reseller, e.g. eNom); default false",
+  "type": "boolean"
+}
    • changedOutput schema / properties / tld / properties / cheapest_register / anyOf
      Previous value: -[
-  {
-    "properties": {
-      "price": {
-        "description": "An amount in major units (12.99), in `currency`.",
-        "properties": {
-          "amount": {
-            "type": "number"
-          },
-          "currency": {
-            "description": "ISO 4217",
-            "examples": [
-              "USD"
-            ],
-            "pattern": "^[A-Z]{3}$",
-            "type": "string"
-          }
-        },
-        "required": [
-          "amount",
-          "currency"
-        ],
-        "type": "object"
-      },
-      "registrar": {
-        "properties": {
-          "id": {
-            "examples": [
-              "porkbun"
-            ],
-            "type": "string"
-          },
-          "name": {
-            "examples": [
-              "Porkbun"
-            ],
-            "type": "string"
-          },
-          "url": {
-            "description": "the registrar's website (a plain link, no affiliate code)",
-            "type": [
-              "string",
-              "null"
-            ]
-          }
-        },
-        "required": [
-          "id",
-          "name",
-          "url"
-        ],
-        "type": "object"
-      }
-    },
-    "required": [
-      "price",
-      "registrar"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "properties": {
+      "price": {
+        "description": "An amount in major units (12.99), in `currency`.",
+        "properties": {
+          "amount": {
+            "type": "number"
+          },
+          "currency": {
+            "description": "ISO 4217",
+            "examples": [
+              "USD"
+            ],
+            "pattern": "^[A-Z]{3}$",
+            "type": "string"
+          }
+        },
+        "required": [
+          "amount",
+          "currency"
+        ],
+        "type": "object"
+      },
+      "registrar": {
+        "properties": {
+          "id": {
+            "examples": [
+              "porkbun"
+            ],
+            "type": "string"
+          },
+          "name": {
+            "examples": [
+              "Porkbun"
+            ],
+            "type": "string"
+          },
+          "note": {
+            "anyOf": [
+              {
+                "description": "A short, sourced note about the registrar's prices (not a price we rank by).",
+                "properties": {
+                  "checked_on": {
+                    "anyOf": [
+                      {
+                        "examples": [
+                          "2026-11-05"
+                        ],
+                        "format": "date",
+                        "type": "string"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "text": {
+                    "examples": [
+                      "NameSilo's free discount program prices .com at $12.00 (retail $19.99)."
+                    ],
+                    "type": "string"
+                  },
+                  "url": {
+                    "description": "where the note's facts come from",
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  }
+                },
+                "required": [
+                  "text",
+                  "url",
+                  "checked_on"
+                ],
+                "type": "object"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "pricing_tier": {
+            "description": "retail: anyone can buy at these prices; reseller: the prices are a reseller account's tier (eNom's Silver), left out of consumer rankings unless include_resellers=true",
+            "enum": [
+              "retail",
+              "reseller"
+            ],
+            "type": "string"
+          },
+          "url": {
+            "description": "the registrar's website (a plain link, no affiliate code)",
+            "type": [
+              "string",
+              "null"
+            ]
+          }
+        },
+        "required": [
+          "id",
+          "name",
+          "url"
+        ],
+        "type": "object"
+      }
+    },
+    "required": [
+      "price",
+      "registrar"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]
    • addedOutput schema / properties / tld / properties / cheapest_register / description
      Added value: +"the lowest year-1 price; a limited promotion counts at its regular price"
    • changedOutput schema / properties / tld / properties / cheapest_renew / anyOf
      Previous value: -[
-  {
-    "properties": {
-      "price": {
-        "description": "An amount in major units (12.99), in `currency`.",
-        "properties": {
-          "amount": {
-            "type": "number"
-          },
-          "currency": {
-            "description": "ISO 4217",
-            "examples": [
-              "USD"
-            ],
-            "pattern": "^[A-Z]{3}$",
-            "type": "string"
-          }
-        },
-        "required": [
-          "amount",
-          "currency"
-        ],
-        "type": "object"
-      },
-      "registrar": {
-        "properties": {
-          "id": {
-            "examples": [
-              "porkbun"
-            ],
-            "type": "string"
-          },
-          "name": {
-            "examples": [
-              "Porkbun"
-            ],
-            "type": "string"
-          },
-          "url": {
-            "description": "the registrar's website (a plain link, no affiliate code)",
-            "type": [
-              "string",
-              "null"
-            ]
-          }
-        },
-        "required": [
-          "id",
-          "name",
-          "url"
-        ],
-        "type": "object"
-      }
-    },
-    "required": [
-      "price",
-      "registrar"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "properties": {
+      "price": {
+        "description": "An amount in major units (12.99), in `currency`.",
+        "properties": {
+          "amount": {
+            "type": "number"
+          },
+          "currency": {
+            "description": "ISO 4217",
+            "examples": [
+              "USD"
+            ],
+            "pattern": "^[A-Z]{3}$",
+            "type": "string"
+          }
+        },
+        "required": [
+          "amount",
+          "currency"
+        ],
+        "type": "object"
+      },
+      "registrar": {
+        "properties": {
+          "id": {
+            "examples": [
+              "porkbun"
+            ],
+            "type": "string"
+          },
+          "name": {
+            "examples": [
+              "Porkbun"
+            ],
+            "type": "string"
+          },
+          "note": {
+            "anyOf": [
+              {
+                "description": "A short, sourced note about the registrar's prices (not a price we rank by).",
+                "properties": {
+                  "checked_on": {
+                    "anyOf": [
+                      {
+                        "examples": [
+                          "2026-11-05"
+                        ],
+                        "format": "date",
+                        "type": "string"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "text": {
+                    "examples": [
+                      "NameSilo's free discount program prices .com at $12.00 (retail $19.99)."
+                    ],
+                    "type": "string"
+                  },
+                  "url": {
+                    "description": "where the note's facts come from",
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  }
+                },
+                "required": [
+                  "text",
+                  "url",
+                  "checked_on"
+                ],
+                "type": "object"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "pricing_tier": {
+            "description": "retail: anyone can buy at these prices; reseller: the prices are a reseller account's tier (eNom's Silver), left out of consumer rankings unless include_resellers=true",
+            "enum": [
+              "retail",
+              "reseller"
+            ],
+            "type": "string"
+          },
+          "url": {
+            "description": "the registrar's website (a plain link, no affiliate code)",
+            "type": [
+              "string",
+              "null"
+            ]
+          }
+        },
+        "required": [
+          "id",
+          "name",
+          "url"
+        ],
+        "type": "object"
+      }
+    },
+    "required": [
+      "price",
+      "registrar"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]
    • changedOutput schema / properties / tld / properties / cheapest_total / anyOf
      Previous value: -[
-  {
-    "properties": {
-      "registrar": {
-        "properties": {
-          "id": {
-            "examples": [
-              "porkbun"
-            ],
-            "type": "string"
-          },
-          "name": {
-            "examples": [
-              "Porkbun"
-            ],
-            "type": "string"
-          },
-          "url": {
-            "description": "the registrar's website (a plain link, no affiliate code)",
-            "type": [
-              "string",
-              "null"
-            ]
-          }
-        },
-        "required": [
-          "id",
-          "name",
-          "url"
-        ],
-        "type": "object"
-      },
-      "total": {
-        "description": "An amount in major units (12.99), in `currency`.",
-        "properties": {
-          "amount": {
-            "type": "number"
-          },
-          "currency": {
-            "description": "ISO 4217",
-            "examples": [
-              "USD"
-            ],
-            "pattern": "^[A-Z]{3}$",
-            "type": "string"
-          }
-        },
-        "required": [
-          "amount",
-          "currency"
-        ],
-        "type": "object"
-      },
-      "years": {
-        "type": "integer"
-      }
-    },
-    "required": [
-      "years",
-      "total",
-      "registrar"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "properties": {
+      "registrar": {
+        "properties": {
+          "id": {
+            "examples": [
+              "porkbun"
+            ],
+            "type": "string"
+          },
+          "name": {
+            "examples": [
+              "Porkbun"
+            ],
+            "type": "string"
+          },
+          "note": {
+            "anyOf": [
+              {
+                "description": "A short, sourced note about the registrar's prices (not a price we rank by).",
+                "properties": {
+                  "checked_on": {
+                    "anyOf": [
+                      {
+                        "examples": [
+                          "2026-11-05"
+                        ],
+                        "format": "date",
+                        "type": "string"
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "text": {
+                    "examples": [
+                      "NameSilo's free discount program prices .com at $12.00 (retail $19.99)."
+                    ],
+                    "type": "string"
+                  },
+                  "url": {
+                    "description": "where the note's facts come from",
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  }
+                },
+                "required": [
+                  "text",
+                  "url",
+                  "checked_on"
+                ],
+                "type": "object"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "pricing_tier": {
+            "description": "retail: anyone can buy at these prices; reseller: the prices are a reseller account's tier (eNom's Silver), left out of consumer rankings unless include_resellers=true",
+            "enum": [
+              "retail",
+              "reseller"
+            ],
+            "type": "string"
+          },
+          "url": {
+            "description": "the registrar's website (a plain link, no affiliate code)",
+            "type": [
+              "string",
+              "null"
+            ]
+          }
+        },
+        "required": [
+          "id",
+          "name",
+          "url"
+        ],
+        "type": "object"
+      },
+      "total": {
+        "description": "An amount in major units (12.99), in `currency`.",
+        "properties": {
+          "amount": {
+            "type": "number"
+          },
+          "currency": {
+            "description": "ISO 4217",
+            "examples": [
+              "USD"
+            ],
+            "pattern": "^[A-Z]{3}$",
+            "type": "string"
+          }
+        },
+        "required": [
+          "amount",
+          "currency"
+        ],
+        "type": "object"
+      },
+      "years": {
+        "type": "integer"
+      }
+    },
+    "required": [
+      "years",
+      "total",
+      "registrar"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]
    • addedOutput schema / properties / tld / properties / median_register
      Added value: +{
+  "anyOf": [
+    {
+      "description": "An amount in major units (12.99), in `currency`.",
+      "properties": {
+        "amount": {
+          "type": "number"
+        },
+        "currency": {
+          "description": "ISO 4217",
+          "examples": [
+            "USD"
+          ],
+          "pattern": "^[A-Z]{3}$",
+          "type": "string"
+        }
+      },
+      "required": [
+        "amount",
+        "currency"
+      ],
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "the typical year-1 price (median over fresh offers; a limited promotion counts at its regular price)"
+}
  2. First observed

TDQS

A3.9/5.0
Behavior4/5

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

Annotations already declare readOnlyHint, idempotentHint, destructiveHint=false and openWorldHint=false, so the safety profile is covered. The description adds real value beyond that by disclosing the scope of data returned (registry operator, DNSSEC status, RDAP/WHOIS endpoints, minimum term, second-level rules, fee summary). It does not say what happens for an unknown or invalid extension, which is the main remaining gap.

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?

A single sentence, front-loaded with the usage trigger followed by a colon-delimited field inventory. The list is long but each item conveys distinct output scope rather than padding, so it earns its length.

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?

With an output schema present, the description need not explain return values, and the annotations cover the safety profile; combined with the field inventory, an agent has enough to call this correctly. Only error/edge-case behavior for unrecognized extensions is left unaddressed.

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 schema itself carries rich parameter meaning — the years horizon, ISO 4217 currency with ECB conversion disclosed in `fx`, and the reseller/limited-promo inclusion semantics. The description's mention of 'price summary' gestures at the pricing parameters but adds no syntax or format detail beyond what the schema already states, so the baseline 3 applies.

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?

The description names the resource precisely (an extension's facts) and enumerates the returned fields — type, registry, DNSSEC, RDAP/WHOIS servers, fees — so an agent knows it is a TLD profile lookup, not a price comparison. It stops short of explicitly distinguishing itself from siblings like compare_tld_prices or get_registrar, leaving that inference to the reader.

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?

The opening clause gives concrete user-intent triggers: 'what an extension is, who runs it, or whether it fits.' That is clear when-to-use guidance. It offers no exclusions or named alternatives for when a sibling tool (e.g. compare_tld_prices) would be better.

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

All TLD Bench 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