Tailscale

Instrucciones de uso

Interact with the Tailscale API to manage devices, DNS, ACLs, auth keys, users, and routes across your tailnet.

Herramientas

`tailscale_list_devices`

List all devices in the tailnet

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`apiKey`	string	Sí	Tailscale API key
`tailnet`	string	Sí	Tailnet name (e.g., example.com) or "-" for default

Salida

Parámetro	Tipo	Descripción
`devices`	array	List of devices in the tailnet
↳ `id`	string	Device ID
↳ `name`	string	Device name
↳ `hostname`	string	Device hostname
↳ `user`	string	Associated user
↳ `os`	string	Operating system
↳ `clientVersion`	string	Tailscale client version
↳ `addresses`	array	Tailscale IP addresses
↳ `tags`	array	Device tags
↳ `authorized`	boolean	Whether the device is authorized
↳ `blocksIncomingConnections`	boolean	Whether the device blocks incoming connections
↳ `lastSeen`	string	Last seen timestamp
↳ `created`	string	Creation timestamp
`count`	number	Total number of devices

`tailscale_get_device`

Get details of a specific device by ID

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`apiKey`	string	Sí	Tailscale API key
`tailnet`	string	Sí	Tailnet name (e.g., example.com) or "-" for default
`deviceId`	string	Sí	Device ID

Salida

Parámetro	Tipo	Descripción
`id`	string	Device ID
`name`	string	Device name
`hostname`	string	Device hostname
`user`	string	Associated user
`os`	string	Operating system
`clientVersion`	string	Tailscale client version
`addresses`	array	Tailscale IP addresses
`tags`	array	Device tags
`authorized`	boolean	Whether the device is authorized
`blocksIncomingConnections`	boolean	Whether the device blocks incoming connections
`lastSeen`	string	Last seen timestamp
`created`	string	Creation timestamp
`isExternal`	boolean	Whether the device is external
`updateAvailable`	boolean	Whether an update is available
`machineKey`	string	Machine key
`nodeKey`	string	Node key

`tailscale_delete_device`

Remove a device from the tailnet

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`apiKey`	string	Sí	Tailscale API key
`tailnet`	string	Sí	Tailnet name (e.g., example.com) or "-" for default
`deviceId`	string	Sí	Device ID to delete

Salida

Parámetro	Tipo	Descripción
`success`	boolean	Whether the device was successfully deleted
`deviceId`	string	ID of the deleted device

`tailscale_authorize_device`

Authorize or deauthorize a device on the tailnet

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`apiKey`	string	Sí	Tailscale API key
`tailnet`	string	Sí	Tailnet name (e.g., example.com) or "-" for default
`deviceId`	string	Sí	Device ID to authorize
`authorized`	boolean	Sí	Whether to authorize (true) or deauthorize (false) the device

Salida

Parámetro	Tipo	Descripción
`success`	boolean	Whether the operation succeeded
`deviceId`	string	Device ID
`authorized`	boolean	Authorization status after the operation

`tailscale_set_device_tags`

Set tags on a device in the tailnet

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`apiKey`	string	Sí	Tailscale API key
`tailnet`	string	Sí	Tailnet name (e.g., example.com) or "-" for default
`deviceId`	string	Sí	Device ID
`tags`	string	Sí	Comma-separated list of tags (e.g., "tag:server,tag:production")

Salida

Parámetro	Tipo	Descripción
`success`	boolean	Whether the tags were successfully set
`deviceId`	string	Device ID
`tags`	array	Tags set on the device

`tailscale_get_device_routes`

Get the subnet routes for a device

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`apiKey`	string	Sí	Tailscale API key
`tailnet`	string	Sí	Tailnet name (e.g., example.com) or "-" for default
`deviceId`	string	Sí	Device ID

Salida

Parámetro	Tipo	Descripción
`advertisedRoutes`	array	Subnet routes the device is advertising
`enabledRoutes`	array	Subnet routes that are approved/enabled

`tailscale_set_device_routes`

