Référence des outils du connecteur MCP Spaceship

Le connecteur MCP Spaceship relie votre assistant IA (tel que Claude) à votre compte Spaceship. Grâce à lui, l’assistant peut vérifier la disponibilité et les prix des domaines, gérer les contacts et les serveurs de noms des domaines, et lire ou modifier les enregistrements DNS en votre nom — il vous suffit de demander en langage naturel, et l’assistant appelle les bons outils.

Le connecteur MCP Spaceship n’achète pas de domaines. L’assistant peut vérifier si un nom est disponible et combien il coûte, mais l’achat lui-même s’effectue sur spaceship.com.

Premiers pas

Vous avez besoin d’un compte Spaceship. Spaceship MCP Connector est disponible à l’adresse https://connector-mcp.spaceship.com/mcp.

  • Claude (web et bureau) — ouvrez Paramètres, choisissez Connectors, trouvez Spaceship dans le répertoire des connecteurs et ajoutez-le. Le Claude d’Anthropic est actuellement le client dont nous avons vérifié la compatibilité avec Spaceship MCP Connector.

  • Autres clients MCP — ajoutez un serveur MCP distant et pointez-le vers https://connector-mcp.spaceship.com/mcp. D’autres clients peuvent fonctionner, mais nous ne les avons pas encore vérifiés.

Lorsque vous vous connectez, il vous sera demandé de vous connecter à Spaceship et d’accorder à l’assistant l’accès à votre compte. Les outils que l’assistant peut utiliser dépendent de l’accès que vous approuvez — si un outil est rejeté parce que l’accès n’a pas été accordé, reconnectez-vous et approuvez l’accès dont il a besoin.

Aperçu des outils

  • Outil : contacts_save

    Ce que cela fait : Enregistre les coordonnées du contact et obtient un ID de contact

  • Outil : contacts_get

    Ce qu’il fait : Lire un contact enregistré à partir de son ID

  • Outil : contacts_list

    Ce qu’il fait : Lister tous les contacts enregistrés pour en trouver un et le réutiliser

  • Outil : domains_list

    Ce qu’il fait : Lister vos domaines, ou rechercher un domaine

  • Outil : domains_check_availability

    Ce qu’il fait : Vérifier si des domaines sont disponibles à l’enregistrement, ainsi que leur prix

  • Outil : domain_set_contacts

    Ce qu’il fait : Attribuer des contacts à un domaine que vous possédez

  • Outil : domain_set_nameservers

    Ce qu’il fait : Basculer un domaine vers des serveurs de noms de base ou personnalisés

  • Outil : dns_records_get

    Ce qu’il fait : Lire les enregistrements DNS d’un domaine

  • Outil : dns_records_save

    Ce qu’il fait : Ajouter des enregistrements DNS ou mettre à jour leur TTL

  • Outil : dns_records_delete

    Ce qu’il fait : Supprimer des enregistrements DNS

  • Outil : async_operation_get

    Ce qu’il fait : Vérifier le statut d’une opération de longue durée

Aucun de ces outils ne facture votre compte.

Contacts : référencés par identifiant

Lorsqu’un contact est requis (domain_set_contacts), chaque rôle prend une contactId chaîne — jamais des coordonnées de contact en ligne. Enregistrez d’abord le contact avec contacts_save (qui renvoie son contactId), puis transmettez cet identifiant là où le contact est accepté. Il n’existe pas d’enregistrement automatique en ligne ; un rôle ne peut pas recevoir un objet contact complet. Vous pouvez également réutiliser un contactId provenant d’un résultat contacts_list ou lu dans un résultat domains_list.

Un contactId est une chaîne de 27 à 32 caractères alphanumériques. Il suffit de la retransmettre là où un contact est accepté.

Flux de travail courants

Plusieurs outils sont conçus pour être utilisés ensemble : la sortie de l’un devient l’entrée du suivant.

