# xdp.es DNS Comprehensive AI & LLM Agent Documentation

> Full specification, protocol reference, and configuration instructions for the xdp.es public recursive DNS resolver hosted in Madrid, Spain. Features native DNSSEC, DoH (HTTP/3 QUIC), DoT, zero logging, and smart routing to mitigate ISP indiscriminate blocking of legitimate services.

## Overview & Architecture

- [Main Service](https://xdp.es/): Canonical home page and overview.
- [DNS Connection Test](https://xdp.es/test): Real-time verification of client DNS resolution.
- [About & Architecture](https://xdp.es/about): Full details on zero-logs policy, recursive resolution, and block mitigation.
- [Telemetry Dashboard](https://xdp.es/stats): Live graphical dashboard.
- [JSON Metrics](https://xdp.es/stats.json): Real-time metrics API endpoint.
- [OpenAPI Schema](https://xdp.es/openapi.json): Machine-readable OpenAPI 3.1.0 API definition.
- [Compact LLMs Summary](https://xdp.es/llms.txt): Quick summary for LLM agents.
- Contact: [contacto@xdp.es](mailto:contacto@xdp.es)

## Protocols & Endpoints

### 1. DNS-over-HTTPS (DoH)
- [DoH Query URL](https://dns.xdp.es/dns-query): Standard RFC 8484 endpoint with ad/malware blocking.
- Protocols: HTTP/1.1, HTTP/2, HTTP/3 (QUIC) on port 443.
- Request Methods: `GET ?dns=<base64url>` or `POST` with binary `application/dns-message`.

### 2. DNS-over-TLS (DoT)
- [DoT Hostname](https://xdp.es/): `dns.xdp.es` on port 853 (RFC 7858 / RFC 8310).

### 3. Plain Recursive DNS
- [IPv4 Resolver](https://xdp.es/): `85.208.114.51` on port 53 UDP/TCP with DNSSEC root anchor validation.
- [IPv6 Resolver](https://xdp.es/): `2a0e:97c0:c40::51` on port 53 UDP/TCP with DNSSEC root anchor validation.

### 4. Apple Configuration Profiles (.mobileconfig)
- [DoH Profile](https://xdp.es/dns_xdp_es_doh.mobileconfig): Installs encrypted DNS over HTTPS on iOS, iPadOS, and macOS.
- [DoT Profile](https://xdp.es/dns_xdp_es_dot.mobileconfig): Installs encrypted DNS over TLS on iOS, iPadOS, and macOS.
