Gandi MCP by usefulapi is an MCP server published by io.usefulapi, hosted at gandi.usefulapi.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 8 tools, including gandi_list_domains, gandi_get_domain, gandi_list_expiring_domains, gandi_list_livedns_domains, gandi_list_zone_records.
List domains and expiry dates; read, create and update LiveDNS records in Gandi.
4,307 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
List the domains owned by the token's user, with status, registry dates, autorenew and nameserver type. Gandi API: GET /v5/domain/domains.
| Parameter | Type | Description |
|---|---|---|
| tld | string | Filter by extension, for example com. |
| fqdn | string | Filter by name, with optional patterns such as example.* or *example.com. |
| page | integer | Page number, starting at 1. |
| per_page | integer | Results per page (max 100). |
| nameserver | string | Filter by nameserver type. |
| sharing_id |
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
| string |
| Organization id to list under (sharing_id filter). |
{
"name": "gandi_list_domains",
"title": "List domains",
"description": "List the domains owned by the token's user, with status, registry dates, autorenew and nameserver type. Gandi API: GET /v5/domain/domains.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"tld": {
"type": "string",
"description": "Filter by extension, for example com."
},
"fqdn": {
"type": "string",
"description": "Filter by name, with optional patterns such as example.* or *example.com."
},
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number, starting at 1."
},
"per_page": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page (max 100)."
},
"nameserver": {
"enum": [
"abc",
"livedns",
"other"
],
"type": "string",
"description": "Filter by nameserver type."
},
"sharing_id": {
"type": "string",
"description": "Organization id to list under (sharing_id filter)."
}
}
},
"annotations": {
"title": "List domains",
"readOnlyHint": true
}
}Get one domain with its status, life-cycle dates (registry_ends_at, renew_begins_at, hold_begins_at), autorenew and nameserver mode. Gandi API: GET /v5/domain/domains/{domain}.
| Parameter | Type | Description |
|---|---|---|
| domain * | string | Domain name, for example example.com. |
{
"name": "gandi_get_domain",
"title": "Get a domain",
"description": "Get one domain with its status, life-cycle dates (registry_ends_at, renew_begins_at, hold_begins_at), autorenew and nameserver mode. Gandi API: GET /v5/domain/domains/{domain}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string",
"maxLength": 253,
"minLength": 3,
"description": "Domain name, for example example.com."
}
}
},
"annotations": {
"title": "Get a domain",
"readOnlyHint": true
}
}List domains whose registry end date falls within the next N days (or has passed), soonest first. Reads up to max_pages pages of 100 domains; check complete in the result. Built from GET /v5/domain/domains.
| Parameter | Type | Description |
|---|---|---|
| days | integer | Look-ahead window in days (default 60). |
| max_pages | integer | Pages of 100 domains to read (default 5, max 10). |
{
"name": "gandi_list_expiring_domains",
"title": "List domains expiring soon",
"description": "List domains whose registry end date falls within the next N days (or has passed), soonest first. Reads up to max_pages pages of 100 domains; check complete in the result. Built from GET /v5/domain/domains.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"days": {
"type": "integer",
"maximum": 365,
"minimum": 1,
"description": "Look-ahead window in days (default 60)."
},
"max_pages": {
"type": "integer",
"maximum": 10,
"minimum": 1,
"description": "Pages of 100 domains to read (default 5, max 10)."
}
}
},
"annotations": {
"title": "List domains expiring soon",
"readOnlyHint": true
}
}List the domains whose DNS is hosted in Gandi LiveDNS. Gandi API: GET /v5/livedns/domains.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, starting at 1. |
| per_page | integer | Results per page (max 100). |
| sharing_id | string | Organization id to list under (sharing_id filter). |
{
"name": "gandi_list_livedns_domains",
"title": "List LiveDNS domains",
"description": "List the domains whose DNS is hosted in Gandi LiveDNS. Gandi API: GET /v5/livedns/domains.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number, starting at 1."
},
"per_page": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page (max 100)."
},
"sharing_id": {
"type": "string",
"description": "Organization id to list under (sharing_id filter)."
}
}
},
"annotations": {
"title": "List LiveDNS domains",
"readOnlyHint": true
}
}List all DNS record sets in a LiveDNS zone, with name, type, TTL and values. Gandi API: GET /v5/livedns/domains/{fqdn}/records.
| Parameter | Type | Description |
|---|---|---|
| fqdn * | string | Domain name, for example example.com. |
{
"name": "gandi_list_zone_records",
"title": "List zone records",
"description": "List all DNS record sets in a LiveDNS zone, with name, type, TTL and values. Gandi API: GET /v5/livedns/domains/{fqdn}/records.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"fqdn"
],
"properties": {
"fqdn": {
"type": "string",
"maxLength": 253,
"minLength": 3,
"description": "Domain name, for example example.com."
}
}
},
"annotations": {
"title": "List zone records",
"readOnlyHint": true
}
}Get one DNS record set by zone, name and type. Returns 404 when the name and type pair does not exist. Gandi API: GET /v5/livedns/domains/{fqdn}/records/{rrset_name}/{rrset_type}.
| Parameter | Type | Description |
|---|---|---|
| fqdn * | string | Domain name, for example example.com. |
| rrset_name * | string | Record name relative to the zone. Use '@' for the zone apex, or 'www' for www.<domain>. |
| rrset_type * | string | Record type, for example A, AAAA, CNAME, MX or TXT. |
{
"name": "gandi_get_zone_record",
"title": "Get a zone record",
"description": "Get one DNS record set by zone, name and type. Returns 404 when the name and type pair does not exist. Gandi API: GET /v5/livedns/domains/{fqdn}/records/{rrset_name}/{rrset_type}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"fqdn",
"rrset_name",
"rrset_type"
],
"properties": {
"fqdn": {
"type": "string",
"maxLength": 253,
"minLength": 3,
"description": "Domain name, for example example.com."
},
"rrset_name": {
"type": "string",
"maxLength": 253,
"minLength": 1,
"description": "Record name relative to the zone. Use '@' for the zone apex, or 'www' for www.<domain>."
},
"rrset_type": {
"enum": [
"A",
"AAAA",
"ALIAS",
"CAA",
"CDS",
"CNAME",
"DNAME",
"DS",
"HTTPS",
"KEY",
"LOC",
"MX",
"NAPTR",
"NS",
"OPENPGPKEY",
"PTR",
"RP",
"SOA",
"SPF",
"SRV",
"SSHFP",
"SVCB",
"TLSA",
"TXT",
"WKS"
],
"type": "string",
"description": "Record type, for example A, AAAA, CNAME, MX or TXT."
}
}
},
"annotations": {
"title": "Get a zone record",
"readOnlyHint": true
}
}Create a DNS record set in a LiveDNS zone. It changes live DNS for the domain. Fails when the name and type pair already exists; use gandi_update_zone_record to change it. Gandi API: POST /v5/livedns/domains/{fqdn}/records/{rrset_name}/{rrset_type}.
| Parameter | Type | Description |
|---|---|---|
| fqdn * | string | Domain name, for example example.com. |
| rrset_ttl | integer | Cache time in seconds (300 to 2592000). Omit to keep the API default. |
| rrset_name * | string | Record name relative to the zone. Use '@' for the zone apex, or 'www' for www.<domain>. |
| rrset_type * | string | Record type, for example A, AAAA, CNAME, MX or TXT. |
| rrset_values * | array | All values of the record set. For example ['192.0.2.10'] for an A record. |
{
"name": "gandi_create_zone_record",
"title": "Create a zone record",
"description": "Create a DNS record set in a LiveDNS zone. It changes live DNS for the domain. Fails when the name and type pair already exists; use gandi_update_zone_record to change it. Gandi API: POST /v5/livedns/domains/{fqdn}/records/{rrset_name}/{rrset_type}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"fqdn",
"rrset_name",
"rrset_type",
"rrset_values"
],
"properties": {
"fqdn": {
"type": "string",
"maxLength": 253,
"minLength": 3,
"description": "Domain name, for example example.com."
},
"rrset_ttl": {
"type": "integer",
"maximum": 2592000,
"minimum": 300,
"description": "Cache time in seconds (300 to 2592000). Omit to keep the API default."
},
"rrset_name": {
"type": "string",
"maxLength": 253,
"minLength": 1,
"description": "Record name relative to the zone. Use '@' for the zone apex, or 'www' for www.<domain>."
},
"rrset_type": {
"enum": [
"A",
"AAAA",
"ALIAS",
"CAA",
"CDS",
"CNAME",
"DNAME",
"DS",
"HTTPS",
"KEY",
"LOC",
"MX",
"NAPTR",
"NS",
"OPENPGPKEY",
"PTR",
"RP",
"SOA",
"SPF",
"SRV",
"SSHFP",
"SVCB",
"TLSA",
"TXT",
"WKS"
],
"type": "string",
"description": "Record type, for example A, AAAA, CNAME, MX or TXT."
},
"rrset_values": {
"type": "array",
"items": {
"type": "string",
"maxLength": 4096,
"minLength": 1
},
"minItems": 1,
"description": "All values of the record set. For example ['192.0.2.10'] for an A record."
}
}
},
"annotations": {
"title": "Create a zone record",
"destructiveHint": true
}
}Replace all values (and optionally the TTL) of one DNS record set. It changes live DNS for the domain and drops the old values. Safe to repeat with the same input. Gandi API: PUT /v5/livedns/domains/{fqdn}/records/{rrset_name}/{rrset_type}.
| Parameter | Type | Description |
|---|---|---|
| fqdn * | string | Domain name, for example example.com. |
| rrset_ttl | integer | Cache time in seconds (300 to 2592000). Omit to keep the API default. |
| rrset_name * | string | Record name relative to the zone. Use '@' for the zone apex, or 'www' for www.<domain>. |
| rrset_type * | string | Record type, for example A, AAAA, CNAME, MX or TXT. |
| rrset_values * | array | All values of the record set. For example ['192.0.2.10'] for an A record. |
{
"name": "gandi_update_zone_record",
"title": "Update a zone record",
"description": "Replace all values (and optionally the TTL) of one DNS record set. It changes live DNS for the domain and drops the old values. Safe to repeat with the same input. Gandi API: PUT /v5/livedns/domains/{fqdn}/records/{rrset_name}/{rrset_type}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"fqdn",
"rrset_name",
"rrset_type",
"rrset_values"
],
"properties": {
"fqdn": {
"type": "string",
"maxLength": 253,
"minLength": 3,
"description": "Domain name, for example example.com."
},
"rrset_ttl": {
"type": "integer",
"maximum": 2592000,
"minimum": 300,
"description": "Cache time in seconds (300 to 2592000). Omit to keep the API default."
},
"rrset_name": {
"type": "string",
"maxLength": 253,
"minLength": 1,
"description": "Record name relative to the zone. Use '@' for the zone apex, or 'www' for www.<domain>."
},
"rrset_type": {
"enum": [
"A",
"AAAA",
"ALIAS",
"CAA",
"CDS",
"CNAME",
"DNAME",
"DS",
"HTTPS",
"KEY",
"LOC",
"MX",
"NAPTR",
"NS",
"OPENPGPKEY",
"PTR",
"RP",
"SOA",
"SPF",
"SRV",
"SSHFP",
"SVCB",
"TLSA",
"TXT",
"WKS"
],
"type": "string",
"description": "Record type, for example A, AAAA, CNAME, MX or TXT."
},
"rrset_values": {
"type": "array",
"items": {
"type": "string",
"maxLength": 4096,
"minLength": 1
},
"minItems": 1,
"description": "All values of the record set. For example ['192.0.2.10'] for an A record."
}
}
},
"annotations": {
"title": "Update a zone record",
"idempotentHint": true,
"destructiveHint": true
}
}Tools for Gandi, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Which of our domains expire in the next 60 days?"; "Show the DNS records for example.com."; "Point the www record of example.com to 192.0.2.10 with a 3600 second TTL.". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Gandi data. Free plan: 50 tool calls per month. Run gandi_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run gandi_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run gandi_upgrade without a plan: it returns both plans, each with a payment link for the user to open. gandi_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.