Trouver un domaine à acheter

  1. domains_check_availability — vérifiez le ou les noms souhaités. Chaque nom disponible inclut le price en USD pour l’enregistrer (standard comme premium), ou priceUnavailableReason lorsqu’il ne peut pas être déterminé, ainsi que minRegisterPeriodInYears et maxRegisterPeriodInYears — les durées autorisées par le TLD. Notez que le price couvre price.pricedYears années, ce qui correspond à la durée minimale autorisée par le TLD et n’est pas toujours égal à 1.

  2. Achetez-le sur spaceship.com. Aucun outil n’enregistre un domaine ni ne produit de lien de paiement, donc l’assistant ne peut pas finaliser l’achat ni dire qu’un domaine a été enregistré depuis la conversation. Une fois l’achat effectué, domains_list affiche le nouveau domaine.

Mettre à jour les contacts d’un domaine que vous possédez

  1. domain_set_contacts — attribuez des contacts au domaine via contactId (enregistrez-les d’abord avec contacts_save si nécessaire). Cela se termine immédiatement et renvoie un verificationStatus : verification signifie que le titulaire doit confirmer son adresse e-mail avant que la modification ne soit entièrement appliquée (un e-mail lui est envoyé), success signifie qu’elle est déjà confirmée, et null signifie qu’aucune confirmation n’est requise pour ce domaine.

Modifier les serveurs de noms d’un domaine

  1. domains_list — trouvez le domaine et consultez ses nameservers actuels ({ provider, hosts }).

  2. domain_set_nameservers — basculez-le vers les serveurs de noms par défaut de Spaceship avec provider: "basic" (sans hosts), ou pointez-le vers les vôtres avec provider: "custom" et une liste de 2 à 12 hosts. Il renvoie le { provider, hosts } résultant, et un appel ultérieur à domains_list reflète la modification. Réappliquer l’état dans lequel se trouve déjà un domaine renvoie une erreur de validation plutôt qu’une absence d’effet — considérez cela comme attendu, et non comme un échec nécessitant une nouvelle tentative.

Gérer les enregistrements DNS

  1. domains_list — trouvez le domaine que vous souhaitez gérer (ou transmettez directement son nom si vous le connaissez).

  2. dns_records_get — lisez les enregistrements actuels du domaine.

  3. dns_records_save ou dns_records_delete — ajoutez, mettez à jour ou supprimez des enregistrements. Les enregistrements renvoyés par dns_records_get ont la même forme que celle acceptée par les outils d’enregistrement et de suppression (la suppression omet simplement ttl), de sorte que l’assistant peut lire, ajuster et réécrire. La correspondance ne tient pas compte de la casse, sauf pour les enregistrements TXT, qui sont sensibles à la casse.

Examiner votre portefeuille

  • domains_list — parcourez tous vos domaines avec tri et pagination, ou récupérez un seul domaine par son nom. Chaque domaine inclut sa date d’expiration, le paramètre de renouvellement automatique, le statut, les serveurs de noms, la protection de la confidentialité et les identifiants de contact attribués.

  • contacts_list — parcourez tous les contacts enregistrés sur votre compte pour trouver et réutiliser un contact existant (par son identifiant de contact) au lieu de créer un doublon.

  • contacts_get — consultez les détails associés à tout identifiant de contact que vous voyez sur un domaine ou dans un résultat contacts_list.

Référence des outils

Chaque outil renvoie son résultat sous forme de JSON structuré, et chaque outil se termine immédiatement.

Contacts

Les contacts sont les personnes ou organisations associées à l’enregistrement d’un domaine (titulaire, admin, technique, facturation). Un contact est référencé partout par son identifiant de contact — une chaîne opaque.

contacts_save — Enregistrer le contact

