Docs/Sources/DANE Record Grounding Data for AI Agents

DANE Record Grounding Data for AI Agents

Validate DNS DANE/TLSA records

OperationalCredits 2 per callp50 297msSecurity

Overview

Includes validation of certificate data format, length verification, and security level assessment with recommendations for optimal DANE configuration.

Live Test DANE Record Grounding Data for AI Agents Source →

The tool

Once your client is connected to the VerveContext server, this appears in its tool list as DANERecordGroundingDataforAIAgents. It is read-only and open-world — it fetches and never mutates anything on your side — so most clients call it without asking you to confirm.

Tool call
{
  "name": "DANERecordGroundingDataforAIAgents",
  "arguments": {
    "record": "_443._tcp.example.com. 3600 IN TLSA 3 1 1 2bb183af273adee2e02d60ba7a0dc0efcf5e0a2af42dab7b3f8ba9c0def1f6c8"
  }
}

You do not name the tool yourself; the model picks it. Asking about _443._tcp.example.com. 3600 IN TLSA 3 1 1 2bb183af273adee2e02d60ba7a0dc0efcf5e0a2af42dab7b3f8ba9c0def1f6c8 in the terms this source covers is enough for it to reach for DANERecordGroundingDataforAIAgents on its own — naming it explicitly also works, and is the way to force the call.

Connecting

One server URL covers every source in the catalog, including this one. Authorization is OAuth: the client opens a browser once, and there is no key to paste into a config file.

{
  "mcpServers": {
    "vervecontext": {
      "url": "https://api.vervecontext.com/v1/mcp"
    }
  }
}

Per-client setup — Claude, Cursor, VS Code, ChatGPT — is on the MCP setup page.

Arguments

These are the properties on the tool's inputSchema, so a well-behaved client validates them before the call is made. Premium arguments are accepted on every plan but only take effect on plans that include them.

ArgumentTypeDescription
recordRequiredstringThe DANE/TLSA record string to validate

What the model gets back

The result carries a structuredContent object matching the tool's declared outputSchema, so a client reads fields without parsing prose. status is "ok" and error is null on success; a null field means the value was not available for that input, not that the call failed.

Result
{
  "status": "ok",
  "error": null,
  "data": {
    "raw_record": "_443._tcp.example.com. 86400 IN TLSA 3 1 1 0123456789ABCDEF0123456789ABCDEF0123456789ABCDEF0123456789ABCDEF",
    "parsed": {
      "name": "_443._tcp.example.com.",
      "port": 443,
      "protocol": "tcp",
      "hostname": "example.com",
      "ttl": 86400,
      "class": "IN",
      "usage": 3,
      "selector": 1,
      "matching": 1,
      "certificate_data": "0123456789ABCDEF0123456789ABCDEF0123456789ABCDEF0123456789ABCDEF",
      "certificate_data_length": 64
    },
    "interpretation": {
      "usage": {
        "name": "DANE-EE",
        "description": "Domain-issued certificate",
        "full_description": "Certificate must exactly match the provided association data (most common)"
      },
      "selector": {
        "name": "SPKI",
        "description": "SubjectPublicKeyInfo",
        "full_description": "Match against the Subject Public Key Info (recommended)"
      },
      "matching": {
        "name": "SHA-256",
        "description": "SHA-256 hash",
        "full_description": "SHA-256 hash of the selected content (recommended)"
      },
      "security_level": "Recommended",
      "recommendation": "This is the recommended DANE configuration (DANE-EE + SPKI + SHA-256)"
    },
    "validation": {
      "is_valid": true,
      "certificate_data_format": "Valid hexadecimal",
      "certificate_data_length_valid": true
    }
  }
}

Response fields

Paths are relative to data. Premium fields are absent rather than zeroed on plans that do not include them, so check for presence instead of comparing to 0.

