# xyz.frl - Free Stateless Dynamic DNS

> Free, stateless dynamic DNS service and remote Model Context Protocol (MCP) server operated at xyz.frl. Zero accounts, zero tracking, instant cryptographic hostnames.

## Overview & Capabilities
- Instant Hostname Generation: Provision unique 32-hex UUID hostnames under `.xyz.frl` without sign-up or registration.
- Stateless Cryptographic Authentication: Authentication is verified via SHA-256 HMAC cryptographic tokens; no user databases, emails, or personal data stored.
- Remote MCP Server: Autonomous AI agents connect directly via Streamable HTTP at `https://xyz.frl/mcp` or Server-Sent Events (SSE) at `https://xyz.frl/mcp/sse`.
- Standard DynDNS API: Compatible with standard dynamic DNS clients, routers, and `curl`.
- Dual-Stack Support: IPv4 (A) and IPv6 (AAAA) records with auto-detection of caller IP or explicit parameters.

## Quick Start for AI Agents (Remote MCP)
Connect your agent directly to our remote MCP server:
- Transports: Streamable HTTP (`https://xyz.frl/mcp`) and Server-Sent Events (`https://xyz.frl/mcp/sse` with message endpoint `https://xyz.frl/mcp/message`)
- Protocol Versions: `2024-11-05`, `2025-11-25`, and `2026-07-28`
- Supported Frameworks: Antigravity (Google DeepMind), Claude Code, Pydantic AI, LangGraph / LangChain, Hugging Face smolagents, CrewAI, Microsoft AutoGen, LlamaIndex, Block Goose, Claude Desktop, Cursor, Codeium Windsurf, Cline / Roo Code, Continue.dev, Zed Editor
- Core Tools:
- `generate_hostname`: Provision fresh credentials (`hostname`, `username`, `password`).
- `update_dns`: Update A/AAAA records using `username` and `password`. Omit `ips` to automatically bind detected public IP.
- `get_caller_ip`: Query caller public IP and address family.
- `check_health`: Verify service operational status.

## Quick Start for DynDNS Clients & Curl (REST API)
1. Provision Credentials:
`GET https://xyz.frl/generate`
Returns: `{"hostname":"<uuid>.xyz.frl","username":"<uuid>","password":"<key>"}`
2. Update DNS Record:
`GET https://xyz.frl/nic/update`
Headers: `Authorization: Basic <base64(username:password)>`
Query Parameter: `myip=<ip>` (optional; caller IP auto-detected if omitted)
Returns: HTTP 202 `Update queued`

## Implementation Guides & Real-World Use Cases
- [Home Automation & IoT](https://xyz.frl/use-cases/home-automation-iot): Home Assistant, ESP32 microcontrollers, and Raspberry Pi cron setups.
- [Remote Server Access & SSH](https://xyz.frl/use-cases/remote-server-access): Headless Linux nodes, bastions, and systemd timer integration.
- [Homelab & Self-Hosting](https://xyz.frl/use-cases/homelab-self-hosting): Nextcloud, Proxmox, TrueNAS, and Docker compose update sidecars.
- [WireGuard VPN Endpoints](https://xyz.frl/use-cases/wireguard-vpn): Stalled handshake prevention, 60s DNS TTL, and client re-resolution.
- [Security Cameras & NVR](https://xyz.frl/use-cases/security-cameras): RTSP surveillance feeds, Frigate NVR, and subscription-free remote viewing.
- [Autonomous AI Agents & MCP](https://xyz.frl/use-cases/ai-agents-mcp): Autonomous agent endpoints, ephemeral hostnames, and MCP lifecycle tools.

## Documentation & Discovery Manifests
- [Full Documentation & Detailed Schemas](https://xyz.frl/llms-full.txt): Comprehensive API schemas, framework code recipes (Antigravity, Claude Code, Pydantic AI, LangGraph, CrewAI, smolagents, AutoGen, LlamaIndex, Goose, Windsurf, Cline), curl recipes, and prompt guides.
- [Use Cases Index](https://xyz.frl/use-cases): Technical architecture and setup guides directory.
- [Remote MCP Discovery Manifest](https://xyz.frl/.well-known/mcp.json): Machine-readable MCP declaration.
- [Web Landing Page](https://xyz.frl/): Interactive hostname generator and documentation.