Enregistre les coordonnées du contact et renvoie l’identifiant de contact généré. La validation de certains champs (tels que stateProvince et postalCode) dépend du pays sélectionné.

  • Paramètre : firstName

    Obligatoire : Oui

    Type et contraintes : Chaîne, 1 à 64 caractères. Peut inclure des traits d’union et des apostrophes.

  • Paramètre : lastName

    Obligatoire : Oui

    Type et contraintes : Chaîne, 1 à 64 caractères. Peut inclure des traits d’union et des apostrophes.

  • Paramètre : email

    Obligatoire : Oui

    Type et contraintes : Adresse e-mail valide, 254 caractères max.

  • Paramètre : address1

    Obligatoire : Oui

    Type et contraintes : Ligne d’adresse 1. Chaîne, 1 à 128 caractères.

  • Paramètre : city

    Obligatoire : Oui

    Type et contraintes : Chaîne, 1 à 64 caractères.

  • Paramètre : country

    Obligatoire : Oui

    Type et contraintes : Code pays à deux lettres (ISO 3166-1 alpha-2), par ex. US.

  • Paramètre : phone

    Obligatoire : Oui

    Type et contraintes : Format international +CountryCode.Number, par ex. +1.2025551234. 32 caractères max.

  • Paramètre : organization

    Obligatoire : Non

    Type et contraintes : Nom de l’organisation/de l’entreprise. 1–128 caractères.

  • Paramètre : address2

    Obligatoire : Non

    Type et contraintes : Ligne d’adresse 2. 1–128 caractères.

  • Paramètre : stateProvince

    Obligatoire : Non

    Type et contraintes : Nom de l’État/de la province, 1–64 caractères. Peut être requis selon le pays.

  • Paramètre : postalCode

    Obligatoire : Non

    Type et contraintes : 1–16 caractères. Peut être requis selon le pays.

  • Paramètre : phoneExt

    Obligatoire : Non

    Type et contraintes : Extension téléphonique, 1–16 caractères.

  • Paramètre : fax

    Obligatoire : Non

    Type et contraintes : Numéro de fax, même format +CountryCode.Number, 32 caractères max.

  • Paramètre : faxExt

    Obligatoire : Non

    Type et contraintes : Extension de fax, 1–16 caractères.

  • Paramètre : taxNumber

    Obligatoire : Non

    Type et contraintes : Numéro fiscal, 1–32 caractères.

Renvoie

{ "contactId": "..." }

contactId (27–32 caractères alphanumériques) est ce que vous transmettez à domain_set_contacts et contacts_get.

contacts_get — Obtenir un contact

Lit les détails d’un contact enregistré à partir de son ID de contact. Les ID de contact proviennent de contacts_save, contacts_list, ou du champ contacts dans les résultats de domains_list.

  • Paramètre : contactId

    Obligatoire : Oui

    Type et contraintes : ID de contact, 27–32 caractères alphanumériques.

Renvoie — { contact } avec :

  • Champ : firstName, lastName, email, address1, city, country, phone, postalCode

    Type : Chaîne

  • Champ : organization, address2, stateProvince, phoneExt, fax, faxExt, taxNumber

    Type : Chaîne ou null

contacts_list — Lister les contacts

Liste tous les contacts enregistrés sous votre compte, afin que vous puissiez trouver et réutiliser un contact existant (par son ID de contact) au lieu de créer un doublon ou de chercher parmi vos domaines. La liste est paginée et triable, de manière cohérente avec domains_list.

  • Paramètre : take

    Obligatoire : Non

    Type et contraintes : Éléments par page, 1–100. Valeur par défaut 10.

  • Paramètre : skip

    Obligatoire : Non

    Type et contraintes : Éléments à ignorer, 0 ou plus. Valeur par défaut 0.

  • Paramètre : orderBy

    Obligatoire : Non

    Type et contraintes : Jusqu’à 8 clés de tri : name, email, organization ; préfixez avec - pour l’ordre décroissant (par ex. -name).

Renvoie — { items, total } où total est le nombre de contacts uniques sur le compte (dédupliqués par ID de contact, et non par taille de page), et chaque élément contient suffisamment d’informations pour distinguer les contacts sans appel supplémentaire. Si le compte contient des entrées en double pour le même ID de contact, elles sont regroupées en une seule, de sorte que total compte les contacts distincts plutôt que les lignes brutes côté serveur :

  • Champ : contactId

    Type : Chaîne (27–32 alphanumériques). À transmettre à contacts_get ou domain_set_contacts.

  • Champ : name

    Type : Chaîne — le nom du contact.

  • Champ : email

    Type : Chaîne ou null lorsque le contact n’a pas d’adresse e-mail enregistrée.

  • Champ : organization

    Type : Chaîne ou null lorsque le contact n’a pas d’organisation enregistrée.

{
"items": [
{ "contactId": "1anq5bsl9haBy21rOV9aeDWrARBsV", "name": "Ada Lovelace", "email": "ada@example.com", "organization": "Analytical Engines" }
],
"total": 1
}

