ns1_create_record

WRITE: creates ONE new DNS record and CHANGES LIVE DNS for that name as soon as NS1 serves it; a wrong answer can take a site or mail offline. Plain records only (A, AAAA, ALIAS, CAA, CNAME, MX, PTR, SRV, TXT; no NS/SOA, no traffic-steering filters or metadata). Refuses when the record already exists (use ns1_update_record). Answers are lists of rdata fields: A ["192.0.2.10"], MX [10, "mail.example.com."], TXT ["v=spf1 -all"], SRV [10, 5, 5060, "sip.example.com."], CAA [0, "issue", "letsencrypt.org"]. PUT /v1/zones/{zone}/{domain}/{type}.

destructive

Argument	Type	Description
ttl	integer	TTL in seconds. Omit for the zone default.
type*	string	Record type.
zone*	string	Zone name, e.g. example.com.
domain*	string	Full record name inside the zone, e.g. www.example.com (or the zone name itself for the apex).
answers*	array	One entry per answer, each a list of rdata fields (see the tool description).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "zone",
    "domain",
    "type",
    "answers"
  ],
  "properties": {
    "ttl": {
      "type": "integer",
      "maximum": 2147483647,
      "minimum": 1,
      "description": "TTL in seconds. Omit for the zone default."
    },
    "type": {
      "enum": [
        "A",
        "AAAA",
        "ALIAS",
        "CAA",
        "CNAME",
        "MX",
        "PTR",
        "SRV",
        "TXT"
      ],
      "type": "string",
      "description": "Record type."
    },
    "zone": {
      "type": "string",
      "maxLength": 254,
      "minLength": 1,
      "description": "Zone name, e.g. example.com."
    },
    "domain": {
      "type": "string",
      "maxLength": 254,
      "minLength": 1,
      "description": "Full record name inside the zone, e.g. www.example.com (or the zone name itself for the apex)."
    },
    "answers": {
      "type": "array",
      "items": {
        "type": "array",
        "items": {
          "anyOf": [
            {
              "type": "string",
              "maxLength": 4000
            },
            {
              "type": "number"
            }
          ]
        },
        "maxItems": 8,
        "minItems": 1
      },
      "maxItems": 20,
      "minItems": 1,
      "description": "One entry per answer, each a list of rdata fields (see the tool description)."
    }
  }
}

ns1_get_account_summary

The account's subscription, resources and utilization (queries, records, filter chains, monitors, ... against the plan limits). GET /v1/account/summary.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

ns1_get_billing_queries

Billable DNS query usage between two Unix timestamps. GET /billing-usage/v1/queries?from=&to=.

read-only

Argument	Type	Description
to*	integer	End, Unix seconds.
from*	integer	Start, Unix seconds.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "from",
    "to"
  ],
  "properties": {
    "to": {
      "type": "integer",
      "maximum": 4102444800,
      "minimum": 0,
      "description": "End, Unix seconds."
    },
    "from": {
      "type": "integer",
      "maximum": 4102444800,
      "minimum": 0,
      "description": "Start, Unix seconds."
    }
  }
}

ns1_get_billing_records

How many DNS records the account uses against its plan limit in the current billing cycle. GET /billing-usage/v1/records.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

ns1_get_data_feed

One data feed of a source by id. GET /v1/data/feeds/{source_id}/{feed_id}.

read-only

Argument	Type	Description
feed_id*	string	Data feed id.
source_id*	string	Data source id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "source_id",
    "feed_id"
  ],
  "properties": {
    "feed_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]+$",
      "maxLength": 100,
      "minLength": 1,
      "description": "Data feed id."
    },
    "source_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]+$",
      "maxLength": 100,
      "minLength": 1,
      "description": "Data source id."
    }
  }
}

ns1_get_data_source

One data source by id with its feeds. Connection settings and credentials are redacted. GET /v1/data/sources/{id}.

read-only

Argument	Type	Description
source_id*	string	Data source id (from ns1_list_data_sources).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "source_id"
  ],
  "properties": {
    "source_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]+$",
      "maxLength": 100,
      "minLength": 1,
      "description": "Data source id (from ns1_list_data_sources)."
    }
  }
}

ns1_get_monitoring_job

One monitoring job by id with its configuration, rules, regions and status. Header values and credentials are redacted. GET /v1/monitoring/jobs/{id}.

read-only

Argument	Type	Description
job_id*	string	Monitoring job id (from ns1_list_monitoring_jobs).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "job_id"
  ],
  "properties": {
    "job_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]+$",
      "maxLength": 100,
      "minLength": 1,
      "description": "Monitoring job id (from ns1_list_monitoring_jobs)."
    }
  }
}

ns1_get_qps_stats