FieldTypeExampleDescription
raw_recordstring_443._tcp.example.com. 86400 IN TLSA 3 1 1 0123456789ABCDEF0123456789ABCDEF0123456789ABCDEF0123456789ABCDEFOriginal DANE/TLSA record string input
parsedobject{…}
parsed.namestring_443._tcp.example.com.Fully qualified domain name from TLSA record
parsed.portnumber443Port number specified in TLSA record
parsed.protocolstringtcpProtocol type (tcp or udp) from record
parsed.hostnamestringexample.comExtracted hostname without service prefix
parsed.ttlnumber86400Time to live value in seconds
parsed.classstringINDNS class designation (typically IN)
parsed.usagenumber3TLSA usage field value (0-3)
parsed.selectornumber1TLSA selector field value (0-1)
parsed.matchingnumber1TLSA matching type field value (0-3)
parsed.certificate_datastring0123456789ABCDEF0123456789ABCDEF0123456789ABCDEF0123456789ABCDEFHexadecimal certificate association data
parsed.certificate_data_lengthnumber64Length of certificate data in characters
interpretationPremiumobject{…}Detailed interpretation and security analysis of DANE record
interpretation.usagePremiumobject{…}
interpretation.usage.namePremiumstringDANE-EEHuman-readable TLSA usage type name
interpretation.usage.descriptionPremiumstringDomain-issued certificateShort description of usage type meaning
interpretation.usage.full_descriptionPremiumstringCertificate must exactly match the provided association data (most common)Comprehensive explanation of usage field
interpretation.selectorPremiumobject{…}
interpretation.selector.namePremiumstringSPKIHuman-readable selector type designation
interpretation.selector.descriptionPremiumstringSubjectPublicKeyInfoShort description of selector meaning
interpretation.selector.full_descriptionPremiumstringMatch against the Subject Public Key Info (recommended)Detailed explanation of selector type
interpretation.matchingPremiumobject{…}
interpretation.matching.namePremiumstringSHA-256Human-readable matching algorithm name
interpretation.matching.descriptionPremiumstringSHA-256 hashShort description of matching algorithm
interpretation.matching.full_descriptionPremiumstringSHA-256 hash of the selected content (recommended)Detailed explanation of matching algorithm
interpretation.security_levelPremiumstringRecommendedSecurity assessment of configuration level
interpretation.recommendationPremiumstringThis is the recommended DANE configuration (DANE-EE + SPKI + SHA-256)Expert security recommendation for configuration
validationobject{…}
validation.is_validbooleantrueOverall validation result for DANE record
validation.certificate_data_formatstringValid hexadecimalCertificate data hexadecimal format validation result
validation.certificate_data_length_validbooleantrueValidation status of certificate data length

Why ground on it

A model can produce something that looks like this answer from its training data, and be confidently out of date or simply wrong. This source returns the current value in a shape you can check, which is the difference between an answer you can cite and one you have to hedge.

Point an evaluation at raw_record: it is the field most worth pinning a claim to, and it is either present and current or absent — never plausibly invented.

Failure modes

Errors come back as tool errors carrying a sentence the model can act on, not a bare status code. Error handling covers the full list.

StatusWhat it means
400 / 422The arguments did not validate. The message names the offending one.
401The OAuth session is invalid or expired — reconnect the server.
403Blocked by a key restriction or an IP allow-list. Never a bad identity.
404This source is not part of VerveContext. Check the catalog.
429Out of credits, or a brief rate limit. The message tells them apart.

A call costs 2 credits each time the tool actually runs; a model that reasons about the tool without calling it costs nothing.

Use cases

DANE Configuration
Validate DANE/TLSA record configuration to ensure proper certificate association and DNS security implementation
Authentication Audit
Audit DNS-based authentication of named entities (DANE) for email servers and web services security compliance
Security Scanning
Build DNS security scanning tools that validate TLSA records for certificate pinning and trust anchor verification
Certificate Pinning
Verify certificate pinning implementation using TLSA records to protect against man-in-the-middle attacks and CA compromise

Other ways to use DANE Record Grounding Data for AI Agents

Set up DANE Record Grounding Data for AI Agents on VerveContext, or reach the same source a different way. Your VerveContext account and credits work on all of them — one key, one balance.

Call it as a REST APIOne HTTPS endpoint and an x-api-key header, with SDKs for Node, Python and .NET.APIVerve →Reference →
Give it to an AI agentConnect over MCP and your agent calls it as a native tool — Claude, Cursor, ChatGPT.VerveKit →Reference →
Was this page helpful?