MCP Server
pro/v1/advanced/mcpMCP (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.
What It Does
Implements the Model Context Protocol specification with initialize, tools/list, tools/call, and ping methods. Exposes 5 tools: dns_lookup (resolve any DNS 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 + security headers). Each tool has a JSON Schema input definition for AI auto-discovery. Supports JSON-RPC 2.0 batch requests to invoke multiple tools in a single HTTP call.
Why It's Useful
Integrate EdgeDNS directly into AI-powered workflows without writing custom integration code. AI assistants can automatically discover available tools, understand their parameters through JSON 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 and domain intelligence.
Use Cases
AI-Augmented Security Operations
Configure Claude or ChatGPT with the EdgeDNS MCP server so analysts can ask "Check the SSL certificate and security headers for suspicious-domain.com" during incident triage — the AI auto-invokes the right tools.
Reduces mean-time-to-investigate (MTTI) by giving analysts natural-language access to live DNS intelligence without switching between tools.
AI Coding Assistant DNS Integration
Add EdgeDNS as an MCP tool source in your AI coding assistant so it can automatically verify DNS configuration, check SSL validity, and validate security headers while you code infrastructure-as-code.
Live domain intelligence during development — catch misconfigurations before deployment without leaving your IDE.
Automated Threat Intelligence Enrichment
Build an AI workflow that automatically enriches IOC domains with DNS records, WHOIS data, SSL certificate info, and security header analysis using batch JSON-RPC requests.
Process threat feeds in conversational AI workflows with structured, real-time domain intelligence from a single MCP endpoint.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
domain | string | Required | JSON-RPC 2.0 request body. Methods: initialize, tools/list, tools/call (with name and arguments), ping. Supports batch requests as JSON arrays.Example: { "jsonrpc": "2.0", "id": 1, "method": "tools/list" } |
Response Fields
| Field | Type | Description |
|---|---|---|
jsonrpc | string | Protocol version, always "2.0" |
id | string|number | Request ID matching the client request |
result | object | Success response per MCP 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) |
Code Examples
curl "https://api.edgedns.dev/v1/advanced/mcp" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d "domain={ "jsonrpc": "2.0", "id": 1, "method": "tools/list" }"const response = await fetch(
'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',
{
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
}
);
const data = await response.json();
console.log(data);import requests
response = requests.get(
'https://api.edgedns.dev/v1/advanced/mcp',
headers={'Authorization': 'Bearer YOUR_API_KEY'},
params={
'domain': '{ "jsonrpc": "2.0", "id": 1, "method": "tools/list" }'
}
)
data = response.json()
print(data)Read the full MCP Server guide
Why it matters, real-world use cases, parameters, response fields, and how to call it from Claude, ChatGPT, or Gemini via MCP.
Read the guide →Related Endpoints
External References
Learn more about the standards and protocols behind this endpoint.