Current queries per second for the whole account, one zone, or one record (give zone, or zone + domain + type). GET /v1/stats/qps[/{zone}[/{domain}/{type}]].

read-only

Argument	Type	Description
type	string	Record type, e.g. A, AAAA, CNAME, MX, TXT.
zone	string	Zone name, e.g. example.com.
domain	string	Full record name inside the zone, e.g. www.example.com (or the zone name itself for the apex).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "type": {
      "type": "string",
      "pattern": "^[A-Z0-9]{1,12}$",
      "description": "Record type, e.g. A, AAAA, CNAME, MX, TXT."
    },
    "zone": {
      "type": "string",
      "maxLength": 254,
      "minLength": 1,
      "description": "Zone name, e.g. example.com."
    },
    "domain": {
      "type": "string",
      "maxLength": 254,
      "minLength": 1,
      "description": "Full record name inside the zone, e.g. www.example.com (or the zone name itself for the apex)."
    }
  }
}

ns1_get_record

One DNS record by zone, domain and type: TTL, answers (with per-answer metadata), filter chain (traffic steering), linked record and region settings. GET /v1/zones/{zone}/{domain}/{type}.

read-only

Argument	Type	Description
type*	string	Record type, e.g. A, AAAA, CNAME, MX, TXT.
zone*	string	Zone name, e.g. example.com.
domain*	string	Full record name inside the zone, e.g. www.example.com (or the zone name itself for the apex).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "zone",
    "domain",
    "type"
  ],
  "properties": {
    "type": {
      "type": "string",
      "pattern": "^[A-Z0-9]{1,12}$",
      "description": "Record type, e.g. A, AAAA, CNAME, MX, TXT."
    },
    "zone": {
      "type": "string",
      "maxLength": 254,
      "minLength": 1,
      "description": "Zone name, e.g. example.com."
    },
    "domain": {
      "type": "string",
      "maxLength": 254,
      "minLength": 1,
      "description": "Full record name inside the zone, e.g. www.example.com (or the zone name itself for the apex)."
    }
  }
}

ns1_get_usage_stats

DNS query counts for the whole account, one zone, or one record (give zone, or zone + domain + type). period is 1h, 24h or 30d; aggregate, expand, limit and after apply to the account and zone levels only (a record takes just period). If next_page is not null, call again with its after/limit. GET /v1/stats/usage[/{zone}[/{domain}/{type}]].

read-only

Argument	Type	Description
type	string	Record type, e.g. A, AAAA, CNAME, MX, TXT.
zone	string	Zone name, e.g. example.com.
after	string	Continue after this item: pass next_page.after from the previous reply.
limit	integer	Maximum items per page, 1-1000. Omit for NS1's default page size.
domain	string	Full record name inside the zone, e.g. www.example.com (or the zone name itself for the apex).
expand	boolean	Break the counts down further. Account and zone level only.
period	string	Time window: 1h, 24h or 30d. Omit for the API default.
aggregate	boolean	Sum the counts over the period.

ns1_get_zone

One zone with its settings and its record list (each record: domain, type, TTL, short answers, linked/tier info). Large zones are paged: if next_page is not null, call again with its after/offset to get the next records. TSIG secrets are redacted. GET /v1/zones/{zone}.

read-only

Argument	Type	Description
zone*	string	Zone name, e.g. example.com.
after	string	Continue after this item: pass next_page.after from the previous reply.
limit	integer	Maximum items per page, 1-1000. Omit for NS1's default page size.
offset	integer	Skip this many items: pass next_page.offset from the previous reply.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "zone"
  ],
  "properties": {
    "zone": {
      "type": "string",
      "maxLength": 254,
      "minLength": 1,
      "description": "Zone name, e.g. example.com."
    },
    "after": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Continue after this item: pass next_page.after from the previous reply."
    },
    "limit": {
      "type": "integer",
      "maximum": 1000,
      "description": "Maximum items per page, 1-1000. Omit for NS1's default page size.",
      "exclusiveMinimum": 0
    },
    "offset": {
      "type": "integer",
      "maximum": 10000000,
      "minimum": 0,
      "description": "Skip this many items: pass next_page.offset from the previous reply."
    }
  }
}

ns1_list_data_feeds

List the feeds of one data source (each feed is one monitored item, e.g. one server's health) with id, name and settings. GET /v1/data/feeds/{source_id}.

read-only

Argument	Type	Description
source_id*	string	Data source id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "source_id"
  ],
  "properties": {
    "source_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]+$",
      "maxLength": 100,
      "minLength": 1,
      "description": "Data source id."
    }
  }
}

ns1_list_data_sources

List the data sources (connections to third-party monitoring or custom push sources used for traffic steering): id, name, source type, status and their feeds. Connection settings and credentials are redacted. GET /v1/data/sources.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

