Skip to content

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.

Deletes · 8

22 tools: 8 can delete or cancel things and 14 only read.

Scanned Oct 21, 2026

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/mcp

Tools

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/mcp

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.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.