An MCP server that looks up DNS records across several public resolvers and shows the result on an interactive 3D globe, using the MCP Apps UI standard.
The server exposes one tool, lookup_dns_records:
| Input | Description |
|---|---|
domain |
Domain to check, e.g. example.com |
recordType |
One of A, AAAA, CNAME, MX, NS, TXT, SOA |
It queries Cloudflare, Google, Quad9 and OpenDNS in parallel over DNS-over-HTTPS and returns one result per resolver:
status:resolved,pending(empty answer),nxdomain, orerror. Thestalestatus exists in the widget but the server does not produce it yet.records: the answers returnederror: the failure message, if any
The result is a short text summary plus structuredContent (domain, recordType, results).
- "Look up the A record for example.com."
- "What are the MX records for gmail.com?"
- "Show the TXT records for github.com on the globe."
- "Do all resolvers return the same nameservers for cloudflare.com?"
- "I just changed the A record for mysite.com. Which resolvers are returning something different?"
- "Does thisdomaindoesnotexist.example resolve anywhere?"
With WebMCP enabled (see WebMCP tools in Chrome), you can follow up with:
- "Focus on Quad9."
- "Which resolvers haven't resolved?"
The MCP endpoint is https://lab.athulanilthomas.in/mcp. To run it locally, see Run locally and use http://localhost:8080/mcp instead.
The quickest way to try it: no install or config files needed.
- Open playground.ai.cloudflare.com.
- In the MCP servers section of the sidebar, enter the endpoint URL and click Connect.
- Ask: "Look up the A record for example.com".
- Run MCP: Add Server from the Command Palette, choose HTTP, and enter the endpoint URL. Or add it to
.vscode/mcp.json:{ "servers": { "dns-globe": { "type": "http", "url": "https://lab.athulanilthomas.in/mcp" } } } - Click Start above the server entry in
mcp.json. - Open Copilot Chat in Agent mode and ask: "Look up the A record for example.com". Allow the tool when prompted. The globe renders inline in the chat.
Add the endpoint URL as a custom connector in the app's connector settings. For a local server, expose it with a tunnel such as cloudflared tunnel --url http://localhost:8080 and use the tunnel URL.
The globe also registers two WebMCP tools that let an agent control it:
focus_resolver: rotate to a resolver (Cloudflare, Google, Quad9, OpenDNS) and highlight itget_globe_state: return the highlighted resolver and every resolver's status and records
To try them:
- In Chrome, open
chrome://flags/#enable-webmcp-testing, set it to Enabled, and relaunch. - Open a host that renders the globe (for example the Cloudflare AI Playground) in that Chrome, and run a DNS check.
- Ask the agent to "focus on Quad9" or "which resolvers haven't resolved?".
Requires Go and pnpm.
cd widget && pnpm install && cd ..
make build-widget
go run ./cmd/serverThe server listens on port 8080 by default; set PORT to change it. Test the tool from the command line:
DOMAIN=example.com RECORD_TYPE=A make call-lookup-dns-records