ns1_list_monitoring_jobs

List the account's NS1 monitoring jobs (health checks that feed traffic steering): id, name, type, regions, frequency, rules, current status, active flag and notify list id. Request header values and credentials are redacted. GET /v1/monitoring/jobs.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

ns1_list_notify_lists

List the notifier lists that monitoring alerts are sent to: id, name and the notifier types and labels (email, Slack, PagerDuty, webhook). Notifier settings (webhook URLs, tokens, service keys, addresses) are redacted. GET /v1/lists.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

ns1_list_zones

List the DNS zones in the account: name, id, TTL/SOA settings, primary/secondary setup, linked zones and tags. If next_page is not null, call again with its after/offset to get more. GET /v1/zones.

read-only

Argument	Type	Description
after	string	Continue after this item: pass next_page.after from the previous reply.
limit	integer	Maximum items per page, 1-1000. Omit for NS1's default page size.
offset	integer	Skip this many items: pass next_page.offset from the previous reply.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "after": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Continue after this item: pass next_page.after from the previous reply."
    },
    "limit": {
      "type": "integer",
      "maximum": 1000,
      "description": "Maximum items per page, 1-1000. Omit for NS1's default page size.",
      "exclusiveMinimum": 0
    },
    "offset": {
      "type": "integer",
      "maximum": 10000000,
      "minimum": 0,
      "description": "Skip this many items: pass next_page.offset from the previous reply."
    }
  }
}

ns1_search

Search the account's zones and records by name (substring match). Returns matching zones and/or records with their answers when expand is true. GET /v1/search.

read-only

Argument	Type	Description
max	integer	Maximum results, 1-1000.
type	string	What to search (default all).
query*	string	Text to look for in zone and record names (at least 2 characters).
expand	boolean	Include full record details (default true).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "query"
  ],
  "properties": {
    "max": {
      "type": "integer",
      "maximum": 1000,
      "description": "Maximum results, 1-1000.",
      "exclusiveMinimum": 0
    },
    "type": {
      "enum": [
        "all",
        "zone",
        "record"
      ],
      "type": "string",
      "description": "What to search (default all)."
    },
    "query": {
      "type": "string",
      "maxLength": 500,
      "minLength": 2,
      "description": "Text to look for in zone and record names (at least 2 characters)."
    },
    "expand": {
      "type": "boolean",
      "description": "Include full record details (default true)."
    }
  }
}

ns1_update_record

WRITE: changes ONE existing DNS record and CHANGES LIVE DNS for that name immediately. Giving answers REPLACES all current answers of the record (send the complete new set); giving only ttl changes just the TTL. Plain records only (A, AAAA, ALIAS, CAA, CNAME, MX, PTR, SRV, TXT): when answers are given, a record that uses traffic-steering filters, links or per-answer metadata is refused (edit it in the NS1 portal). Fails if the record does not exist. POST /v1/zones/{zone}/{domain}/{type}.

destructive

Argument	Type	Description
ttl	integer	New TTL in seconds.
type*	string	Record type of the existing record.
zone*	string	Zone name, e.g. example.com.
domain*	string	Full record name inside the zone, e.g. www.example.com (or the zone name itself for the apex).
answers	array	The COMPLETE new answer set, each answer a list of rdata fields (as for ns1_create_record).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "zone",
    "domain",
    "type"
  ],
  "properties": {
    "ttl": {
      "type": "integer",
      "maximum": 2147483647,
      "minimum": 1,
      "description": "New TTL in seconds."
    },
    "type": {
      "enum": [
        "A",
        "AAAA",
        "ALIAS",
        "CAA",
        "CNAME",
        "MX",
        "PTR",
        "SRV",
        "TXT"
      ],
      "type": "string",
      "description": "Record type of the existing record."
    },
    "zone": {
      "type": "string",
      "maxLength": 254,
      "minLength": 1,
      "description": "Zone name, e.g. example.com."
    },
    "domain": {
      "type": "string",
      "maxLength": 254,
      "minLength": 1,
      "description": "Full record name inside the zone, e.g. www.example.com (or the zone name itself for the apex)."
    },
    "answers": {
      "type": "array",
      "items": {
        "type": "array",
        "items": {
          "anyOf": [
            {
              "type": "string",
              "maxLength": 4000
            },
            {
              "type": "number"
            }
          ]
        },
        "maxItems": 8,
        "minItems": 1
      },
      "maxItems": 20,
      "minItems": 1,
      "description": "The COMPLETE new answer set, each answer a list of rdata fields (as for ns1_create_record)."
    }
  }
}

NS1 Connect MCP by usefulapi

Try it

ns1_create_record Destructive

NS1 Connect MCP by usefulapi

Try it

ns1_create_record Destructive

Tools (18)