MCP Server: a beginner's guide
Model Context Protocol for AI integrations
Advanced MCP: how AI assistants chain multiple checks into a single answer
Advanced MCP (Model Context Protocol) tools are tools that don't just answer one question — they chain multiple underlying checks together, run them in the right order, interpret the combined result, and return a single consolidated answer. Where a basic MCP tool might be "look up the SPF record for this domain," an advanced MCP tool is "give me a complete email security audit, with letter grades, prioritized fix recommendations, and a paragraph I can paste into a board update." The complexity is hidden behind a single call, so the user gets the useful output without having to know which seven underlying tools the AI just orchestrated to produce it.
You should care because the leap from "single tool" to "chained workflow" is the leap from AI as a search engine to AI as a coworker. A single tool answers a single question. A chained workflow does the entire job and gives you the result you actually wanted. The same person who would never have learned how to run seven different DNS tools and stitch the results together by hand can now ask one question in plain English and get the same result, formatted, summarized, and ready to act on. This is the part of AI tool use that genuinely changes how non-technical people interact with technical systems.
The five things every advanced MCP tool typically does behind the scenes:
Orchestration. Decides which underlying tools to call, in which order, with which parameters.
Parallel execution. Runs independent checks simultaneously instead of serially, so the wall-clock time is dramatically lower.
Result fusion. Combines structured outputs from many tools into a single coherent picture.
Interpretation. Translates the technical signals into plain-language insights — "your SPF passes but your DKIM is broken because your DMARC alignment is set to strict."
Recommendation. Suggests the next action — "add the HubSpot DKIM CNAMEs to fix this."
Three questions an advanced MCP tool answers:
Can I get the complete answer to a complex question in one conversation, instead of running ten tools by hand?
Can the AI handle the orchestration so I don't need to know which checks to run or in what order?
For a non-technical user, can the result come back in plain language with concrete next steps?
The cost of not having advanced MCP tools is leaving non-technical users stuck running individual tools and trying to interpret the results. The fix is to build (or use) tools that combine the underlying checks into the actual answer the user needs. This is the part of AI tool use that feels closest to magic — and it is also where MCP genuinely earns its place as a core piece of how modern technical work gets done.
The MCP Server endpoint, in plain language
In one sentence: Model Context Protocol for AI integrations
MCP (Model Context Protocol) server endpoint implementing the JSON-RPC 2.0 based protocol (version 2024-11-05) for AI assistant integrations. Enables Claude, ChatGPT, Cursor, Windsurf, GitHub Copilot, and other MCP-compatible AI tools to query EdgeDNS through standardized tool discovery and invocation. Supports batch JSON-RPC requests for parallel tool execution.
Don't worry if some of the words above are still unfamiliar — there's a plain-language glossary at the bottom of this page, and most of the terms link to their own beginner guides if you want to learn more.
What is actually happening when you call it
Here's what's actually happening behind the scenes when you call this endpoint:
Implements the Model Context Protocol specification with initialize, tools/list, tools/call, and ping methods. Exposes 5 tools: dns_lookup (resolve any DNS (Domain Name System) record type), whois_lookup (RDAP-based registration data), ssl_certificate (certificate validation with crt.sh enrichment), security_headers (6-header analysis with grading), and domain_intelligence (comprehensive report combining DNS + SSL (Secure Sockets Layer) + security headers). Each tool has a JSON (JavaScript Object Notation) Schema input definition for AI auto-discovery. Supports JSON-RPC 2.0 batch requests to invoke multiple tools in a single HTTP (HyperText Transfer Protocol) call.
If you're using an AI assistant through MCP, you don't need to understand any of the technical details — the assistant calls the tool and translates the result for you.
Why this specific tool matters
Let's skip the marketing fluff and answer the only question that actually matters: why should you, a real human with a real to-do list, care about the MCP Server tool? Here's the plain-English version, written the way you'd hear it from a friend who happens to do this for a living.
Integrate EdgeDNS directly into AI-powered workflows without writing custom integration code. AI assistants can automatically discover available tools, understand their parameters through JSON (JavaScript Object Notation) schemas, and invoke them during conversations. Essential for AI-augmented security operations (SecOps), automated incident response, and developer productivity tools like AI coding assistants that need live DNS (Domain Name System) and domain intelligence.
Picture this in real life. Imagine a security analyst / SOC team. Here's the situation they're walking into: Configure Claude or ChatGPT with the EdgeDNS MCP (Model Context Protocol) server so analysts can ask "Check the SSL (Secure Sockets Layer) certificate and security headers for suspicious-domain.com" during incident triage — the AI auto-invokes the right tools. Without the right tool, that person would be stuck copy-pasting between five browser tabs, reading documentation written for engineers, and crossing their fingers that the answer they cobble together is correct. With the MCP Server tool, the same person gets a clear answer in seconds — no spreadsheets, no guessing, no waiting for someone on the infrastructure team to free up.
Three questions this tool answers in plain English. If any of these have ever crossed your mind, the MCP Server tool is built for you:
Can I get the entire story about a domain in a single report instead of running ten checks?
What is the single document I would share with my team, my client, or my board?
Where should I focus my next hour of work to make the biggest difference?
You can either click the tool and get the answer yourself, or ask your AI assistant — connected through MCP (Model Context Protocol) — to ask the question for you and translate the answer into something you can paste into Slack.
Who gets the most out of this. Account executives prepping a sales call, agencies producing a monthly client deliverable, investors doing diligence, and founders building a board deck. If you see yourself in that list, this is one of the EdgeDNS tools you should bookmark today.
What happens if you skip this entirely. Skip it and you have to assemble the same snapshot by hand every time you need it — which means you stop bothering. That's why running this check — even once a month — is one of the cheapest forms of insurance you can give your domain.
Available on the pro plan. The technical details: `POST /v1/advanced/mcp`.
When would I actually use this?
If you're still on the fence about whether the MCP Server tool belongs in your toolbox, this section is for you. Below you'll meet three real people — a security analyst / SOC team, a developer using cursor / windsurf / copilot, and a threat intelligence analyst — facing three real situations where this tool turns a stressful afternoon into a five-minute task. Read whichever story sounds closest to your week.
Story 1: AI-Augmented Security Operations
Imagine you're a security analyst / SOC team. Configure Claude or ChatGPT with the EdgeDNS MCP (Model Context Protocol) server so analysts can ask "Check the SSL (Secure Sockets Layer) certificate and security headers for suspicious-domain.com" during incident triage — the AI auto-invokes the right tools.
Why it matters: Reduces mean-time-to-investigate (MTTI) by giving analysts natural-language access to live DNS (Domain Name System) intelligence without switching between tools.
Story 2: AI Coding Assistant DNS Integration
Imagine you're a developer using cursor / windsurf / copilot. Add EdgeDNS as an MCP (Model Context Protocol) tool source in your AI coding assistant so it can automatically verify DNS (Domain Name System) configuration, check SSL (Secure Sockets Layer) validity, and validate security headers while you code infrastructure-as-code.
Why it matters: Live domain intelligence during development — catch misconfigurations before deployment without leaving your IDE.
Story 3: Automated Threat Intelligence Enrichment
Imagine you're a threat intelligence analyst. Build an AI workflow that automatically enriches IOC domains with DNS (Domain Name System) records, WHOIS (who is) data, SSL (Secure Sockets Layer) certificate info, and security header analysis using batch JSON-RPC requests.
Why it matters: Process threat feeds in conversational AI workflows with structured, real-time domain intelligence from a single MCP (Model Context Protocol) endpoint.
Common situations across teams. Beyond the three stories above, here are the everyday workplace moments when people across the company reach for the MCP Server tool — or one of the tools right next to it in this category. If any of these are on your calendar this month, that's your sign:
Right before a sales call, to walk in already knowing the prospect.
For a monthly client status update or executive summary.
During M&A or investor diligence on a target domain.
When you want to share "everything we know about this domain" in a single link.
If you can see yourself in even one of those bullets, the MCP Server tool will pay for itself the first time you use it.
Still not sure? Here's the easiest test in the world. Open Claude, ChatGPT, Gemini, or any other AI assistant connected to the EdgeDNS MCP server and ask, in your own words: "Is the MCP Server tool useful for my job?" The assistant will look at the tool, ask you a couple of follow-up questions about what you're trying to accomplish, and give you a straight answer in plain English. No commitment, no signup forms, no jargon.
The easiest way: just ask your AI assistant
If you've connected the EdgeDNS MCP server to Claude, ChatGPT, Gemini, Cursor, or any other AI assistant, you don't need to write any code. Just ask in plain English:
"Use the MCP Server tool to check { "jsonrpc": "2.0", "id": 1, "method": "tools/list" } and explain anything that looks wrong in plain language."
The AI will figure out which tool to call, fill in the right parameters, run it, and then explain the result back to you. No copy-pasting between tabs. No reading raw JSON. No memorizing endpoint names.
MCP (Model Context Protocol) access is free on every plan, including the free tier. One API key works for both REST and AI — you do not have to choose.
The technical way: call it from code
If you're a developer and want to call the endpoint from a script or your own application, here's the simplest possible example. Replace the placeholder API key with the real one from your dashboard.
# Replace edns_live_YOUR_KEY with your real API key from the dashboard
curl -H "Authorization: Bearer edns_live_YOUR_KEY" \
"https://api.edgedns.dev/v1/advanced/mcp?domain=%7B%20%22jsonrpc%22%3A%20%222.0%22%2C%20%22id%22%3A%201%2C%20%22method%22%3A%20%22tools%2Flist%22%20%7D"What you need to provide
There's just one piece of information you need to provide. The table below explains exactly what it is and what a real value looks like.
| Field | Type | Required? | What it means | Example |
|---|---|---|---|---|
domain | string | Yes | JSON-RPC 2.0 request body. Methods: initialize, tools/list, tools/call (with name and arguments), ping. Supports batch requests as JSON (JavaScript Object Notation) arrays. | { "jsonrpc": "2.0", "id": 1, "method": "tools/list" } |
What you get back
When you call this tool, you'll get back a JSON object with the fields below. If you're talking to it through an AI assistant, the assistant reads these for you and explains them in plain language — you don't need to memorize them.
| Field | Type | What you'll see in it |
|---|---|---|
jsonrpc | string | Protocol version, always "2.0" |
id | string|number | Request ID matching the client request |
result | object | Success response per MCP (Model Context Protocol) specification (tools list, tool output, or server info) |
result.content | array | Tool call results as content blocks with type and text fields |
error | object | JSON-RPC error with code (-32700 parse, -32600 invalid, -32601 method not found, -32602 invalid params, -32603 internal) |
Words you might be wondering about
If any words on this page felt like jargon, here's a plain-language version. Click any linked term to read a full beginner-friendly guide.
DNS (Domain Name System) — The internet's address book. When you type a website name, DNS turns it into the actual numeric address computers use to find each other.
HTTP (HyperText Transfer Protocol) — The language web browsers and websites use to talk to each other.
SSL (Secure Sockets Layer) — The original encryption used by HTTPS. The name stuck even though every modern site actually uses TLS, the newer replacement.
WHOIS (who is) — A public record that tells you who registered a domain name, when, and through which company. Modern WHOIS is now called RDAP but most people still say 'WHOIS'.
RDAP (Registration Data Access Protocol) — The modern, structured replacement for WHOIS. Returns the same kind of information (who owns this domain?) but in a format computers can read more easily.
JSON (JavaScript Object Notation) — A lightweight format for sending data between programs. Looks like { "name": "example", "age": 5 }. Used by basically every modern web API.
MCP (Model Context Protocol) — An open standard that lets AI assistants — like Claude, ChatGPT, and Gemini — call real tools and read real data, instead of just guessing from what they were trained on.
Need Programmatic Access?
Automate domain intelligence with 100+ API endpoints and a free MCP server for AI integration.