Skip to content

Tailscale MCP Server — 60 tools

The Tailscale DADL turns Tailscale's API into an MCP server that Claude, GPT or any MCP-compatible agent can consume directly. One YAML file declares all 60 tools — device, user, webhook, acl, posture, log, and more — and ToolMesh serves them at runtime. No Python boilerplate, no per-endpoint code, no separate MCP server process.

Below: the endpoint coverage matrix, a two-block ToolMesh setup, the full tool reference grouped by Tailscale feature area, required credential scopes.

Source: Tailscale REST API

Credits: Dunkel Cloud GmbH -- maintainerUpdated: 2026-04-06

Which Tailscale endpoints are covered?

83% (58 of ~70 endpoints)

Focus: devices, device routes, device posture, users, auth keys, DNS (nameservers, search paths, preferences, split DNS), ACL/policy, webhooks, contacts, tailnet settings, posture integrations, log streaming

Missing: OAuth token endpoint, device invites, user invites, services (beta)

Last reviewed: 2026-04-06

How do you configure the Tailscale DADL?

  1. Log in to the Tailscale admin console at https://login.tailscale.com/admin
  2. Navigate to Settings -> Keys
  3. Click 'Generate API key'
  4. Set expiry (1-90 days) and copy the key immediately -- it is shown only once
  5. Key prefix is tskey-api-. Requires Owner, Admin, IT admin, or Network admin role.
  6. Alternative: create an OAuth client under Settings -> OAuth for long-lived automated access

Environment variable: CREDENTIAL_TAILSCALE_API_TOKEN

Authentication docs ↗

API keys expire after 1-90 days and cannot be renewed -- create a new one before expiry. For automation, prefer OAuth clients which support token refresh. Use '-' as the tailnet parameter to target your own tailnet.

How do you install the Tailscale MCP server with ToolMesh?

Add to your backends.yaml:

- name: tailscale
  transport: rest
  dadl: tailscale.dadl

Set the credential:

CREDENTIAL_TAILSCALE_API_TOKEN=your-token-here

What 60 tools does the Tailscale DADL expose?

GETlist_devicesList all devices in the tailnet
GETget_deviceGet details of a specific device
DELETEdelete_deviceRemove a device from the tailnet
POSTauthorize_deviceAuthorize or deauthorize a device
POSTexpire_device_keyExpire a device's node key, forcing it to re-authenticate
POSTset_device_keySet device key properties (e.g. disable key expiry)
POSTset_device_nameSet custom display name for a device
POSTset_device_tagsSet ACL tags on a device (replaces existing tags)
POSTset_device_ipSet the Tailscale IPv4 address of a device
GETget_device_routesGet advertised and enabled subnet routes for a device
POSTset_device_routesSet which subnet routes are enabled for a device
GETget_device_posture_attributesGet custom posture attributes for a device
POSTset_device_posture_attributeSet a custom posture attribute on a device
DELETEdelete_device_posture_attributeDelete a custom posture attribute from a device
GETlist_usersList users in the tailnet
GETget_userGet details of a specific user
POSTapprove_userApprove a pending user
POSTsuspend_userSuspend a user (disables their access to the tailnet)
POSTrestore_userRestore a previously suspended user
POSTdelete_userDelete a user from the tailnet
POSTset_user_roleUpdate a user's role in the tailnet
GETlist_keysList all auth keys and API access tokens in the tailnet
GETget_keyGet details of a specific key
POSTcreate_auth_keyCreate a new auth key for device registration
DELETEdelete_keyRevoke and delete a key
GETget_dns_nameserversGet the global DNS nameservers for the tailnet
POSTset_dns_nameserversSet the global DNS nameservers (replaces existing list)
GETget_dns_searchpathsGet DNS search paths for the tailnet
POSTset_dns_searchpathsSet DNS search paths (replaces existing list)
GETget_dns_preferencesGet DNS preferences (MagicDNS status)
POSTset_dns_preferencesSet DNS preferences (enable/disable MagicDNS)
GETget_dns_splitGet split DNS configuration
PUTset_dns_splitReplace the entire split DNS configuration
PATCHpatch_dns_splitMerge updates into the split DNS configuration (existing entries preserved)
GETget_aclGet the current ACL/policy file. Returns ETag header for concurrency control.
POSTset_aclReplace the ACL/policy file. Use If-Match header with ETag for optimistic concurrency.
POSTpreview_aclPreview how ACL rules apply to a specific user or IP:port
POSTvalidate_aclValidate an ACL policy without applying it
POSTtest_aclRun the test cases defined in the ACL policy
GETlist_webhooksList all webhook endpoints in the tailnet
POSTcreate_webhookCreate a new webhook endpoint
GETget_webhookGet details of a webhook endpoint
PATCHupdate_webhookUpdate a webhook endpoint's subscriptions
DELETEdelete_webhookDelete a webhook endpoint
POSTtest_webhookSend a test event to a webhook endpoint
POSTrotate_webhook_secretRotate the signing secret for a webhook endpoint
GETget_contactsGet tailnet contact emails (account, support, security)
PATCHupdate_contactUpdate a contact email address
POSTresend_contact_verificationResend verification email for a contact
GETget_tailnet_settingsGet tailnet-wide settings (auto-updates, approval, key duration, etc.)
PATCHupdate_tailnet_settingsUpdate tailnet settings (partial update)
GETlist_posture_integrationsList device posture integrations (CrowdStrike, Intune, Jamf, etc.)
POSTcreate_posture_integrationCreate a new posture integration
GETget_posture_integrationGet details of a posture integration
PATCHupdate_posture_integrationUpdate a posture integration
DELETEdelete_posture_integrationDelete a posture integration
GETget_log_stream_configGet log stream configuration for a log type
PUTset_log_stream_configSet log stream destination (Splunk, Elastic, Datadog, S3, etc.)
DELETEdelete_log_stream_configDelete log stream configuration
GETget_log_stream_statusGet current status of log streaming