Domaines

Les entrées de nom de domaine (domain/domainName) acceptent l’Unicode (IDN) ou l’ASCII (A-label) — dans les deux cas, l’outil normalise automatiquement le nom en punycode avant utilisation. domains_check_availability exige en outre un TLD que Spaceship prend en charge pour l’enregistrement : un domaine dont le TLD n’est pas pris en charge est signalé comme non disponible au lieu d’être vérifié. Les autres outils de domaine (domains_list, domain_set_contacts, domain_set_nameservers) ainsi que les outils DNS normalisent uniquement le nom et ne rejettent jamais en fonction de la prise en charge du TLD.

domains_list — Lister les domaines

Récupère une liste paginée de vos domaines. Transmettez domain pour récupérer à la place un seul domaine par son nom (la pagination et le tri sont alors ignorés, et le résultat inclut une note l’indiquant s’ils ont été fournis).

  • Paramètre : domain

    Obligatoire : Non

    Type et contraintes : Nom de domaine pleinement qualifié pour récupérer un seul domaine. Accepte l’Unicode (IDN) ou l’ASCII (A-label) — normalisé automatiquement en punycode.

  • Paramètre : take

    Obligatoire : Non

    Type et contraintes : Éléments par page, 1–100. Valeur par défaut 10.

  • Paramètre : skip

    Obligatoire : Non

    Type et contraintes : Éléments à ignorer, 0 ou plus. Valeur par défaut 0.

  • Paramètre : orderBy

    Obligatoire : Non

    Type et contraintes : Jusqu’à 8 clés de tri : name, unicodeName, registrationDate, expirationDate ; préfixez avec - pour l’ordre décroissant (par ex. -expirationDate).

Renvoie — { items, total } où chaque élément décrit un domaine :

  • Champ : name / unicodeName

    Signification : Nom de domaine sous forme ASCII et Unicode.

  • Champ : isPremium

    Signification : Indique si le domaine est un nom premium.

  • Champ : autoRenew

    Signification : Indique si le renouvellement automatique est activé.

  • Champ : registrationDate / expirationDate

    Signification : Horodatages d’enregistrement et d’expiration.

  • Champ : lifecycleStatus

    Signification : creating, registered, grace1, grace2, ou redemption.

  • Champ : verificationStatus

    Signification : verification, success, failed, ou null lorsque non applicable.

  • Champ : eppStatuses

    Signification : Codes d’état du registre (par ex. verrous de transfert).

  • Champ : suspensions

    Signification : Suspensions actives, chacune avec un reasonCode.

  • Champ : privacyProtection

    Signification : { level: "public" | "high", contactForm: boolean }.

  • Champ : nameservers

    Signification : { provider: "basic" | "custom", hosts: [...] }.

  • Champ : contacts

    Signification : ID de contact : registrant, plus admin/tech/billing (peuvent être null) et attributes (une liste d’ID de contact d’attributs étendus, ou null). Lisibles via contacts_get.

Spaceship MCP renseigne tous les champs ci-dessus — y compris contacts, eppStatuses, suspensions, verificationStatus, nameservers, un véritable autoRenew, et un unicodeName distinct lorsque le domaine en possède un — à la fois pour les listes à plusieurs éléments et pour les récupérations d’un seul domaine.

domains_check_availability — Vérifier la disponibilité d’un domaine

Vérifie si un ou plusieurs noms de domaine sont disponibles à l’enregistrement. Utilise le point de terminaison pour un seul domaine pour un nom et le point de terminaison en masse pour plusieurs. Un domaine dont le TLD n’est pas pris en charge pour l’enregistrement n’est pas du tout envoyé à la vérification de disponibilité — il est immédiatement renvoyé comme tldNotSupported.

  • Paramètre : domains

    Obligatoire : Oui

    Type et contraintes : 1–20 noms de domaine pleinement qualifiés. Chacun accepte l’Unicode (IDN) ou l’ASCII (A-label) — normalisé automatiquement en punycode.

