Skip to content
MCP server

Tailscale MCP by usefulapi

Read devices, users, keys, ACLs and DNS for a tailnet; manage devices, routes and auth…

Install
Runs
Remotely
Version
1.40.0
Listing updated
4 days ago

About Tailscale MCP by usefulapi

Tailscale MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

Read devices, users, keys, ACLs and DNS for a tailnet; manage devices, routes and auth keys.

Install

Run in a terminal

claude mcp add --transport http tailscale https://tailscale.usefulapi.io/mcp

Add to Settings → Connectors → Add custom connector

https://tailscale.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "tailscale": {
      "url": "https://tailscale.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "tailscale": {
      "type": "http",
      "url": "https://tailscale.usefulapi.io/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "tailscale": {
      "serverUrl": "https://tailscale.usefulapi.io/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "tailscale": {
      "type": "http",
      "url": "https://tailscale.usefulapi.io/mcp"
    }
  }
}

Tools this server provides (22)

Read directly from the server.

tailscale_list_devices
List all devices in the tailnet (name, addresses, OS, last seen, tags, etc.). Tailscale REST: GET /tailnet/{tailnet}/devices.
tailscale_get_device
Get a single device by id. Tailscale REST: GET /device/{deviceId}.
tailscale_list_device_routes
List the subnet routes a device advertises and which are enabled. Tailscale REST: GET /device/{deviceId}/routes.
tailscale_list_keys
List auth keys and API access tokens for the tailnet. Tailscale REST: GET /tailnet/{tailnet}/keys.
tailscale_get_key
Get details of a single auth key / API access token by id (capabilities, expiry, usage). Tailscale REST: GET /tailnet/{tailnet}/keys/{keyId}.
tailscale_get_policy_file
Get the tailnet's ACL / policy file (returned as JSON via the Accept header, not HuJSON). Tailscale REST: GET /tailnet/{tailnet}/acl.
tailscale_list_dns_nameservers
List the global DNS nameservers configured for the tailnet. Tailscale REST: GET /tailnet/{tailnet}/dns/nameservers.
tailscale_get_dns_preferences
Get the tailnet's DNS preferences (e.g. whether MagicDNS is enabled). Tailscale REST: GET /tailnet/{tailnet}/dns/preferences.
tailscale_list_dns_searchpaths
List the DNS search paths (search domains) configured for the tailnet. Tailscale REST: GET /tailnet/{tailnet}/dns/searchpaths.
tailscale_get_split_dns
Get the tailnet's split-DNS configuration — a map of domain → nameservers. Tailscale REST: GET /tailnet/{tailnet}/dns/split-dns.
tailscale_list_users
List users of the tailnet, optionally filtered by type, role or status. Tailscale REST: GET /tailnet/{tailnet}/users.
tailscale_get_user
Get a single user by id. Tailscale REST: GET /users/{userId}.
tailscale_list_webhooks
List the webhook endpoints configured for the tailnet. Tailscale REST: GET /tailnet/{tailnet}/webhooks.
tailscale_get_tailnet_settings
Get the tailnet's settings (device approval, key expiry, posture, etc.). Tailscale REST: GET /tailnet/{tailnet}/settings.
tailscale_authorize_device
Authorize or de-authorize a device (only relevant when device approval is enabled for the tailnet). Tailscale REST: POST /device/{deviceId}/authorized.
tailscale_set_device_name
Set (rename) a device's name. Tailscale REST: POST /device/{deviceId}/name.
tailscale_set_device_tags
Set a device's ACL tags. REPLACES the device's existing tags. Tailscale REST: POST /device/{deviceId}/tags.
tailscale_expire_device_key
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.
tailscale_set_device_routes
Set the subnet routes ENABLED for a device (from the routes it advertises). REPLACES the enabled set. Tailscale REST: POST /device/{deviceId}/routes.
tailscale_create_auth_key
Create a new auth key for the tailnet (used to register new devices). Tailscale REST: POST /tailnet/{tailnet}/keys.
tailscale_delete_key
Delete (revoke) an auth key or API access token by id — a security response. Tailscale REST: DELETE /tailnet/{tailnet}/keys/{keyId}.
tailscale_delete_device
Delete a device, removing it from the tailnet. Tailscale REST: DELETE /device/{deviceId}.

Tailscale MCP by usefulapi FAQ

How do I add Tailscale MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http tailscale https://tailscale.usefulapi.io/mcp