Set the enabled subnet routes for a device

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`apiKey`	string	Sí	Tailscale API key
`tailnet`	string	Sí	Tailnet name (e.g., example.com) or "-" for default
`deviceId`	string	Sí	Device ID
`routes`	string	Sí	Comma-separated list of subnet routes to enable (e.g., "10.0.0.0/24,192.168.1.0/24")

Salida

Parámetro	Tipo	Descripción
`advertisedRoutes`	array	Subnet routes the device is advertising
`enabledRoutes`	array	Subnet routes that are now enabled

`tailscale_update_device_key`

Enable or disable key expiry on a device

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`apiKey`	string	Sí	Tailscale API key
`tailnet`	string	Sí	Tailnet name (e.g., example.com) or "-" for default
`deviceId`	string	Sí	Device ID
`keyExpiryDisabled`	boolean	Sí	Whether to disable key expiry (true) or enable it (false)

Salida

Parámetro	Tipo	Descripción
`success`	boolean	Whether the operation succeeded
`deviceId`	string	Device ID
`keyExpiryDisabled`	boolean	Whether key expiry is now disabled

`tailscale_list_dns_nameservers`

Get the DNS nameservers configured for the tailnet

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`apiKey`	string	Sí	Tailscale API key
`tailnet`	string	Sí	Tailnet name (e.g., example.com) or "-" for default

Salida

Parámetro	Tipo	Descripción
`dns`	array	List of DNS nameserver addresses
`magicDNS`	boolean	Whether MagicDNS is enabled

`tailscale_set_dns_nameservers`

Set the DNS nameservers for the tailnet

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`apiKey`	string	Sí	Tailscale API key
`tailnet`	string	Sí	Tailnet name (e.g., example.com) or "-" for default
`dns`	string	Sí	Comma-separated list of DNS nameserver IP addresses (e.g., "8.8.8.8,8.8.4.4")

Salida

Parámetro	Tipo	Descripción
`dns`	array	Updated list of DNS nameserver addresses
`magicDNS`	boolean	Whether MagicDNS is enabled

`tailscale_get_dns_preferences`

Get the DNS preferences for the tailnet including MagicDNS status

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`apiKey`	string	Sí	Tailscale API key
`tailnet`	string	Sí	Tailnet name (e.g., example.com) or "-" for default

Salida

Parámetro	Tipo	Descripción
`magicDNS`	boolean	Whether MagicDNS is enabled

`tailscale_set_dns_preferences`

Set DNS preferences for the tailnet (enable/disable MagicDNS)

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`apiKey`	string	Sí	Tailscale API key
`tailnet`	string	Sí	Tailnet name (e.g., example.com) or "-" for default
`magicDNS`	boolean	Sí	Whether to enable (true) or disable (false) MagicDNS

Salida

Parámetro	Tipo	Descripción
`magicDNS`	boolean	Updated MagicDNS status

`tailscale_get_dns_searchpaths`

Get the DNS search paths configured for the tailnet

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`apiKey`	string	Sí	Tailscale API key
`tailnet`	string	Sí	Tailnet name (e.g., example.com) or "-" for default

Salida

Parámetro	Tipo	Descripción
`searchPaths`	array	List of DNS search path domains

`tailscale_set_dns_searchpaths`

Set the DNS search paths for the tailnet

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`apiKey`	string	Sí	Tailscale API key
`tailnet`	string	Sí	Tailnet name (e.g., example.com) or "-" for default
`searchPaths`	string	Sí	Comma-separated list of DNS search path domains (e.g., "corp.example.com,internal.example.com")

Salida

Parámetro	Tipo	Descripción
`searchPaths`	array	Updated list of DNS search path domains

`tailscale_list_users`

List all users in the tailnet

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`apiKey`	string	Sí	Tailscale API key
`tailnet`	string	Sí	Tailnet name (e.g., example.com) or "-" for default

Salida