Renvoie — { results }, une entrée par nom demandé :

  • Champ : domain

    Signification : Le nom vérifié.

  • Champ : result

    Signification : available, taken, invalidDomainName, tldNotSupported, ou unexpectedError.

  • Champ : premiumPricing

    Signification : Pour les noms premium : liste de { operation, price, currency } où operation est register, transfer, renew, ou restore. Vide pour les noms standard.

  • Champ : price

    Signification : Pour les noms disponibles (standard et premium) : le prix en USD pour enregistrer le domaine pour la durée la plus courte autorisée par le TLD — { amount, currency: "USD", pricedYears?, pricePerYear?, icannFee?, isPremium }. amount est le total à payer pour toute cette durée ; pricedYears indique combien d’années elle couvre. Aucun prix avant remise ou prix « ancien » n’est indiqué. icannFee est les frais ICANN (USD) déjà inclus dans amount, renvoyés séparément afin que le détail puisse être expliqué ; ils n’apparaissent que lorsque le TLD comporte des frais.

  • Champ : pricePerYear

    Signification : À l’intérieur de price : amount divisé par pricedYears, afin qu’une valeur annuelle soit toujours disponible pour comparaison. Lorsque pricedYears vaut 1, il s’agit du véritable prix pour un an ; au-delà, il s’agit d’une moyenne annuelle de la durée, et non d’une durée que vous pourriez acheter.

  • Champ : minRegisterPeriodInYears / maxRegisterPeriodInYears

    Signification : Pour les noms disponibles : la durée d’enregistrement la plus courte et la plus longue que ce TLD autorise réellement, sous forme de deux nombres simples. Elles indiquent au client pour quelles durées il peut acheter le domaine. Les deux sont omises lorsque la durée autorisée n’a pas pu être déterminée.

  • Champ : priceUnavailableReason

    Signification : Présent à la place de price lorsque le prix n’a pas pu être déterminé pour un nom disponible. La vérification elle-même réussit tout de même.

Seuls les noms disponibles sont tarifés ; les résultats taken/invalid n’ont ni price ni priceUnavailableReason.

La plupart des TLD autorisent un an, mais certains ne le permettent pas..ai, par exemple, a un minimum de deux ans. Pour ceux-là, price.amount est le total pour la durée minimale — et non un prix d’un an que vous pourriez réellement acheter — et price.pricedYears l’indique :

{
"domain": "example.ai",
"result": "available",
"premiumPricing": [],
"price": { "amount": 159.96, "currency": "USD", "pricedYears": 2, "pricePerYear": 79.98, "isPremium": false },
"minRegisterPeriodInYears": 2,
"maxRegisterPeriodInYears": 10
}

pricePerYear est présent ici — 159.96 divisé par les deux années qu’il couvre donne 79.98. Il s’agit du total divisé par la durée, et non d’un prix que vous pourriez payer pour une seule année (un enregistrement .ai d’un an ne peut pas être acheté). Affichez toujours amount avec pricedYears (« 159,96 $ pour 2 ans »), jamais amount seul. Pour un TLD ordinaire, pricedYears vaut 1 et pricePerYear est égal à amount.

domain_set_contacts — Définir les contacts du domaine

Modifie les contacts attribués à un domaine que vous possédez. S’exécute immédiatement (aucune opération à interroger).

  • Paramètre : domainName

    Obligatoire : Oui

    Type et contraintes : Nom de domaine pleinement qualifié. Accepte l’Unicode (IDN) ou l’ASCII (A-label) — normalisé automatiquement en punycode.

  • Paramètre : registrant

    Obligatoire : Oui

    Type et contraintes : contactId chaîne (27–32 alphanumériques), provenant de contacts_save.

  • Paramètre : admin

    Obligatoire : Non

    Type et contraintes : contactId chaîne (27–32 alphanumériques) ou null.

  • Paramètre : tech

    Obligatoire : Non

    Type et contraintes : contactId chaîne (27–32 alphanumériques) ou null.

  • Paramètre : billing

    Obligatoire : Non

    Type et contraintes : contactId chaîne (27–32 alphanumériques) ou null.

  • Paramètre : attributes

    Obligatoire : Non

    Type et contraintes : Tableau d’identifiants de contact d’attributs étendus (jusqu’à 5) ; requis uniquement pour certains TLD, sinon omettez-le ou utilisez null.

