Title97/100
DNS lookup
The title clearly communicates the tool’s action and subject. Keep it concise.
Description76/100
Query the main DNS record types (A, AAAA, CNAME, MX, TXT, NS, SOA) for a domain and display them in a readable view
Describe the returned information so the agent knows whether it will answer the request.
Inputs75/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
domain
The domain name to inspect, e.g. 'example.com'
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
Annotations75/100
Declare idempotentHint based on the tool’s actual behavior.
{
"title": "DNS lookup",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}Output schema68/100
Describe the returned fields so an agent can interpret the result.
View output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"domain",
"queriedAt",
"a",
"aaaa",
"cname",
"mx",
"txt",
"ns",
"soa"
],
"properties": {
"a": {
"oneOf": [
{
"type": "object",
"required": [
"status",
"records"
],
"properties": {
"status": {
"type": "string",
"const": "ok"
},
"records": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"status",
"message"
],
"properties": {
"status": {
"type": "string",
"const": "error"
},
"message": {
"type": "string"
}
},
"additionalProperties": false
}
]
},
"mx": {
"oneOf": [
{
"type": "object",
"required": [
"status",
"records"
],
"properties": {
"status": {
"type": "string",
"const": "ok"
},
"records": {
"type": "array",
"items": {
"type": "object",
"required": [
"priority",
"exchange"
],
"properties": {
"exchange": {
"type": "string"
},
"priority": {
"type": "number"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"status",
"message"
],
"properties": {
"status": {
"type": "string",
"const": "error"
},
"message": {
"type": "string"
}
},
"additionalProperties": false
}
]
},
"ns": {
"oneOf": [
{
"type": "object",
"required": [
"status",
"records"
],
"properties": {
"status": {
"type": "string",
"const": "ok"
},
"records": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"status",
"message"
],
"properties": {
"status": {
"type": "string",
"const": "error"
},
"message": {
"type": "string"
}
},
"additionalProperties": false
}
]
},
"soa": {
"oneOf": [
{
"type": "object",
"required": [
"status",
"record"
],
"properties": {
"record": {
"type": "object",
"required": [
"nsname",
"hostmaster",
"serial",
"refresh",
"retry",
"expire",
"minttl"
],
"properties": {
"retry": {
"type": "number"
},
"expire": {
"type": "number"
},
"minttl": {
"type": "number"
},
"nsname": {
"type": "string"
},
"serial": {
"type": "number"
},
"refresh": {
"type": "number"
},
"hostmaster": {
"type": "string"
}
},
"additionalProperties": false
},
"status": {
"type": "string",
"const": "ok"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"status",
"message"
],
"properties": {
"status": {
"type": "string",
"const": "error"
},
"message": {
"type": "string"
}
},
"additionalProperties": false
}
]
},
"txt": {
"oneOf": [
{
"type": "object",
"required": [
"status",
"records"
],
"properties": {
"status": {
"type": "string",
"const": "ok"
},
"records": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"status",
"message"
],
"properties": {
"status": {
"type": "string",
"const": "error"
},
"message": {
"type": "string"
}
},
"additionalProperties": false
}
]
},
"aaaa": {
"oneOf": [
{
"type": "object",
"required": [
"status",
"records"
],
"properties": {
"status": {
"type": "string",
"const": "ok"
},
"records": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"status",
"message"
],
"properties": {
"status": {
"type": "string",
"const": "error"
},
"message": {
"type": "string"
}
},
"additionalProperties": false
}
]
},
"cname": {
"oneOf": [
{
"type": "object",
"required": [
"status",
"records"
],
"properties": {
"status": {
"type": "string",
"const": "ok"
},
"records": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"status",
"message"
],
"properties": {
"status": {
"type": "string",
"const": "error"
},
"message": {
"type": "string"
}
},
"additionalProperties": false
}
]
},
"domain": {
"type": "string"
},
"queriedAt": {
"type": "string"
}
},
"additionalProperties": false
}