MCP Integration Guide

Overview

EdgeDNS provides a dedicated MCP server following the industry standard pattern used by Notion, Sentry, Stripe, and GitHub Copilot. The server exposes 90 domain intelligence tools covering DNS, email auth, TLS posture, SEO analysis, tech stack detection, performance, threat intelligence, network diagnostics, compliance, and reporting. Access is included on all plans, including the free tier.

Any client that supports the Model Context Protocol can connect directly — no SDK wrappers or format conversions needed.

Quick Start

Server URL: https://mcp.edgedns.dev/mcp

> Check DNS records and SSL certificate for example.com

# Claude Code
claude mcp add --transport http edgedns https://mcp.edgedns.dev/mcp \
  --header "Authorization: Bearer edns_live_YOUR_KEY"

Client Setup Guides

claude mcp add --transport http edgedns https://mcp.edgedns.dev/mcp \
  --header "Authorization: Bearer edns_live_YOUR_KEY"

{
  "mcpServers": {
    "edgedns": {
      "httpUrl": "https://mcp.edgedns.dev/mcp",
      "headers": {
        "Authorization": "Bearer edns_live_YOUR_KEY"
      }
    }
  }
}

from openai import OpenAI

client = OpenAI()

response = client.responses.create(
    model="gpt-4o",
    tools=[{
        "type": "mcp",
        "server_url": "https://mcp.edgedns.dev/mcp",
        "server_label": "edgedns",
        "headers": {"Authorization": "Bearer edns_live_YOUR_KEY"},
        "require_approval": "never",
    }],
    input="Check DNS records and security headers for example.com",
)
print(response.output_text)

import OpenAI from 'openai';

const openai = new OpenAI();

const response = await openai.responses.create({
  model: 'gpt-4o',
  tools: [{
    type: 'mcp',
    server_url: 'https://mcp.edgedns.dev/mcp',
    server_label: 'edgedns',
    headers: { Authorization: 'Bearer edns_live_YOUR_KEY' },
    require_approval: 'never',
  }],
  input: 'Check DNS records and security headers for example.com',
});
console.log(response.output_text);

Server URL: https://mcp.edgedns.dev/mcp
Header: Authorization: Bearer edns_live_YOUR_KEY

{
  "mcpServers": {
    "edgedns": {
      "type": "http",
      "url": "https://mcp.edgedns.dev/mcp",
      "headers": {
        "Authorization": "Bearer edns_live_YOUR_KEY"
      }
    }
  }
}

Tool Categories

Compatible clients automatically discover all available tools via the standard tools/list method. Tools are organized by category:

Rate Limits

Tool calls are rate limited per API key, matching your plan's rate limits.

Authentication

All tool calls require a valid API key passed as a Bearer token in the Authorization header. Authentication is validated at two layers for defense-in-depth.

Example Prompts

Once connected, ask your AI assistant to analyze domains. It will automatically discover and call the right tools.

> Check DNS records and email auth for example.com

> Run a full audit on example.com including SSL, HTTP headers, and vulnerabilities

> Compare the tech stacks of github.com and gitlab.com

> Check if example.com has any known threats or malware reports

> Analyze SEO performance and structured data for example.com

How It Works

The server is a dedicated Cloudflare Worker built on the official MCP SDK with Streamable HTTP transport. Each tool call dispatches to the main EdgeDNS API via a zero-latency Service Binding, reusing all existing validation, caching, and error handling.

MCP Client (Claude Code, Gemini CLI, etc.)
    |
    | Streamable HTTP (POST/GET to /mcp)
    v
mcp.edgedns.dev  ← Dedicated MCP Worker
    |
    | Service Binding (zero-latency)
    v
api.edgedns.dev  ← Main API Worker
    |
    v
Route handlers, middleware, D1, KV, R2

Troubleshooting