Renvoie

{ "verificationStatus": "verification" }

Le verificationStatus renvoyé reflète la vérification d’e-mail ICANN RAA : verification — le titulaire doit confirmer son adresse e-mail (un e-mail de confirmation est envoyé) ; success — déjà confirmé ; null — la vérification RAA ne s’applique pas à ce domaine.

domain_set_nameservers — Définir les serveurs de noms du domaine

Modifie les serveurs de noms d’un domaine au niveau du registraire. S’exécute immédiatement (aucune opération à interroger). La modification est ensuite reflétée par domains_list.

  • Paramètre : domainName

    Obligatoire : Oui

    Type et contraintes : Nom de domaine pleinement qualifié. Accepte l’Unicode (IDN) ou l’ASCII (A-label) — normalisé automatiquement en punycode.

  • Paramètre : provider

    Obligatoire : Oui

    Type et contraintes : basic (serveurs de noms par défaut de Spaceship) ou custom (vos propres hôtes).

  • Paramètre : hosts

    Obligatoire : Conditionnel

    Type et contraintes : Obligatoire lorsque provider est custom : 2 à 12 noms d’hôte de serveurs de noms (chacun étant un FQDN valide, de 4 à 255 caractères). Doit être omis lorsque provider est basic.

Retourne

{ "provider": "custom", "hosts": ["ns1.example.com", "ns2.example.com"] }

Réappliquer l’état dans lequel se trouve déjà un domaine (par ex. définir basic alors qu’il est déjà en basic) renvoie une erreur de validation plutôt qu’un succès sans effet — considérez cela comme un résultat attendu, et non comme un échec nécessitant une nouvelle tentative.

Enregistrements DNS

Le domainName accepté par ces outils prend en charge l’Unicode (IDN) ou l’ASCII (A-label) et est normalisé automatiquement en punycode ; la prise en charge du TLD n’est pas appliquée ici.

dns_records_get — Obtenir les enregistrements DNS

Récupère une liste paginée des enregistrements de ressources DNS d’un domaine.

  • Paramètre : domainName

    Obligatoire : Oui

    Type et contraintes : Le domaine dont les enregistrements doivent être récupérés.

  • Paramètre : take

    Obligatoire : Non

    Type et contraintes : Éléments par page, 1 à 500. Valeur par défaut : 100.

  • Paramètre : skip

    Obligatoire : Non

    Type et contraintes : Éléments à ignorer, 0 ou plus. Valeur par défaut : 0.

  • Paramètre : orderBy

    Obligatoire : Non

    Type et contraintes : Jusqu’à 8 clés de tri : type, -type, name, -name.

Retourne — { items, total }. Chaque élément est un enregistrement tel que décrit dans Formes d’enregistrement, avec en plus un champ facultatif group indiquant d’où provient l’enregistrement (custom — créé par vous, product — géré par un produit Spaceship, personalNs — serveurs de noms personnels).

dns_records_save — Enregistrer les enregistrements DNS

Ajoute des enregistrements DNS personnalisés ou met à jour le TTL de ceux existants. Les enregistrements sont comparés sans tenir compte de la casse, sauf les enregistrements TXT (sensibles à la casse).

  • Paramètre : domainName

    Obligatoire : Oui

    Type et contraintes : Le domaine dont les enregistrements doivent être mis à jour.

  • Paramètre : records

    Obligatoire : Oui

    Type et contraintes : 1 à 500 enregistrements — voir Formes d’enregistrement. Chacun peut inclure un ttl facultatif.

  • Paramètre : force

    Obligatoire : Non

    Type et contraintes : Booléen. Ignore la vérification de résolution des conflits et force la mise à jour de la zone.

Retourne — { "saved": <number> }, le nombre d’enregistrements soumis. Une réponse réussie signifie que tous les enregistrements ont été acceptés ; si un seul enregistrement échoue, l’appel entier renvoie une erreur à la place.

dns_records_delete — Supprimer les enregistrements DNS

