Tailscale MCP by usefulapi
by usefulapi.io · remote · no sign-in to list tools · v1.16.3 · published by io.usefulapi
Read devices, users, keys, ACLs and DNS for a tailnet; manage devices, routes and auth keys.
22 tools: 8 can delete or cancel things and 14 only read.
Scanned Oct 21, 2026
- Deletes or cancels8Claude Code: deny: see these tools
- Can't be undone0Claude Code: ask
- Changes things0Claude Code: ask
- Only reads14Claude Code: allow: see these tools
No check matched anything in the tool definitions. No finding is not a safety guarantee. How the checks work.
claude mcp add --transport http tailscale https://tailscale.usefulapi.io/mcpTools
Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.
22 tools
Deletes or cancels 8Claude Code: deny
tailscale_authorize_deviceAuthorize or de-authorize a device (only relevant when device approval is enabled for the tailnet).No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it Authorize or de-authorize a device (only relevant when device approval is enabled for the tailnet). Tailscale REST: POST /device/{deviceId}/authorized.
Annotations the server declares
- title: Authorize device
- destructiveHint: true
tailscale_create_auth_keyCreate a new auth key for the tailnet (used to register new devices).No findings
Why it is in this group
- The name "tailscale_create_auth_key" says "create": a word for a change.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it Create a new auth key for the tailnet (used to register new devices). Tailscale REST: POST /tailnet/{tailnet}/keys.
Annotations the server declares
- title: Create auth key
- destructiveHint: true
tailscale_delete_deviceDelete a device, removing it from the tailnet.No findings
Why it is in this group
- The name "tailscale_delete_device" says "delete": a word for removing or ending something.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it Delete a device, removing it from the tailnet. Tailscale REST: DELETE /device/{deviceId}.
Annotations the server declares
- title: Delete device
- destructiveHint: true
tailscale_delete_keyDelete (revoke) an auth key or API access token by id — a security response.No findings
Why it is in this group
- The name "tailscale_delete_key" says "delete": a word for removing or ending something.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it Delete (revoke) an auth key or API access token by id — a security response. Tailscale REST: DELETE /tailnet/{tailnet}/keys/{keyId}.
Annotations the server declares
- title: Delete key
- destructiveHint: true
tailscale_expire_device_keyExpire a device's node key, forcing it to re-authenticate — a security response to a compromised or lost device.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it Expire a device's node key, forcing it to re-authenticate — a security response to a compromised or lost device. Tailscale REST: POST /device/{deviceId}/expire.
Annotations the server declares
- title: Expire device key
- destructiveHint: true
tailscale_set_device_nameSet (rename) a device's name.No findings
Why it is in this group
- The name "tailscale_set_device_name" says "set": a word for a change.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it Set (rename) a device's name. Tailscale REST: POST /device/{deviceId}/name.
Annotations the server declares
- title: Set device name
- destructiveHint: true
tailscale_set_device_routesSet the subnet routes ENABLED for a device (from the routes it advertises).No findings
Why it is in this group
- The name "tailscale_set_device_routes" says "set": a word for a change.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it Set the subnet routes ENABLED for a device (from the routes it advertises). REPLACES the enabled set. Tailscale REST: POST /device/{deviceId}/routes.
Annotations the server declares
- title: Set device routes
- destructiveHint: true
tailscale_set_device_tagsSet a device's ACL tags.No findings
Why it is in this group
- The name "tailscale_set_device_tags" says "set": a word for a change.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it Set a device's ACL tags. REPLACES the device's existing tags. Tailscale REST: POST /device/{deviceId}/tags.
Annotations the server declares
- title: Set device tags
- destructiveHint: true
Only reads 14Claude Code: allow
tailscale_get_deviceGet a single device by id.No findings
Why it is in this group
- The name "tailscale_get_device" says "get": a word for reading.
Description, as the server wrote it Get a single device by id. Tailscale REST: GET /device/{deviceId}.
Annotations the server declares
- title: Get device
- readOnlyHint: true
tailscale_get_dns_preferencesGet the tailnet's DNS preferences (e.g.No findings
Why it is in this group
- The name "tailscale_get_dns_preferences" says "get": a word for reading.
Description, as the server wrote it Get the tailnet's DNS preferences (e.g. whether MagicDNS is enabled). Tailscale REST: GET /tailnet/{tailnet}/dns/preferences.
Annotations the server declares
- title: Get DNS preferences
- readOnlyHint: true
tailscale_get_keyGet details of a single auth key / API access token by id (capabilities, expiry, usage).No findings
Why it is in this group
- The name "tailscale_get_key" says "get": a word for reading.
Description, as the server wrote it Get details of a single auth key / API access token by id (capabilities, expiry, usage). Tailscale REST: GET /tailnet/{tailnet}/keys/{keyId}.
Annotations the server declares
- title: Get key
- readOnlyHint: true
tailscale_get_policy_fileGet the tailnet's ACL / policy file (returned as JSON via the Accept header, not HuJSON).No findings
Why it is in this group
- The name "tailscale_get_policy_file" says "get": a word for reading.
Description, as the server wrote it Get the tailnet's ACL / policy file (returned as JSON via the Accept header, not HuJSON). Tailscale REST: GET /tailnet/{tailnet}/acl.
Annotations the server declares
- title: Get policy file
- readOnlyHint: true
tailscale_get_split_dnsGet the tailnet's split-DNS configuration — a map of domain → nameservers.No findings
Why it is in this group
- The name "tailscale_get_split_dns" says "get": a word for reading.
Description, as the server wrote it Get the tailnet's split-DNS configuration — a map of domain → nameservers. Tailscale REST: GET /tailnet/{tailnet}/dns/split-dns.
Annotations the server declares
- title: Get split DNS
- readOnlyHint: true
tailscale_get_tailnet_settingsGet the tailnet's settings (device approval, key expiry, posture, etc.).No findings
Why it is in this group
- The name "tailscale_get_tailnet_settings" says "get": a word for reading.
Description, as the server wrote it Get the tailnet's settings (device approval, key expiry, posture, etc.). Tailscale REST: GET /tailnet/{tailnet}/settings.
Annotations the server declares
- title: Get tailnet settings
- readOnlyHint: true
tailscale_get_userGet a single user by id.No findings
Why it is in this group
- The name "tailscale_get_user" says "get": a word for reading.
Description, as the server wrote it Get a single user by id. Tailscale REST: GET /users/{userId}.
Annotations the server declares
- title: Get user
- readOnlyHint: true
tailscale_list_device_routesList the subnet routes a device advertises and which are enabled.No findings
Why it is in this group
- The name "tailscale_list_device_routes" says "list": a word for reading.
Description, as the server wrote it List the subnet routes a device advertises and which are enabled. Tailscale REST: GET /device/{deviceId}/routes.
Annotations the server declares
- title: List device routes
- readOnlyHint: true
tailscale_list_devicesList all devices in the tailnet (name, addresses, OS, last seen, tags, etc.).No findings
Why it is in this group
- The name "tailscale_list_devices" says "list": a word for reading.
Description, as the server wrote it List all devices in the tailnet (name, addresses, OS, last seen, tags, etc.). Tailscale REST: GET /tailnet/{tailnet}/devices.
Annotations the server declares
- title: List devices
- readOnlyHint: true
tailscale_list_dns_nameserversList the global DNS nameservers configured for the tailnet.No findings
Why it is in this group
- The name "tailscale_list_dns_nameservers" says "list": a word for reading.
Description, as the server wrote it List the global DNS nameservers configured for the tailnet. Tailscale REST: GET /tailnet/{tailnet}/dns/nameservers.
Annotations the server declares
- title: List DNS nameservers
- readOnlyHint: true
tailscale_list_dns_searchpathsList the DNS search paths (search domains) configured for the tailnet.No findings
Why it is in this group
- The name "tailscale_list_dns_searchpaths" says "list": a word for reading.
Description, as the server wrote it List the DNS search paths (search domains) configured for the tailnet. Tailscale REST: GET /tailnet/{tailnet}/dns/searchpaths.
Annotations the server declares
- title: List DNS search paths
- readOnlyHint: true
tailscale_list_keysList auth keys and API access tokens for the tailnet.No findings
Why it is in this group
- The name "tailscale_list_keys" says "list": a word for reading.
Description, as the server wrote it List auth keys and API access tokens for the tailnet. Tailscale REST: GET /tailnet/{tailnet}/keys.
Annotations the server declares
- title: List keys
- readOnlyHint: true
tailscale_list_usersList users of the tailnet, optionally filtered by type, role or status.No findings
Why it is in this group
- The name "tailscale_list_users" says "list": a word for reading.
Description, as the server wrote it List users of the tailnet, optionally filtered by type, role or status. Tailscale REST: GET /tailnet/{tailnet}/users.
Annotations the server declares
- title: List users
- readOnlyHint: true
tailscale_list_webhooksList the webhook endpoints configured for the tailnet.No findings
Why it is in this group
- The name "tailscale_list_webhooks" says "list": a word for reading.
Description, as the server wrote it List the webhook endpoints configured for the tailnet. Tailscale REST: GET /tailnet/{tailnet}/webhooks.
Annotations the server declares
- title: List webhooks
- readOnlyHint: true
This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.
Install
Pinned to version 1.16.3. Values in angle brackets are yours to fill in.
claude mcp add --transport http tailscale https://tailscale.usefulapi.io/mcpRun in a terminal.
Claude Code permissions
Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.
{
"permissions": {
"allow": [
"mcp__tailscale__tailscale_list_devices",
"mcp__tailscale__tailscale_get_device",
"mcp__tailscale__tailscale_list_device_routes",
"mcp__tailscale__tailscale_list_keys",
"mcp__tailscale__tailscale_get_key",
"mcp__tailscale__tailscale_get_policy_file",
"mcp__tailscale__tailscale_list_dns_nameservers",
"mcp__tailscale__tailscale_get_dns_preferences",
"mcp__tailscale__tailscale_list_dns_searchpaths",
"mcp__tailscale__tailscale_get_split_dns",
"mcp__tailscale__tailscale_list_users",
"mcp__tailscale__tailscale_get_user",
"mcp__tailscale__tailscale_list_webhooks",
"mcp__tailscale__tailscale_get_tailnet_settings"
],
"ask": [],
"deny": [
"mcp__tailscale__tailscale_authorize_device",
"mcp__tailscale__tailscale_set_device_name",
"mcp__tailscale__tailscale_set_device_tags",
"mcp__tailscale__tailscale_expire_device_key",
"mcp__tailscale__tailscale_set_device_routes",
"mcp__tailscale__tailscale_create_auth_key",
"mcp__tailscale__tailscale_delete_key",
"mcp__tailscale__tailscale_delete_device"
]
}
}Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as tailscale. Review it before you use it.