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
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)
How do you configure the Tailscale DADL?
- Log in to the Tailscale admin console at https://login.tailscale.com/admin
- Navigate to Settings -> Keys
- Click 'Generate API key'
- Set expiry (1-90 days) and copy the key immediately -- it is shown only once
- Key prefix is tskey-api-. Requires Owner, Admin, IT admin, or Network admin role.
- Alternative: create an OAuth client under Settings -> OAuth for long-lived automated access
Environment variable: CREDENTIAL_TAILSCALE_API_TOKEN
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-hereWhat 60 tools does the Tailscale DADL expose?
GETlist_devicesList all devices in the tailnetGETget_deviceGet details of a specific deviceDELETEdelete_deviceRemove a device from the tailnetPOSTauthorize_deviceAuthorize or deauthorize a devicePOSTexpire_device_keyExpire a device's node key, forcing it to re-authenticatePOSTset_device_keySet device key properties (e.g. disable key expiry)POSTset_device_nameSet custom display name for a devicePOSTset_device_tagsSet ACL tags on a device (replaces existing tags)POSTset_device_ipSet the Tailscale IPv4 address of a deviceGETget_device_routesGet advertised and enabled subnet routes for a devicePOSTset_device_routesSet which subnet routes are enabled for a deviceGETget_device_posture_attributesGet custom posture attributes for a devicePOSTset_device_posture_attributeSet a custom posture attribute on a deviceDELETEdelete_device_posture_attributeDelete a custom posture attribute from a deviceGETlist_usersList users in the tailnetGETget_userGet details of a specific userPOSTapprove_userApprove a pending userPOSTsuspend_userSuspend a user (disables their access to the tailnet)POSTrestore_userRestore a previously suspended userPOSTdelete_userDelete a user from the tailnetPOSTset_user_roleUpdate a user's role in the tailnetGETlist_keysList all auth keys and API access tokens in the tailnetGETget_keyGet details of a specific keyPOSTcreate_auth_keyCreate a new auth key for device registrationDELETEdelete_keyRevoke and delete a keyGETget_dns_nameserversGet the global DNS nameservers for the tailnetPOSTset_dns_nameserversSet the global DNS nameservers (replaces existing list)GETget_dns_searchpathsGet DNS search paths for the tailnetPOSTset_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 configurationPUTset_dns_splitReplace the entire split DNS configurationPATCHpatch_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:portPOSTvalidate_aclValidate an ACL policy without applying itPOSTtest_aclRun the test cases defined in the ACL policyGETlist_webhooksList all webhook endpoints in the tailnetPOSTcreate_webhookCreate a new webhook endpointGETget_webhookGet details of a webhook endpointPATCHupdate_webhookUpdate a webhook endpoint's subscriptionsDELETEdelete_webhookDelete a webhook endpointPOSTtest_webhookSend a test event to a webhook endpointPOSTrotate_webhook_secretRotate the signing secret for a webhook endpointGETget_contactsGet tailnet contact emails (account, support, security)PATCHupdate_contactUpdate a contact email addressPOSTresend_contact_verificationResend verification email for a contactGETget_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 integrationGETget_posture_integrationGet details of a posture integrationPATCHupdate_posture_integrationUpdate a posture integrationDELETEdelete_posture_integrationDelete a posture integrationGETget_log_stream_configGet log stream configuration for a log typePUTset_log_stream_configSet log stream destination (Splunk, Elastic, Datadog, S3, etc.)DELETEdelete_log_stream_configDelete log stream configurationGETget_log_stream_statusGet current status of log streaming