Register, transfer and renew domains, host DNS for external domains, edit DNS records, connect websites and manage SSL certificates.
A domains resource is a resource with kind domains. It holds domains registered here (auto-renewing) and external domains whose DNS is hosted on our nameservers (hosted, paid plans). Each domain has DNS records, contacts and certificates. Use folders to organize domains.
Registrations, transfers, renewals and paid certificates are charged immediately to the organization’s billing card, at the quoted price passed as price_cents. If the price has changed, the call fails without charging. Failed registrations and transfers are refunded. Domains need only the billing card, on any plan; paid certificates require a paid plan.
Set the registrant with domain_save_contact before registering. Domains registered here get a transfer lock, WHOIS privacy, our DNS, and a free auto-renewing Let’s Encrypt certificate for the domain and its www subdomain.
A DNS record’s id is <domain>/<id>. Updates replace the whole record and fail if the record changed since it was read. Records the app maintains are marked managed. Editing or deleting a website’s record disconnects that address from the website. Certificate validation records are changed only through their certificate.
The examples use the callTool helper. To connect, see the Quickstart or Authentication.
Domains
A limited agent can make only the changes its permissions allow. Read-only access allows no changes. See Access and permissions.
| Domains | Allows |
|---|---|
buy | Register, transfer in and renew domains, and order certificates. Spends money. |
dns | Add, change and delete DNS records, import zones, set up mail and connect websites. |
manage | Change auto-renew, locks, privacy, contacts, nameservers, transfer codes and certificate choice. Host external domains and manage folders. |
keys | Download certificate private keys. |
Domains
These limits apply alongside the general limits.
| What | Limit |
|---|---|
| Domains | 100 per resource |
| DNS records | 200 per domain, with values up to 1,000 characters |
| Host names | 253 characters |
| Nameservers | 2–13 per domain |
| Zone files | 200 KB |
| Certificates | 100 per resource |
| Registration and renewal | 1–10 years, up to 10 years ahead |
Tools · Domains
Returns the domains, folders, registration contacts and certificates in a domains resource, plus the price of a paid certificate.
project_id string Requiredspace_id string Requiredlist_spaces.An object with domains (as returned by domain_get, without records, contacts or certificates), folders (id, name, parent_id), contacts (see domain_save_contact), certificates (as returned by domain_get) and certificate_cents.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "domain_list",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "2b7e5c1a9f3d40e8b6c2a7f1e9d3b5c8"
}
}
}'{
"domains": [
{
"domain": "example.com",
"status": "active",
"registered_at": "2026-09-30T23:46:04.540Z",
"expires_at": "2027-09-30T23:46:04.540Z",
"auto_renew": true,
"locked": true,
"privacy": true,
"nameservers": [
"ns1.systemdns.com",
"ns2.systemdns.com",
"ns3.systemdns.com"
],
"custom_nameservers": false,
"error": "",
"folder_id": null,
"position": "",
"created_at": "2026-09-30T23:46:04.540Z",
"hosted": false,
"moved_at": null,
"certificate_choice": "letsencrypt",
"certificate_id": null,
"verification": null
}
],
"folders": [],
"contacts": {
"owner": {
"own": true,
"contact": {
"first_name": "Alex",
"last_name": "Rivera",
"org_name": "Launch Co",
"address1": "1 Main St",
"address2": "",
"city": "Raleigh",
"state": "NC",
"postal_code": "27601",
"country": "US",
"phone": "+1.9195550123",
"email": "you@example.com"
}
},
"admin": {
"own": false,
"contact": {
"first_name": "Alex",
"last_name": "Rivera",
"org_name": "Launch Co",
"address1": "1 Main St",
"address2": "",
"city": "Raleigh",
"state": "NC",
"postal_code": "27601",
"country": "US",
"phone": "+1.9195550123",
"email": "you@example.com"
}
},
"tech": {
"own": false,
"contact": {
"first_name": "Alex",
"last_name": "Rivera",
"org_name": "Launch Co",
"address1": "1 Main St",
"address2": "",
"city": "Raleigh",
"state": "NC",
"postal_code": "27601",
"country": "US",
"phone": "+1.9195550123",
"email": "you@example.com"
}
},
"billing": {
"own": false,
"contact": {
"first_name": "Alex",
"last_name": "Rivera",
"org_name": "Launch Co",
"address1": "1 Main St",
"address2": "",
"city": "Raleigh",
"state": "NC",
"postal_code": "27601",
"country": "US",
"phone": "+1.9195550123",
"email": "you@example.com"
}
}
},
"certificates": [
{
"id": "4d8b2f6a0c9e47b1a3f5d7e9c2b4a6f8",
"domain": "example.com",
"sans": [
"www.example.com"
],
"status": "issued",
"authority": "letsencrypt",
"renewing": false,
"validation": "_acme-challenge.example.com. TXT \"Gm7xUq0iV3k…\"\n_acme-challenge.www.example.com. TXT \"pX2dR9bLw4c…\"",
"issued_at": "2026-09-30T23:46:04.545Z",
"expires_at": "2026-12-29T23:46:04.545Z",
"error": "",
"created_at": "2026-09-30T23:46:04.541Z"
}
],
"certificate_cents": 1099
}Tools · Domains
Returns a domain with its contacts, DNS records and certificates.
project_id string Requiredspace_id string Requiredlist_spaces.domain string Requiredexample.com.The domain with its contacts, records and certificates. status is registering, transferring, active, expired, failed or transferred. For hosted domains, it is verifying, delegating (until the domain uses our nameservers), active or moved. Other fields include registered_at, expires_at, auto_renew, locked, privacy, nameservers, folder_id, certificate_choice and certificate_id. custom_nameservers is set for external nameservers, which means records here aren’t served. verification contains a hosted domain’s TXT record name and value. error describes a registration or renewal failure. Each contact role is either own or follows the resource’s contact. Each record has id, type, relative name, value, priority, weight, port and managed (website:<id> or certificate:<id> for records the app maintains). Certificates omit PEM.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "domain_get",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "2b7e5c1a9f3d40e8b6c2a7f1e9d3b5c8",
"domain": "example.com"
}
}
}'{
"domain": "example.com",
"status": "active",
"registered_at": "2026-09-30T23:46:04.540Z",
"expires_at": "2027-09-30T23:46:04.540Z",
"auto_renew": true,
"locked": true,
"privacy": true,
"nameservers": [
"ns1.systemdns.com",
"ns2.systemdns.com",
"ns3.systemdns.com"
],
"custom_nameservers": false,
"error": "",
"folder_id": null,
"position": "",
"created_at": "2026-09-30T23:46:04.540Z",
"hosted": false,
"moved_at": null,
"certificate_choice": "letsencrypt",
"certificate_id": null,
"verification": null,
"contacts": {
"owner": {
"own": false,
"contact": {
"first_name": "Alex",
"last_name": "Rivera",
"org_name": "Launch Co",
"address1": "1 Main St",
"address2": "",
"city": "Raleigh",
"state": "NC",
"postal_code": "27601",
"country": "US",
"phone": "+1.9195550123",
"email": "you@example.com"
}
},
"admin": {
"own": false,
"contact": {
"first_name": "Alex",
"last_name": "Rivera",
"org_name": "Launch Co",
"address1": "1 Main St",
"address2": "",
"city": "Raleigh",
"state": "NC",
"postal_code": "27601",
"country": "US",
"phone": "+1.9195550123",
"email": "you@example.com"
}
},
"tech": {
"own": false,
"contact": {
"first_name": "Alex",
"last_name": "Rivera",
"org_name": "Launch Co",
"address1": "1 Main St",
"address2": "",
"city": "Raleigh",
"state": "NC",
"postal_code": "27601",
"country": "US",
"phone": "+1.9195550123",
"email": "you@example.com"
}
},
"billing": {
"own": false,
"contact": {
"first_name": "Alex",
"last_name": "Rivera",
"org_name": "Launch Co",
"address1": "1 Main St",
"address2": "",
"city": "Raleigh",
"state": "NC",
"postal_code": "27601",
"country": "US",
"phone": "+1.9195550123",
"email": "you@example.com"
}
}
},
"records": [
{
"id": "example.com/6f2a9c4e1b7d43a5e8c0f2b6d9a1e3c7",
"domain": "example.com",
"type": "A",
"name": "app",
"value": "203.0.113.10",
"priority": null,
"weight": null,
"port": null,
"managed": null
},
{
"id": "example.com/c1e7a3f9b5d248c6a0e4f8b2d6c1a9e5",
"domain": "example.com",
"type": "CNAME",
"name": "www",
"value": "7f3e9a1c5b2d48e6a0c4f8b2d6e1a3c5.tensorsites.net",
"priority": null,
"weight": null,
"port": null,
"managed": "website:7f3e9a1c5b2d48e6a0c4f8b2d6e1a3c5"
}
],
"certificates": [
{
"id": "4d8b2f6a0c9e47b1a3f5d7e9c2b4a6f8",
"domain": "example.com",
"sans": [
"www.example.com"
],
"status": "issued",
"authority": "letsencrypt",
"renewing": false,
"validation": "_acme-challenge.example.com. TXT \"Gm7xUq0iV3k…\"\n_acme-challenge.www.example.com. TXT \"pX2dR9bLw4c…\"",
"issued_at": "2026-09-30T23:46:04.545Z",
"expires_at": "2026-12-29T23:46:04.545Z",
"error": "",
"created_at": "2026-09-30T23:46:04.541Z"
}
]
}Tools · Domains
Searches for domains to register across common TLDs (.com, .net, .org, .io, .dev, .app, .co, plus any TLD in the query), with suggestions. A full URL, such as https://www.example.com/about, searches for its domain.
project_id string Requiredspace_id string Requiredlist_spaces.query string Requiredexample) or domain (example.com).years integer Up to 24 domains, each with status (available, taken, held if already held here, or undetermined), cents (the price for the requested years, if available) and premium.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "domain_search",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "2b7e5c1a9f3d40e8b6c2a7f1e9d3b5c8",
"query": "example"
}
}
}'[
{
"domain": "example.com",
"status": "available",
"cents": 1599,
"premium": false
},
{
"domain": "example.io",
"status": "available",
"cents": 5999,
"premium": false
},
{
"domain": "example.net",
"status": "taken",
"cents": null,
"premium": false
}
]Tools · Domains
Registers an available domain with a transfer lock and our DNS, using the resource’s contacts. Set the contacts first with domain_save_contact. The organization’s billing card is charged first and refunded if the registrar refuses the registration. The domain auto-renews a month before it expires unless auto_renew is off, and gets a free certificate for the domain and its www subdomain. Domains need only the billing card, on any plan.
project_id string Requiredspace_id string Requiredlist_spaces.domain string Requiredexample.com.years integer Requiredprice_cents integer Requireddomain_search. The call fails without charging if the price has changed.privacy boolean The domain, as returned by domain_get.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "domain_register",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "2b7e5c1a9f3d40e8b6c2a7f1e9d3b5c8",
"domain": "example.com",
"years": 1,
"price_cents": 1599
}
}
}'{
"domain": "example.com",
"status": "active",
"registered_at": "2026-09-30T23:46:04.540Z",
"expires_at": "2027-09-30T23:46:04.540Z",
"auto_renew": true,
"locked": true,
"privacy": true,
"nameservers": [
"ns1.systemdns.com",
"ns2.systemdns.com",
"ns3.systemdns.com"
],
"custom_nameservers": false,
"error": "",
"folder_id": null,
"position": "",
"created_at": "2026-09-30T23:46:04.540Z",
"hosted": false,
"moved_at": null,
"certificate_choice": "letsencrypt",
"certificate_id": null,
"verification": null,
"contacts": {
"owner": {
"own": false,
"contact": {
"first_name": "Alex",
"last_name": "Rivera",
"org_name": "Launch Co",
"address1": "1 Main St",
"address2": "",
"city": "Raleigh",
"state": "NC",
"postal_code": "27601",
"country": "US",
"phone": "+1.9195550123",
"email": "you@example.com"
}
},
"admin": {
"own": false,
"contact": {
"first_name": "Alex",
"last_name": "Rivera",
"org_name": "Launch Co",
"address1": "1 Main St",
"address2": "",
"city": "Raleigh",
"state": "NC",
"postal_code": "27601",
"country": "US",
"phone": "+1.9195550123",
"email": "you@example.com"
}
},
"tech": {
"own": false,
"contact": {
"first_name": "Alex",
"last_name": "Rivera",
"org_name": "Launch Co",
"address1": "1 Main St",
"address2": "",
"city": "Raleigh",
"state": "NC",
"postal_code": "27601",
"country": "US",
"phone": "+1.9195550123",
"email": "you@example.com"
}
},
"billing": {
"own": false,
"contact": {
"first_name": "Alex",
"last_name": "Rivera",
"org_name": "Launch Co",
"address1": "1 Main St",
"address2": "",
"city": "Raleigh",
"state": "NC",
"postal_code": "27601",
"country": "US",
"phone": "+1.9195550123",
"email": "you@example.com"
}
}
},
"records": [],
"certificates": [
{
"id": "4d8b2f6a0c9e47b1a3f5d7e9c2b4a6f8",
"domain": "example.com",
"sans": [
"www.example.com"
],
"status": "pending",
"authority": "letsencrypt",
"renewing": false,
"validation": "_acme-challenge.example.com. TXT \"Gm7xUq0iV3k…\"\n_acme-challenge.www.example.com. TXT \"pX2dR9bLw4c…\"",
"issued_at": null,
"expires_at": null,
"error": "",
"created_at": "2026-09-30T23:46:04.541Z"
}
]
}Tools · Domains
Checks that an external domain can be transferred here and returns the transfer price, which includes a one-year renewal. The domain must be registered, unlocked at its current registrar and not already here.
project_id string Requiredspace_id string Requiredlist_spaces.domain string Requiredexample.com.The domain and the transfer price in cents.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "domain_quote_transfer",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "2b7e5c1a9f3d40e8b6c2a7f1e9d3b5c8",
"domain": "example.org"
}
}
}'{
"domain": "example.org",
"cents": 1799
}Tools · Domains
Transfers an external domain here using the transfer code from its current registrar. The organization’s billing card is charged first and refunded if the transfer is refused or doesn’t complete. The domain keeps its current nameservers, so nothing it serves changes. Its status is transferring until the registry completes the transfer, usually within five days. Then call domain_set_nameservers with null to serve its records here.
project_id string Requiredspace_id string Requiredlist_spaces.domain string Requiredexample.com.code string Requiredprice_cents integer Requireddomain_quote_transfer. The call fails without charging if the price has changed.privacy boolean The domain, as returned by domain_get.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "domain_transfer",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "2b7e5c1a9f3d40e8b6c2a7f1e9d3b5c8",
"domain": "example.org",
"code": "Xq7#pL2v",
"price_cents": 1799
}
}
}'{
"domain": "example.org",
"status": "transferring",
"registered_at": null,
"expires_at": null,
"auto_renew": true,
"locked": false,
"privacy": true,
"nameservers": [
"ns1.otherhost.net",
"ns2.otherhost.net"
],
"custom_nameservers": false,
"error": "",
"folder_id": null,
"position": "",
"created_at": "2026-09-30T23:46:04.540Z",
"hosted": false,
"moved_at": null,
"certificate_choice": "letsencrypt",
"certificate_id": null,
"verification": null,
"contacts": {
"owner": {
"own": false,
"contact": {
"first_name": "Alex",
"last_name": "Rivera",
"org_name": "Launch Co",
"address1": "1 Main St",
"address2": "",
"city": "Raleigh",
"state": "NC",
"postal_code": "27601",
"country": "US",
"phone": "+1.9195550123",
"email": "you@example.com"
}
},
"admin": {
"own": false,
"contact": {
"first_name": "Alex",
"last_name": "Rivera",
"org_name": "Launch Co",
"address1": "1 Main St",
"address2": "",
"city": "Raleigh",
"state": "NC",
"postal_code": "27601",
"country": "US",
"phone": "+1.9195550123",
"email": "you@example.com"
}
},
"tech": {
"own": false,
"contact": {
"first_name": "Alex",
"last_name": "Rivera",
"org_name": "Launch Co",
"address1": "1 Main St",
"address2": "",
"city": "Raleigh",
"state": "NC",
"postal_code": "27601",
"country": "US",
"phone": "+1.9195550123",
"email": "you@example.com"
}
},
"billing": {
"own": false,
"contact": {
"first_name": "Alex",
"last_name": "Rivera",
"org_name": "Launch Co",
"address1": "1 Main St",
"address2": "",
"city": "Raleigh",
"state": "NC",
"postal_code": "27601",
"country": "US",
"phone": "+1.9195550123",
"email": "you@example.com"
}
}
},
"records": [],
"certificates": []
}Tools · Domains
Returns the price to renew a domain registered here. A registration can’t extend more than ten years ahead.
project_id string Requiredspace_id string Requiredlist_spaces.domain string Requiredexample.com.years integer RequiredThe domain, the number of years and the price in cents.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "domain_quote_renewal",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "2b7e5c1a9f3d40e8b6c2a7f1e9d3b5c8",
"domain": "example.com",
"years": 2
}
}
}'{
"domain": "example.com",
"years": 2,
"cents": 3198
}Tools · Domains
Renews a domain registered here. The organization’s billing card is charged first and refunded if the registrar refuses the renewal. Only one renewal per domain can run at a time.
project_id string Requiredspace_id string Requiredlist_spaces.domain string Requiredexample.com.years integer Requiredprice_cents integer Requireddomain_quote_renewal. The call fails without charging if the price has changed.The domain, as returned by domain_get, with the new expires_at.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "domain_renew",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "2b7e5c1a9f3d40e8b6c2a7f1e9d3b5c8",
"domain": "example.com",
"years": 2,
"price_cents": 3198
}
}
}'{
"domain": "example.com",
"status": "active",
"registered_at": "2026-09-30T23:46:04.540Z",
"expires_at": "2029-09-30T23:46:04.540Z",
"auto_renew": true,
"locked": true,
"privacy": true,
"nameservers": [
"ns1.systemdns.com",
"ns2.systemdns.com",
"ns3.systemdns.com"
],
"custom_nameservers": false,
"error": "",
"folder_id": null,
"position": "",
"created_at": "2026-09-30T23:46:04.540Z",
"hosted": false,
"moved_at": null,
"certificate_choice": "letsencrypt",
"certificate_id": null,
"verification": null,
"contacts": {
"owner": {
"own": false,
"contact": {
"first_name": "Alex",
"last_name": "Rivera",
"org_name": "Launch Co",
"address1": "1 Main St",
"address2": "",
"city": "Raleigh",
"state": "NC",
"postal_code": "27601",
"country": "US",
"phone": "+1.9195550123",
"email": "you@example.com"
}
},
"admin": {
"own": false,
"contact": {
"first_name": "Alex",
"last_name": "Rivera",
"org_name": "Launch Co",
"address1": "1 Main St",
"address2": "",
"city": "Raleigh",
"state": "NC",
"postal_code": "27601",
"country": "US",
"phone": "+1.9195550123",
"email": "you@example.com"
}
},
"tech": {
"own": false,
"contact": {
"first_name": "Alex",
"last_name": "Rivera",
"org_name": "Launch Co",
"address1": "1 Main St",
"address2": "",
"city": "Raleigh",
"state": "NC",
"postal_code": "27601",
"country": "US",
"phone": "+1.9195550123",
"email": "you@example.com"
}
},
"billing": {
"own": false,
"contact": {
"first_name": "Alex",
"last_name": "Rivera",
"org_name": "Launch Co",
"address1": "1 Main St",
"address2": "",
"city": "Raleigh",
"state": "NC",
"postal_code": "27601",
"country": "US",
"phone": "+1.9195550123",
"email": "you@example.com"
}
}
},
"records": [
{
"id": "example.com/6f2a9c4e1b7d43a5e8c0f2b6d9a1e3c7",
"domain": "example.com",
"type": "A",
"name": "app",
"value": "203.0.113.10",
"priority": null,
"weight": null,
"port": null,
"managed": null
},
{
"id": "example.com/c1e7a3f9b5d248c6a0e4f8b2d6c1a9e5",
"domain": "example.com",
"type": "CNAME",
"name": "www",
"value": "7f3e9a1c5b2d48e6a0c4f8b2d6e1a3c5.tensorsites.net",
"priority": null,
"weight": null,
"port": null,
"managed": "website:7f3e9a1c5b2d48e6a0c4f8b2d6e1a3c5"
}
],
"certificates": [
{
"id": "4d8b2f6a0c9e47b1a3f5d7e9c2b4a6f8",
"domain": "example.com",
"sans": [
"www.example.com"
],
"status": "issued",
"authority": "letsencrypt",
"renewing": false,
"validation": "_acme-challenge.example.com. TXT \"Gm7xUq0iV3k…\"\n_acme-challenge.www.example.com. TXT \"pX2dR9bLw4c…\"",
"issued_at": "2026-09-30T23:46:04.545Z",
"expires_at": "2026-12-29T23:46:04.545Z",
"error": "",
"created_at": "2026-09-30T23:46:04.541Z"
}
]
}Tools · Domains
Updates a domain’s settings. Omitted fields are unchanged. For external domains, the transfer lock and WHOIS privacy are managed at the domain’s registrar.
project_id string Requiredspace_id string Requiredlist_spaces.domain string Requiredexample.com.auto_renew boolean locked boolean privacy boolean The domain, as returned by domain_get.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "domain_update",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "2b7e5c1a9f3d40e8b6c2a7f1e9d3b5c8",
"domain": "example.com",
"auto_renew": false
}
}
}'{
"domain": "example.com",
"status": "active",
"registered_at": "2026-09-30T23:46:04.540Z",
"expires_at": "2027-09-30T23:46:04.540Z",
"auto_renew": false,
"locked": true,
"privacy": true,
"nameservers": [
"ns1.systemdns.com",
"ns2.systemdns.com",
"ns3.systemdns.com"
],
"custom_nameservers": false,
"error": "",
"folder_id": null,
"position": "",
"created_at": "2026-09-30T23:46:04.540Z",
"hosted": false,
"moved_at": null,
"certificate_choice": "letsencrypt",
"certificate_id": null,
"verification": null,
"contacts": {
"owner": {
"own": false,
"contact": {
"first_name": "Alex",
"last_name": "Rivera",
"org_name": "Launch Co",
"address1": "1 Main St",
"address2": "",
"city": "Raleigh",
"state": "NC",
"postal_code": "27601",
"country": "US",
"phone": "+1.9195550123",
"email": "you@example.com"
}
},
"admin": {
"own": false,
"contact": {
"first_name": "Alex",
"last_name": "Rivera",
"org_name": "Launch Co",
"address1": "1 Main St",
"address2": "",
"city": "Raleigh",
"state": "NC",
"postal_code": "27601",
"country": "US",
"phone": "+1.9195550123",
"email": "you@example.com"
}
},
"tech": {
"own": false,
"contact": {
"first_name": "Alex",
"last_name": "Rivera",
"org_name": "Launch Co",
"address1": "1 Main St",
"address2": "",
"city": "Raleigh",
"state": "NC",
"postal_code": "27601",
"country": "US",
"phone": "+1.9195550123",
"email": "you@example.com"
}
},
"billing": {
"own": false,
"contact": {
"first_name": "Alex",
"last_name": "Rivera",
"org_name": "Launch Co",
"address1": "1 Main St",
"address2": "",
"city": "Raleigh",
"state": "NC",
"postal_code": "27601",
"country": "US",
"phone": "+1.9195550123",
"email": "you@example.com"
}
}
},
"records": [
{
"id": "example.com/6f2a9c4e1b7d43a5e8c0f2b6d9a1e3c7",
"domain": "example.com",
"type": "A",
"name": "app",
"value": "203.0.113.10",
"priority": null,
"weight": null,
"port": null,
"managed": null
},
{
"id": "example.com/c1e7a3f9b5d248c6a0e4f8b2d6c1a9e5",
"domain": "example.com",
"type": "CNAME",
"name": "www",
"value": "7f3e9a1c5b2d48e6a0c4f8b2d6e1a3c5.tensorsites.net",
"priority": null,
"weight": null,
"port": null,
"managed": "website:7f3e9a1c5b2d48e6a0c4f8b2d6e1a3c5"
}
],
"certificates": [
{
"id": "4d8b2f6a0c9e47b1a3f5d7e9c2b4a6f8",
"domain": "example.com",
"sans": [
"www.example.com"
],
"status": "issued",
"authority": "letsencrypt",
"renewing": false,
"validation": "_acme-challenge.example.com. TXT \"Gm7xUq0iV3k…\"\n_acme-challenge.www.example.com. TXT \"pX2dR9bLw4c…\"",
"issued_at": "2026-09-30T23:46:04.545Z",
"expires_at": "2026-12-29T23:46:04.545Z",
"error": "",
"created_at": "2026-09-30T23:46:04.541Z"
}
]
}Tools · Domains
Unlocks a domain registered here and generates a new transfer code for another registrar. The code isn’t stored and is returned only once.
project_id string Requiredspace_id string Requiredlist_spaces.domain string Requiredexample.com.The domain, its code, and locked: false.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "domain_get_transfer_code",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "2b7e5c1a9f3d40e8b6c2a7f1e9d3b5c8",
"domain": "example.com"
}
}
}'{
"domain": "example.com",
"code": "Rk4xT9mQx2wLb7Vn",
"locked": false
}Tools · Domains
Removes a domain from the list once it is no longer held, because its registration or transfer failed, it expired, or it was transferred away. Hosted external domains can be removed at any time, and their zone here is deleted immediately.
project_id string Requiredspace_id string Requiredlist_spaces.domain string Requiredexample.com.The removed domain.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "domain_remove",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "2b7e5c1a9f3d40e8b6c2a7f1e9d3b5c8",
"domain": "example.org"
}
}
}'{
"removed": "example.org"
}Tools · Domains
Hosts DNS on our nameservers for a domain registered elsewhere. Requires a paid plan. The domain’s status is verifying until domain_verify_hosted finds the returned TXT record at the domain’s current DNS. Our nameservers are shared, so pointing a domain at them doesn’t prove ownership.
project_id string Requiredspace_id string Requiredlist_spaces.domain string Requiredexample.com.The domain, and the name and value of the TXT record to add at its current DNS.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "domain_add_hosted",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "2b7e5c1a9f3d40e8b6c2a7f1e9d3b5c8",
"domain": "example.net"
}
}
}'{
"domain": "example.net",
"name": "_tensorworks.example.net",
"value": "tensorworks-verify=9c1e7a3f5b2d48e6a0c4f8b2d6e1a3c5"
}Tools · Domains
Verifies a hosted domain by its TXT record and creates its zone here. The zone uses records kept from earlier hosting, or a copy of the current DNS if none were kept. Switching nameservers therefore preserves what the domain serves. The status is then delegating until the domain uses our nameservers (see nameservers in domain_get).
project_id string Requiredspace_id string Requiredlist_spaces.domain string Requiredexample.com.The domain, copied (the number of records copied from its DNS), kept (the number of records kept from earlier hosting) and complete (whether every common name could be queried).
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "domain_verify_hosted",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "2b7e5c1a9f3d40e8b6c2a7f1e9d3b5c8",
"domain": "example.net"
}
}
}'{
"domain": "example.net",
"copied": 6,
"kept": 0,
"complete": true
}Tools · Domains
Checks a hosted domain’s nameservers immediately, instead of waiting for the hourly check. Once all nameservers are ours, the domain becomes active and its records are served. If an active domain stops pointing here, it becomes moved, and its zone is deleted after 30 days.
project_id string Requiredspace_id string Requiredlist_spaces.domain string Requiredexample.com.The status and current nameservers.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "domain_check_hosted",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "2b7e5c1a9f3d40e8b6c2a7f1e9d3b5c8",
"domain": "example.net"
}
}
}'{
"status": "active",
"nameservers": [
"dns1.tensorworks.net",
"dns2.tensorworks.net"
]
}Tools · Domains
Sets the registration contact for one role: registrant (owner), administrative, technical or billing. Without domain, sets the resource’s default contact for future registrations and transfers. Roles other than owner follow the registrant until they are set. With domain, sets that domain’s contact and sends it to the registrar immediately.
project_id string Requiredspace_id string Requiredlist_spaces.role enum Requiredowner (the registrant), admin, tech or billing.contact object | null Requiredfirst_name, last_name, org_name (optional), email, phone (with country code, such as +1 919 555 0123), address1, address2 (optional), city, state (optional), postal_code and country (two-letter code). Pass null to follow the registrant (for the resource) or the resource’s contact (for a domain).domain string The resource’s contacts, or the domain’s if domain is set. Each role is either own or following.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "domain_save_contact",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "2b7e5c1a9f3d40e8b6c2a7f1e9d3b5c8",
"role": "owner",
"contact": {
"first_name": "Alex",
"last_name": "Rivera",
"org_name": "Launch Co",
"email": "you@example.com",
"phone": "+1 919 555 0123",
"address1": "1 Main St",
"city": "Raleigh",
"state": "NC",
"postal_code": "27601",
"country": "US"
}
}
}
}'{
"owner": {
"own": true,
"contact": {
"first_name": "Alex",
"last_name": "Rivera",
"org_name": "Launch Co",
"address1": "1 Main St",
"address2": "",
"city": "Raleigh",
"state": "NC",
"postal_code": "27601",
"country": "US",
"phone": "+1.9195550123",
"email": "you@example.com"
}
},
"admin": {
"own": false,
"contact": {
"first_name": "Alex",
"last_name": "Rivera",
"org_name": "Launch Co",
"address1": "1 Main St",
"address2": "",
"city": "Raleigh",
"state": "NC",
"postal_code": "27601",
"country": "US",
"phone": "+1.9195550123",
"email": "you@example.com"
}
},
"tech": {
"own": false,
"contact": {
"first_name": "Alex",
"last_name": "Rivera",
"org_name": "Launch Co",
"address1": "1 Main St",
"address2": "",
"city": "Raleigh",
"state": "NC",
"postal_code": "27601",
"country": "US",
"phone": "+1.9195550123",
"email": "you@example.com"
}
},
"billing": {
"own": false,
"contact": {
"first_name": "Alex",
"last_name": "Rivera",
"org_name": "Launch Co",
"address1": "1 Main St",
"address2": "",
"city": "Raleigh",
"state": "NC",
"postal_code": "27601",
"country": "US",
"phone": "+1.9195550123",
"email": "you@example.com"
}
}
}Tools · Domains
Creates a domain folder at the top level or inside another folder. If a folder with the same name and parent already exists, returns that folder.
project_id string Requiredspace_id string Requiredlist_spaces.name string Requiredparent_id string | null The folder, with id, name, parent_id and created_at.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "domain_create_folder",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "2b7e5c1a9f3d40e8b6c2a7f1e9d3b5c8",
"name": "Clients"
}
}
}'{
"id": "e9c3a7f1b5d24e8a6c0b4f2d8e6a1c3b",
"name": "Clients",
"parent_id": null,
"created_at": "2026-09-30T23:46:04.700Z"
}Tools · Domains
Deletes a domain folder. Its domains and subfolders move to its parent.
project_id string Requiredspace_id string Requiredlist_spaces.folder_id string RequiredThe deleted folder’s id.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "domain_delete_folder",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "2b7e5c1a9f3d40e8b6c2a7f1e9d3b5c8",
"folder_id": "e9c3a7f1b5d24e8a6c0b4f2d8e6a1c3b"
}
}
}'{
"deleted": "e9c3a7f1b5d24e8a6c0b4f2d8e6a1c3b"
}Tools · Domains
Moves a domain to the end of a folder, or to the top level.
project_id string Requiredspace_id string Requiredlist_spaces.domain string Requiredexample.com.folder_id string | null RequiredThe domain, as returned by domain_list.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "domain_move",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "2b7e5c1a9f3d40e8b6c2a7f1e9d3b5c8",
"domain": "example.com",
"folder_id": "e9c3a7f1b5d24e8a6c0b4f2d8e6a1c3b"
}
}
}'{
"domain": "example.com",
"status": "active",
"registered_at": "2026-09-30T23:46:04.540Z",
"expires_at": "2027-09-30T23:46:04.540Z",
"auto_renew": true,
"locked": true,
"privacy": true,
"nameservers": [
"ns1.systemdns.com",
"ns2.systemdns.com",
"ns3.systemdns.com"
],
"custom_nameservers": false,
"error": "",
"folder_id": "e9c3a7f1b5d24e8a6c0b4f2d8e6a1c3b",
"position": "a0",
"created_at": "2026-09-30T23:46:04.540Z",
"hosted": false,
"moved_at": null,
"certificate_choice": "letsencrypt",
"certificate_id": null,
"verification": null
}Tools · DNS records
Adds a record to a domain’s zone. Concurrent changes are applied in sequence, so none are lost. Records for an external domain are served once the domain uses our nameservers.
project_id string Requiredspace_id string Requiredlist_spaces.domain string Requiredexample.com.type enum RequiredA, AAAA, CNAME, MX, TXT or SRV.name string Required@ for the apex, and * for a wildcard.value string Requiredpriority integer | null weight integer | null port integer | null The domain and all its records, as returned by domain_get.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "domain_add_dns_record",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "2b7e5c1a9f3d40e8b6c2a7f1e9d3b5c8",
"domain": "example.com",
"type": "A",
"name": "app",
"value": "203.0.113.10"
}
}
}'{
"domain": "example.com",
"records": [
{
"id": "example.com/6f2a9c4e1b7d43a5e8c0f2b6d9a1e3c7",
"domain": "example.com",
"type": "A",
"name": "app",
"value": "203.0.113.10",
"priority": null,
"weight": null,
"port": null,
"managed": null
},
{
"id": "example.com/c1e7a3f9b5d248c6a0e4f8b2d6c1a9e5",
"domain": "example.com",
"type": "CNAME",
"name": "www",
"value": "7f3e9a1c5b2d48e6a0c4f8b2d6e1a3c5.tensorsites.net",
"priority": null,
"weight": null,
"port": null,
"managed": "website:7f3e9a1c5b2d48e6a0c4f8b2d6e1a3c5"
}
]
}Tools · DNS records
Replaces a record with the given values. Fails if the record changed or was removed since it was read. Updating a website’s managed record makes it an ordinary record and disconnects that address from the website. Certificate validation records can’t be updated; delete them instead.
project_id string Requiredspace_id string Requiredlist_spaces.domain string Requiredexample.com.record_id string Requireddomain_get.type enum RequiredA, AAAA, CNAME, MX, TXT or SRV.name string Required@ for the apex, and * for a wildcard.value string Requiredpriority integer | null weight integer | null port integer | null The domain and all its records.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "domain_update_dns_record",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "2b7e5c1a9f3d40e8b6c2a7f1e9d3b5c8",
"domain": "example.com",
"record_id": "example.com/6f2a9c4e1b7d43a5e8c0f2b6d9a1e3c7",
"type": "A",
"name": "app",
"value": "203.0.113.11"
}
}
}'{
"domain": "example.com",
"records": [
{
"id": "example.com/8a4c6e2f0b9d41a3c5e7f9b1d3a5c7e9",
"domain": "example.com",
"type": "A",
"name": "app",
"value": "203.0.113.11",
"priority": null,
"weight": null,
"port": null,
"managed": null
},
{
"id": "example.com/c1e7a3f9b5d248c6a0e4f8b2d6c1a9e5",
"domain": "example.com",
"type": "CNAME",
"name": "www",
"value": "7f3e9a1c5b2d48e6a0c4f8b2d6e1a3c5.tensorsites.net",
"priority": null,
"weight": null,
"port": null,
"managed": "website:7f3e9a1c5b2d48e6a0c4f8b2d6e1a3c5"
}
]
}Tools · DNS records
Deletes a record. Deleting a website’s connection record also removes that address from the website.
project_id string Requiredspace_id string Requiredlist_spaces.domain string Requiredexample.com.record_id string Requireddomain_get.The deleted record’s id, and disconnected, the address removed from its website (or null).
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "domain_delete_dns_record",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "2b7e5c1a9f3d40e8b6c2a7f1e9d3b5c8",
"domain": "example.com",
"record_id": "example.com/c1e7a3f9b5d248c6a0e4f8b2d6c1a9e5"
}
}
}'{
"deleted": "example.com/c1e7a3f9b5d248c6a0e4f8b2d6c1a9e5",
"disconnected": "www.example.com"
}Tools · DNS records
Imports records from a BIND-format zone file as a single all-or-nothing operation. Records that already exist are skipped.
project_id string Requiredspace_id string Requiredlist_spaces.domain string Requiredexample.com.zone string RequiredThe added count, and skipped records with reasons (unsupported types, names outside the domain). NS and SOA records are ignored. To change nameservers, use domain_set_nameservers.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "domain_import_zone",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "2b7e5c1a9f3d40e8b6c2a7f1e9d3b5c8",
"domain": "example.com",
"zone": "$ORIGIN example.com.\n@ 3600 IN MX 10 mail.example.net.\nblog 3600 IN CNAME blogs.example.net.\n@ 3600 IN CAA 0 issue \"letsencrypt.org\""
}
}
}'{
"added": 2,
"skipped": [
"example.com. CAA: CAA is not served here"
]
}Tools · DNS records
Replaces the domain’s MX and SPF records with a mail provider’s MX, SPF and shared DKIM records. For per-account DKIM keys (shown in the provider’s admin console), use domain_add_dns_record.
project_id string Requiredspace_id string Requiredlist_spaces.domain string Requiredexample.com.provider enum Requiredgoogle (Google Workspace), microsoft (Microsoft 365), fastmail (Fastmail), zoho (Zoho Mail), icloud (iCloud+ Custom Email Domain), proton (Proton Mail), tuta (Tuta), mailbox-org (mailbox.org), migadu (Migadu), purelymail (Purelymail), titan (Titan), rackspace (Rackspace Email), privateemail (Namecheap Private Email), ionos (IONOS Mail), yandex (Yandex 360), improvmx (ImprovMX), forwardemail (Forward Email), simplelogin (SimpleLogin), addy (addy.io).The provider’s name, the domain and all its records.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "domain_set_up_mail",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "2b7e5c1a9f3d40e8b6c2a7f1e9d3b5c8",
"domain": "example.com",
"provider": "google"
}
}
}'{
"provider": "Google Workspace",
"domain": "example.com",
"records": [
{
"id": "example.com/8a4c6e2f0b9d41a3c5e7f9b1d3a5c7e9",
"domain": "example.com",
"type": "MX",
"name": "",
"value": "smtp.google.com",
"priority": 1,
"weight": null,
"port": null,
"managed": null
},
{
"id": "example.com/6f2a9c4e1b7d43a5e8c0f2b6d9a1e3c7",
"domain": "example.com",
"type": "TXT",
"name": "",
"value": "v=spf1 include:_spf.google.com ~all",
"priority": null,
"weight": null,
"port": null,
"managed": null
},
{
"id": "example.com/c1e7a3f9b5d248c6a0e4f8b2d6c1a9e5",
"domain": "example.com",
"type": "CNAME",
"name": "www",
"value": "7f3e9a1c5b2d48e6a0c4f8b2d6e1a3c5.tensorsites.net",
"priority": null,
"weight": null,
"port": null,
"managed": "website:7f3e9a1c5b2d48e6a0c4f8b2d6e1a3c5"
}
]
}Tools · DNS records
Sets external nameservers, such as Cloudflare’s, for a domain registered here. Its records here then stop being served. Pass null to switch back to our DNS.
project_id string Requiredspace_id string Requiredlist_spaces.domain string Requiredexample.com.nameservers string[] | null RequiredThe domain and its current nameservers.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "domain_set_nameservers",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "2b7e5c1a9f3d40e8b6c2a7f1e9d3b5c8",
"domain": "example.com",
"nameservers": [
"ada.ns.cloudflare.com",
"bob.ns.cloudflare.com"
]
}
}
}'{
"domain": "example.com",
"nameservers": [
"ada.ns.cloudflare.com",
"bob.ns.cloudflare.com"
]
}Tools · DNS records
Lists DNS record changes in the resource, newest first.
project_id string Requiredspace_id string Requiredlist_spaces.domain string limit integer An array of changes, each with domain, removed and added records (an edit appears in both), by (a person, or the organization for automatic changes such as certificate validation), by_agent (the agent acting on their behalf) and created_at.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "domain_list_dns_changes",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "2b7e5c1a9f3d40e8b6c2a7f1e9d3b5c8",
"domain": "example.com",
"limit": 1
}
}
}'[
{
"id": "8a4c6e2f0b9d41a3c5e7f9b1d3a5c7e9",
"domain": "example.com",
"by": "5761e31cd8538b7da8a3ddd4157bd632",
"by_agent": "9735814189d64dd5dc193fe843b45992",
"kind": "records",
"removed": [],
"added": [
{
"type": "A",
"name": "app",
"value": "203.0.113.10",
"priority": null,
"weight": null,
"port": null,
"managed": null
}
],
"created_at": "2026-09-30T23:46:04.650Z"
}
]Tools · Domains
Lists every change made to the resource’s domains, newest first: to their DNS records, registration, WHOIS details, nameservers and certificates.
project_id string Requiredspace_id string Requiredlist_spaces.domain string kind enum records, registration, whois, nameservers or certificates.limit integer An array of changes, each with domain, kind, removed and added (records for records, as domain_list_dns_changes returns them; otherwise lines with a label and a value, a time where date is true), by (a person, or the organization for automatic changes), by_agent (the agent acting on their behalf) and created_at.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "domain_list_changes",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "2b7e5c1a9f3d40e8b6c2a7f1e9d3b5c8",
"domain": "example.com",
"kind": "nameservers",
"limit": 1
}
}
}'[
{
"id": "8a4c6e2f0b9d41a3c5e7f9b1d3a5c7e9",
"domain": "example.com",
"by": "5761e31cd8538b7da8a3ddd4157bd632",
"by_agent": null,
"kind": "nameservers",
"removed": [
{
"label": "Nameserver",
"value": "ns1.systemdns.com"
}
],
"added": [
{
"label": "Nameserver",
"value": "ada.ns.cloudflare.com"
}
],
"created_at": "2026-09-30T23:46:04.660Z"
}
]Tools · DNS records
Serves an organization website at a host on a domain held here, by adding a managed CNAME record and a verified address on the website. Fails if records already exist for the host, unless replace_records is set. Requires an owner or admin. The apex domain gets A records of the CDN’s static IPs instead (an alias where its DNS is hosted here), where the server has them. The CDN serves the host with its own certificate a few minutes later, once DNS has spread.
project_id string Requiredspace_id string Requiredlist_spaces.host string Requiredwww.example.com, or the domain itself.website_id string Requiredlist_spaces.replace_records boolean The host and cdn: null, or why the CDN could not be told just now (it is told again on its own).
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "domain_connect_website",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "2b7e5c1a9f3d40e8b6c2a7f1e9d3b5c8",
"host": "www.example.com",
"website_id": "7f3e9a1c5b2d48e6a0c4f8b2d6e1a3c5"
}
}
}'{
"host": "www.example.com",
"cdn": null
}Tools · Certificates
Orders a certificate for a domain held here, or for a host under it, with a server-generated key. The certificate is validated by a TXT record in the domain’s zone, so the domain’s DNS must be served here. Certificates are either free from Let’s Encrypt (auto-renewing) or paid for one year (charged first). Active domains already get a free certificate for the domain and its www subdomain. Poll the order with domain_check_certificate.
project_id string Requiredspace_id string Requiredlist_spaces.host string Requiredshop.example.com.authority enum letsencrypt (free, default) or opensrs (paid, one year).price_cents integer certificate_cents value from domain_list. The call fails without charging if the price has changed.use_for string The certificate, as returned by domain_get, with status pending during validation.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "domain_order_certificate",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "2b7e5c1a9f3d40e8b6c2a7f1e9d3b5c8",
"host": "shop.example.com"
}
}
}'{
"id": "4d8b2f6a0c9e47b1a3f5d7e9c2b4a6f8",
"domain": "shop.example.com",
"sans": [],
"status": "pending",
"authority": "letsencrypt",
"renewing": false,
"validation": "_acme-challenge.shop.example.com. TXT \"Hk2pW8yZr1d…\"",
"issued_at": null,
"expires_at": null,
"error": "",
"created_at": "2026-09-30T23:46:04.541Z"
}Tools · Certificates
Checks a certificate’s order or renewal with the authority immediately. Automatic checks run every minute.
project_id string Requiredspace_id string Requiredlist_spaces.certificate_id string Requireddomain_get.The certificate, with status issued, failed (with error) or pending.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "domain_check_certificate",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "2b7e5c1a9f3d40e8b6c2a7f1e9d3b5c8",
"certificate_id": "4d8b2f6a0c9e47b1a3f5d7e9c2b4a6f8"
}
}
}'{
"id": "4d8b2f6a0c9e47b1a3f5d7e9c2b4a6f8",
"domain": "example.com",
"sans": [
"www.example.com"
],
"status": "issued",
"authority": "letsencrypt",
"renewing": false,
"validation": "_acme-challenge.example.com. TXT \"Gm7xUq0iV3k…\"\n_acme-challenge.www.example.com. TXT \"pX2dR9bLw4c…\"",
"issued_at": "2026-09-30T23:46:04.545Z",
"expires_at": "2026-12-29T23:46:04.545Z",
"error": "",
"created_at": "2026-09-30T23:46:04.541Z"
}Tools · Certificates
Returns a certificate with its PEM and, optionally, its private key. The private key requires the keys permission or full access.
project_id string Requiredspace_id string Requiredlist_spaces.certificate_id string Requireddomain_get.private_key boolean The certificate, with certificate (the certificate and chain as PEM, or null until issued) and private_key if requested.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "domain_get_certificate",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "2b7e5c1a9f3d40e8b6c2a7f1e9d3b5c8",
"certificate_id": "4d8b2f6a0c9e47b1a3f5d7e9c2b4a6f8"
}
}
}'{
"id": "4d8b2f6a0c9e47b1a3f5d7e9c2b4a6f8",
"domain": "example.com",
"sans": [
"www.example.com"
],
"status": "issued",
"authority": "letsencrypt",
"renewing": false,
"validation": "_acme-challenge.example.com. TXT \"Gm7xUq0iV3k…\"\n_acme-challenge.www.example.com. TXT \"pX2dR9bLw4c…\"",
"issued_at": "2026-09-30T23:46:04.545Z",
"expires_at": "2026-12-29T23:46:04.545Z",
"error": "",
"created_at": "2026-09-30T23:46:04.541Z",
"certificate": "-----BEGIN CERTIFICATE-----\nMIIFBjCCA+6gAwIBAgISBK…\n-----END CERTIFICATE-----\n-----BEGIN CERTIFICATE-----\nMIIFFjCCAv6gAwIBAgIRAJ…\n-----END CERTIFICATE-----\n"
}Tools · Certificates
Orders a new Let’s Encrypt certificate after expiration or a failed order or renewal. Otherwise, certificates renew automatically when a third of their lifetime is left. The current certificate stays in use until the new one is issued. Paid certificates can’t be renewed. Order a new one instead.
project_id string Requiredspace_id string Requiredlist_spaces.certificate_id string Requireddomain_get.The certificate, with renewing set until it is reissued.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "domain_renew_certificate",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "2b7e5c1a9f3d40e8b6c2a7f1e9d3b5c8",
"certificate_id": "4d8b2f6a0c9e47b1a3f5d7e9c2b4a6f8"
}
}
}'{
"id": "4d8b2f6a0c9e47b1a3f5d7e9c2b4a6f8",
"domain": "example.com",
"sans": [
"www.example.com"
],
"status": "issued",
"authority": "letsencrypt",
"renewing": true,
"validation": "_acme-challenge.example.com. TXT \"Gm7xUq0iV3k…\"\n_acme-challenge.www.example.com. TXT \"pX2dR9bLw4c…\"",
"issued_at": "2026-09-30T23:46:04.545Z",
"expires_at": "2026-12-29T23:46:04.545Z",
"error": "",
"created_at": "2026-09-30T23:46:04.541Z"
}Tools · Certificates
Sets which certificate a domain uses: free Let’s Encrypt (the default), one uploaded with domain_upload_certificate, or a paid certificate ordered here. If an uploaded or paid certificate can’t be used, the domain falls back to Let’s Encrypt.
project_id string Requiredspace_id string Requiredlist_spaces.domain string Requiredexample.com.choice enum Requiredletsencrypt, existing or paid.certificate_id string The domain, as returned by domain_get.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "domain_set_certificate_choice",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "2b7e5c1a9f3d40e8b6c2a7f1e9d3b5c8",
"domain": "example.com",
"choice": "letsencrypt"
}
}
}'{
"domain": "example.com",
"status": "active",
"registered_at": "2026-09-30T23:46:04.540Z",
"expires_at": "2027-09-30T23:46:04.540Z",
"auto_renew": true,
"locked": true,
"privacy": true,
"nameservers": [
"ns1.systemdns.com",
"ns2.systemdns.com",
"ns3.systemdns.com"
],
"custom_nameservers": false,
"error": "",
"folder_id": null,
"position": "",
"created_at": "2026-09-30T23:46:04.540Z",
"hosted": false,
"moved_at": null,
"certificate_choice": "letsencrypt",
"certificate_id": null,
"verification": null,
"contacts": {
"owner": {
"own": false,
"contact": {
"first_name": "Alex",
"last_name": "Rivera",
"org_name": "Launch Co",
"address1": "1 Main St",
"address2": "",
"city": "Raleigh",
"state": "NC",
"postal_code": "27601",
"country": "US",
"phone": "+1.9195550123",
"email": "you@example.com"
}
},
"admin": {
"own": false,
"contact": {
"first_name": "Alex",
"last_name": "Rivera",
"org_name": "Launch Co",
"address1": "1 Main St",
"address2": "",
"city": "Raleigh",
"state": "NC",
"postal_code": "27601",
"country": "US",
"phone": "+1.9195550123",
"email": "you@example.com"
}
},
"tech": {
"own": false,
"contact": {
"first_name": "Alex",
"last_name": "Rivera",
"org_name": "Launch Co",
"address1": "1 Main St",
"address2": "",
"city": "Raleigh",
"state": "NC",
"postal_code": "27601",
"country": "US",
"phone": "+1.9195550123",
"email": "you@example.com"
}
},
"billing": {
"own": false,
"contact": {
"first_name": "Alex",
"last_name": "Rivera",
"org_name": "Launch Co",
"address1": "1 Main St",
"address2": "",
"city": "Raleigh",
"state": "NC",
"postal_code": "27601",
"country": "US",
"phone": "+1.9195550123",
"email": "you@example.com"
}
}
},
"records": [
{
"id": "example.com/6f2a9c4e1b7d43a5e8c0f2b6d9a1e3c7",
"domain": "example.com",
"type": "A",
"name": "app",
"value": "203.0.113.10",
"priority": null,
"weight": null,
"port": null,
"managed": null
},
{
"id": "example.com/c1e7a3f9b5d248c6a0e4f8b2d6c1a9e5",
"domain": "example.com",
"type": "CNAME",
"name": "www",
"value": "7f3e9a1c5b2d48e6a0c4f8b2d6e1a3c5.tensorsites.net",
"priority": null,
"weight": null,
"port": null,
"managed": "website:7f3e9a1c5b2d48e6a0c4f8b2d6e1a3c5"
}
],
"certificates": [
{
"id": "4d8b2f6a0c9e47b1a3f5d7e9c2b4a6f8",
"domain": "example.com",
"sans": [
"www.example.com"
],
"status": "issued",
"authority": "letsencrypt",
"renewing": false,
"validation": "_acme-challenge.example.com. TXT \"Gm7xUq0iV3k…\"\n_acme-challenge.www.example.com. TXT \"pX2dR9bLw4c…\"",
"issued_at": "2026-09-30T23:46:04.545Z",
"expires_at": "2026-12-29T23:46:04.545Z",
"error": "",
"created_at": "2026-09-30T23:46:04.541Z"
}
]
}Tools · Certificates
Uploads a certificate from another authority, with its chain (in any order) and unencrypted private key, and sets it as the domain’s certificate. Fails if the key doesn’t match the certificate or its names don’t cover the domain. Expired, self-signed and chainless certificates are stored with an error, and the domain falls back to Let’s Encrypt.
project_id string Requiredspace_id string Requiredlist_spaces.domain string Requiredexample.com.certificate string Requiredkey string RequiredThe certificate, as returned by domain_get, with authority: uploaded.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "domain_upload_certificate",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "2b7e5c1a9f3d40e8b6c2a7f1e9d3b5c8",
"domain": "example.com",
"certificate": "-----BEGIN CERTIFICATE-----\n…",
"key": "-----BEGIN PRIVATE KEY-----\n…"
}
}
}'{
"id": "8a4c6e2f0b9d41a3c5e7f9b1d3a5c7e9",
"domain": "example.com",
"sans": [
"www.example.com"
],
"status": "issued",
"authority": "uploaded",
"renewing": false,
"validation": "",
"issued_at": "2026-09-30T23:46:04.000Z",
"expires_at": "2027-09-30T00:00:00.000Z",
"error": "",
"created_at": "2026-09-30T23:46:04.710Z"
}Tools · Certificates
Removes a certificate. Fails while the certificate is being validated.
project_id string Requiredspace_id string Requiredlist_spaces.certificate_id string Requireddomain_get.The removed certificate’s id.
curl https://tensorworks.net/mcp \
-H "Authorization: Bearer $TENSORWORKS_TOKEN" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "domain_remove_certificate",
"arguments": {
"project_id": "b6909c9cf00c1d482686b5f52eadd58e",
"space_id": "2b7e5c1a9f3d40e8b6c2a7f1e9d3b5c8",
"certificate_id": "4d8b2f6a0c9e47b1a3f5d7e9c2b4a6f8"
}
}
}'{
"deleted": "4d8b2f6a0c9e47b1a3f5d7e9c2b4a6f8"
}Questions or something missing? Contact us.