# Mx Lookup Get {domain}

> Retrieve all MX records for a domain. Results are sorted by priority ascending (lowest numeric value has highest mail delivery priority per RFC 5321).

- Skill: `gabrielmoreira/mx-lookup-get-domain` (Agent Skill)
- Install (CLI): `npx skillmds@latest add gabrielmoreira/mx-lookup-get-domain`
- Raw SKILL.md: https://api.skillmd.com/api/skills/gabrielmoreira/mx-lookup-get-domain/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: gabrielmoreira (https://skillmd.com/u/gabrielmoreira)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/gabrielmoreira/mx-lookup-get-domain

---


## Endpoint

**GET https://requiems.xyz/v1/networking/mx/{domain}**

## MX Lookup

Retrieve all MX records for a domain. Results are sorted by priority ascending (lowest numeric value has highest mail delivery priority per RFC 5321).

## Parameters

| Name | Type | Required | Location | Description |
| ---- | ---- | -------- | -------- | ----------- |
| `domain` | string | yes | path | The domain name to look up MX records for (e.g. gmail.com) |

## Response Example

```json
{
  "data": {
    "domain": "gmail.com",
    "records": [
      { "host": "gmail-smtp-in.l.google.com.", "priority": 5 },
      { "host": "alt1.gmail-smtp-in.l.google.com.", "priority": 10 },
      { "host": "alt2.gmail-smtp-in.l.google.com.", "priority": 20 },
      { "host": "alt3.gmail-smtp-in.l.google.com.", "priority": 30 },
      { "host": "alt4.gmail-smtp-in.l.google.com.", "priority": 40 }
    ]
  },
  "metadata": {
    "timestamp": "2026-01-01T00:00:00Z"
  }
}
```

## Response Fields

| Field | Type | Description |
| ----- | ---- | ----------- |
| `domain` | string | The domain that was queried |
| `records` | array<object> | List of MX records, sorted by priority ascending (lowest number = highest priority) |
| `records[].host` | string | Fully-qualified hostname of the mail server (typically ends with a trailing dot) |
| `records[].priority` | integer | MX priority value. Lower values have higher delivery priority per RFC 5321. |

## Errors

- `400` **bad_request** — The domain parameter is not a valid domain name.
- `404` **not_found** — No MX records were found for the domain (domain may not accept email).
- `500` **internal_error** — DNS lookup failed due to an unexpected server error.