Parámetro	Tipo	Descripción
`users`	array	List of users in the tailnet
↳ `id`	string	User ID
↳ `displayName`	string	Display name
↳ `loginName`	string	Login name / email
↳ `profilePicURL`	string	Profile picture URL
↳ `role`	string	User role (owner, admin, member, etc.)
↳ `status`	string	User status (active, suspended, etc.)
↳ `type`	string	User type (member, shared, tagged)
↳ `created`	string	Creation timestamp
↳ `lastSeen`	string	Last seen timestamp
↳ `deviceCount`	number	Number of devices owned by user
`count`	number	Total number of users

`tailscale_create_auth_key`

Create a new auth key for the tailnet to pre-authorize devices

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`apiKey`	string	Sí	Tailscale API key
`tailnet`	string	Sí	Tailnet name (e.g., example.com) or "-" for default
`reusable`	boolean	No	Whether the key can be used more than once
`ephemeral`	boolean	No	Whether devices authenticated with this key are ephemeral
`preauthorized`	boolean	No	Whether devices are pre-authorized (skip manual approval)
`tags`	string	No	Comma-separated list of tags for devices using this key (e.g., "tag:server,tag:prod")
`description`	string	No	Description for the auth key
`expirySeconds`	number	No	Key expiry time in seconds (default: 90 days)

Salida

Parámetro	Tipo	Descripción
`id`	string	Auth key ID
`key`	string	The auth key value (only shown once at creation)
`description`	string	Key description
`created`	string	Creation timestamp
`expires`	string	Expiration timestamp
`revoked`	string	Revocation timestamp (empty if not revoked)
`capabilities`	object	Key capabilities
↳ `reusable`	boolean	Whether the key is reusable
↳ `ephemeral`	boolean	Whether devices are ephemeral
↳ `preauthorized`	boolean	Whether devices are pre-authorized
↳ `tags`	array	Tags applied to devices using this key

`tailscale_list_auth_keys`

List all auth keys in the tailnet

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`apiKey`	string	Sí	Tailscale API key
`tailnet`	string	Sí	Tailnet name (e.g., example.com) or "-" for default

Salida

Parámetro	Tipo	Descripción
`keys`	array	List of auth keys
↳ `id`	string	Auth key ID
↳ `description`	string	Key description
↳ `created`	string	Creation timestamp
↳ `expires`	string	Expiration timestamp
↳ `revoked`	string	Revocation timestamp
↳ `capabilities`	object	Key capabilities
↳ `reusable`	boolean	Whether the key is reusable
↳ `ephemeral`	boolean	Whether devices are ephemeral
↳ `preauthorized`	boolean	Whether devices are pre-authorized
↳ `tags`	array	Tags applied to devices
`count`	number	Total number of auth keys

`tailscale_get_auth_key`

Get details of a specific auth key

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`apiKey`	string	Sí	Tailscale API key
`tailnet`	string	Sí	Tailnet name (e.g., example.com) or "-" for default
`keyId`	string	Sí	Auth key ID

Salida

Parámetro	Tipo	Descripción
`id`	string	Auth key ID
`description`	string	Key description
`created`	string	Creation timestamp
`expires`	string	Expiration timestamp
`revoked`	string	Revocation timestamp
`capabilities`	object	Key capabilities
↳ `reusable`	boolean	Whether the key is reusable
↳ `ephemeral`	boolean	Whether devices are ephemeral
↳ `preauthorized`	boolean	Whether devices are pre-authorized
↳ `tags`	array	Tags applied to devices using this key

`tailscale_delete_auth_key`

Revoke and delete an auth key

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`apiKey`	string	Sí	Tailscale API key
`tailnet`	string	Sí	Tailnet name (e.g., example.com) or "-" for default
`keyId`	string	Sí	Auth key ID to delete

Salida

Parámetro	Tipo	Descripción
`success`	boolean	Whether the auth key was successfully deleted
`keyId`	string	ID of the deleted auth key

`tailscale_get_acl`

Get the current ACL policy for the tailnet

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`apiKey`	string	Sí	Tailscale API key
`tailnet`	string	Sí	Tailnet name (e.g., example.com) or "-" for default

Salida

Parámetro	Tipo	Descripción
`acl`	string	ACL policy as JSON string
`etag`	string	ETag for the current ACL version (use with If-Match header for updates)

Tailscale

On this page