Supprime des enregistrements DNS personnalisés. Les suppressions ne peuvent pas être annulées. Les enregistrements sont comparés sans tenir compte de la casse, sauf les enregistrements TXT (sensibles à la casse).

  • Paramètre : domainName

    Obligatoire : Oui

    Type et contraintes : Le domaine dont les enregistrements doivent être supprimés.

  • Paramètre : records

    Obligatoire : Oui

    Type et contraintes : 1 à 500 enregistrements identifiant des enregistrements existants — mêmes formes que pour l’enregistrement, mais sans ttl.

Retourne — { "deleted": <number> }, le nombre d’enregistrements soumis. Si un enregistrement ne peut pas être mis en correspondance, l’appel entier échoue et rien n’est supprimé.

Formes d’enregistrement

Chaque enregistrement comporte :

  • type — l’un des 13 types pris en charge ci-dessous.

  • name — le nom de l’enregistrement hors domaine : utilisez @ pour le domaine lui-même (apex) et * pour un joker.

  • ttl (enregistrement uniquement, facultatif) — durée de mise en cache en secondes, 60 à 3600.

Champs spécifiques au type :

  • Type : A

    Champs : address — adresse IPv4.

  • Type : AAAA

    Champs : address — adresse IPv6.

  • Type : CNAME

    Champs : cname — nom de domaine canonique (253 caractères max.).

  • Type : ALIAS

    Champs : aliasName — nom de domaine canonique ; comportement de type CNAME pour l’apex, là où CNAME n’est pas autorisé.

  • Type : NS

    Champs : nameserver — nom du serveur de noms.

  • Type : PTR

    Champs : pointer — nom de domaine pour l’adresse IP donnée.

  • Type : TXT

    Champs : value — valeur texte (comparée en respectant la casse).

  • Type : MX

    Champs : exchange — serveur de messagerie ; preference — priorité (0 à 65535, la plus basse étant préférée).

  • Type : CAA

    Champs : flag — 0 ou 128 (bit critique) ; tag — issue, issuewild ou iodef ; value — identifiant d’AC avec paramètres facultatifs.

  • Type : SRV

    Champs : service (par ex. _sip) ; protocol (par ex. _tcp) ; priority et weight (0 à 65535) ; port (1 à 65535) ; target — nom de domaine du serveur.

  • Type : TLSA

    Champs : usage, selector, matching (chacun de 0 à 255) ; port — * ou _<1–65535> ; protocol (par ex. _tcp) ; associationData — hachage ou données du certificat.

  • Type : HTTPS

    Champs : svcPriority (0 à 65535 ; 0 = AliasMode) ; targetName — FQDN ou . ; facultatif port (* ou _<1–65535>), scheme (doit être _https lorsque port est défini), svcParams.

  • Type : SVCB

    Champs : svcPriority (0 à 65535 ; 0 = AliasMode) ; targetName — FQDN ou . ; facultatif port, scheme (par ex. _tcp), svcParams.

Opérations asynchrones

async_operation_get — Obtenir le statut d’une opération asynchrone

Vérifie une opération de longue durée sur votre compte à l’aide de son operationId. Appelez-le de manière répétée jusqu’à ce que status soit success ou failed.

  • Paramètre : operationId

    Obligatoire : Oui

    Type et contraintes : Chaîne alphanumérique, 36 caractères max., renvoyée par l’outil qui a démarré l’opération.

Retourne

  • Champ : operationId

    Signification : L’opération interrogée.

  • Champ : status

    Signification : pending, success ou failed.

  • Champ : type

    Signification : Type d’opération, ou null.

  • Champ : details

    Signification : Détails supplémentaires sur l’opération, ou null.

  • Champ : createdAt / modifiedAt

    Signification : Moment où l’opération a été créée / mise à jour pour la dernière fois (modifiedAt peut être null).

Erreurs

Lorsqu’un appel échoue, l’outil renvoie une erreur avec un code et un detail lisible par l’humain expliquant ce qui s’est mal passé — par exemple une entrée invalide (un nom de domaine ou un identifiant de contact mal formé), un domaine ou un contact inexistant, ou un conflit avec l’état actuel. Si un outil est rejeté parce que l’assistant n’a pas reçu l’accès nécessaire, reconnectez Spaceship MCP et approuvez l’accès demandé.

Une adresse e-mail valide est requise