Your Data · Attack Surface

`list_my_discovered_domains`

List domains found by your EdgeProtect discovery (registrar, registration/expiry, nameservers). Distinct from the brand-protection monitored list (see list_my_domains). Costs 1 credit.

POST

tools/call

Cost: 1 credit per successful call · Scope: mcp:org · Response shape: jsonb

Returns data scoped to your own organisation only: the organisation is resolved from your API key and injected server-side, never read from the request.

Parameters

limitintegeroptionaldefault 100

Maximum number of domains to return. Accepted range: 1–500.

Example invocation

Ask your agent: "What domains did discovery find for us?"

curl -s https://api.edgeprotect.io/functions/v1/mcp \
  -H "Authorization: Bearer $EDGEPROTECT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_my_discovered_domains","arguments":{"limit":100}}}'

Response

{
  "count": 2,
  "items": [
    {
      "domain_name": "acme-corp.example",
      "domain_type": "primary",
      "registrar": "Cloudflare, Inc.",
      "registration_date": "2015-08-19T00:00:00.000Z",
      "expiration_date": "2027-08-19T00:00:00.000Z",
      "status": "active",
      "nameservers": [
        "ns1.cloudflare.com",
        "ns2.cloudflare.com"
      ],
      "mx_records": [
        "10 mail.acme-corp.example"
      ]
    },
    {
      "domain_name": "acme-corp.co.example",
      "domain_type": "alias",
      "registrar": "Example Registrar Ltd",
      "registration_date": "2016-02-03T00:00:00.000Z",
      "expiration_date": "2026-02-03T00:00:00.000Z",
      "status": "active",
      "nameservers": [
        "ns1.cloudflare.com",
        "ns2.cloudflare.com"
      ],
      "mx_records": []
    }
  ],
  "generated_at": "2026-06-18T08:15:00.000Z"
}

The full MCP envelope, including _meta.edgeprotect with request_id, credits, and response_truncated, is documented in Response Format.

Response fields

countintegeroptional

Number of domains returned (equals items.length).

itemsarrayoptional

Domains found by your EdgeProtect discovery. Each object contains the fields below.

items[].domain_namestringoptional

The fully qualified domain name.

items[].domain_typestringoptional

The discovered classification of the domain, e.g. primary or alias.

items[].registrarstring | nulloptional

The domain registrar, when available from WHOIS.

items[].registration_datestring | nulloptional

ISO 8601 timestamp of when the domain was registered (UTC), when available.

items[].expiration_datestring | nulloptional

ISO 8601 timestamp of when the registration expires (UTC), when available.

items[].statusstringoptional

The domain status, e.g. active.

items[].nameserversarrayoptional

Array of nameserver hostnames for the domain.

items[].mx_recordsarrayoptional

Array of MX record values for the domain.

generated_atstringoptional

ISO 8601 timestamp indicating when this response was generated.

Errors

Code	Message	When
`-32602`	`invalid_params: limit: min:1`	`limit` is less than 1
`-32602`	`invalid_params: limit: max:500`	`limit` exceeds 500
`-32001`	`unauthorized`	The API key is invalid/revoked, the IP is not allowed, or the key lacks the `mcp:org` scope.
`-32002`	`insufficient_credits`	Your credit balance is zero; top up from the dashboard
`-32603`	`internal`	Unexpected server error; the credit is automatically refunded